Skip to main content
Grafana is a provider: connect it once and investigations can reach the data sources behind it and query the dashboards your team has built. It brings logs, metrics, traces, profiles, and your dashboards through a single connection.

What it provides

Connecting Grafana lets investigations discover and query the data sources it fronts:
Data sourceCapability
LokiLogs and metrics
PrometheusMetrics
TempoTraces
PyroscopeProfiles
CloudWatchMetrics and logs
Each has its own page covering what it supports and how it’s set up.
These are the data source types investigations discover from Grafana today. If Grafana fronts another tool you use, connect it directly instead — most have their own page in this section.

Dashboards

Your dashboards are one of the most useful things Grafana brings to an investigation, and they’re used in three ways:
  • Read as images. An investigation can render a dashboard to a screenshot and read that image directly, interpreting the charts the way a responder glancing at the dashboard would — spotting the spike, the dip, or the line that breaks trend. It isn’t limited to the numbers behind a panel; it sees the panel.
  • Queried for the incident. Investigations can run a dashboard’s panels for the incident’s time window, pulling the underlying data for the period that matters.
  • Learned from. The queries built into your dashboards are a record of how your team investigates — which signals matter, how they’re filtered and grouped. Investigations learn from them, which sharpens how they query the data sources behind Grafana, dashboard or not. See How telemetry works.
Connect the dashboards your team reaches for during incidents.
Add the dashboards engineers use most in investigations. You can connect up to 50 by default — reach out if you need more.

Setup

What you’ll need:
  • The URL of your Grafana instance.
  • A Grafana service account token with read access to data sources and dashboards, and permission to query them.
We recommend a read-only service account: investigations only ever read from Grafana.
  1. From the Investigations settings, add a telemetry data source and choose Grafana.
  2. Enter your Grafana URL and service account token, then test the connection.
  3. Once connected, investigations discover the data sources behind Grafana. Review them and enable the ones your team uses.
Data sources that allow broad querying, such as Loki, are left disabled by default so you opt in deliberately. Turn on the ones your responders rely on.

Telemetry overview

How providers and data sources fit together.

How telemetry works

Routing, query planning, guidance, and memory.