Important: This documentation is about an older version. It's relevant only to the release noted, many of the features and functions have been updated or replaced. Please view the current version.

Enterprise Open source

Access or install Traces Drilldown

You can access Grafana Traces Drilldown using any of these:

  • Grafana Cloud: The easiest method, since no setup or installation is required.
  • Self-managed Grafana open source or Enterprise: You must install the Traces Drilldown plugin.

Traces Drilldown requires Grafana Tempo 2.6 or later with TraceQL metrics configured.

Set up in Grafana Cloud

To use Traces Drilldown with Grafana Cloud, you need the following:

  • Grafana Cloud account
  • Grafana stack in Grafana Cloud receiving tracing data from your stack’s default Hosted Traces data source or a Tempo data source

Set up in self-managed Grafana

To use Traces Drilldown with self-managed Grafana open source or Grafana Enterprise, you need:

Next, access Traces Drilldown.

Install the Traces Drilldown plugin

Note

Grafana v12 and later includes all Drilldown apps, including Traces Drilldown. No separate installation is required. Go to Access Traces Drilldown.

Traces Drilldown is distributed as a Grafana plugin. You can find it in the official Grafana Plugin Directory.

Install in your Grafana instance

You can install Traces Drilldown in your Grafana instance using grafana cli:

shell
grafana cli plugins install grafana-exploretraces-app

Alternatively, follow these steps to install Traces Drilldown in Grafana:

  1. In Grafana, go to Administration > Plugins and data > Plugins.
  2. Search for “Traces Drilldown”.
  3. Select Traces Drilldown.
  4. Click Install.

The plugin is automatically activated after installation.

Install in a Docker container

To install the app in a Docker container, configure the following environment variable:

shell
GF_INSTALL_PLUGINS=grafana-exploretraces-app

Access Traces Drilldown

To access Traces Drilldown, use the following steps:

  1. Open your Grafana stack in a web browser.
  2. In the main menu, select Drilldown > Traces.

Next steps

To learn how to use Traces Drilldown to explore your tracing data: