LightStep Documentation

Welcome to the LightStep developer hub. You'll find comprehensive guides and documentation to help you start working with LightStep as quickly as possible, as well as support if you get stuck. Let's jump right in!

Get Started    

Integrate with Grafana Using the LightStep Plugin

LightStep offers a plugin for Grafana that allows you to view LightStep Stream charts directly in Grafana. Clicking a LightStep chart in Grafana takes you directly to LightStep where you can continue your investigation.

Have more than one project?

The Grafana integration is on a per-project basis. If you want this integration for multiple LightStep projects, follow these instructions for each of your projects.


You install the plugin from the Grafana CLI using Grafana's plugin installation instructions.

The LightStep plugin is listed as grafana-lightstep-app and is located in Git.

Supported versions

The LightStep plugin supports up to version 5.3.2 of Grafana.

Enable the LightStep Plugin in Grafana

After you install the plugin, follow these steps:

  1. Restart the grafana server so it can discover the new plugin.
  2. On Grafana’s Home Dashboard, on the right, click Enable Now for the LightStep App.
  3. Click on the Grafana menu icon on the top left, and select Data Sources.
  4. On the top right, click Add data source.
  5. Set the name of your new data source (e.g. LightStep).
  6. Set the type to LightStep.
  7. Set your organization name.
    Your organization name can be found on the Account Settings > User Settings tab of LightStep.
  1. Set your project name.
    A list of your project names is found on the Account Settings > Project & Users tab.
  2. Set your API key.
    Your API key is found on the Account Settings > API Key tab. You should create a separate key for this integration.
  3. Make sure you leave the Access setting under Advanced set to Proxy.
  4. Hit Add at the bottom to save your new data source.

Updated 3 months ago

Integrate with Grafana Using the LightStep Plugin

Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.