Skip to main content
Connecting Grafana lets Traversal query your dashboards, metrics, logs, and alerts during investigations to provide comprehensive observability insights.

​
What Traversal reads

  • Dashboards — panel definitions and queries
  • Alerts — Grafana-managed alert rules and their states
  • Data source proxy — metrics, logs, and traces queried through Grafana’s data source proxy

​
Setup

1

Copy your Grafana URL

Find your Grafana server URL (e.g., https://your-instance.grafana.net or your self-hosted URL).
Use the base URL only — not a link to a specific dashboard (e.g. .../d/<uid>/...). A dashboard link will not work and will not produce an obvious error.
2

Choose an authentication method

  1. Log in to your Grafana instance
  2. Go to Administration > Service Accounts
  3. Create a new service account with the Viewer role
  4. Click Add service account token and copy the token value — it won’t be shown again
If your Grafana instance uses SSO (Okta, Azure AD, Google, etc.), use a service account token — username/password will not work for API access.
3

Configure in Traversal

Go to Company Knowledge → Integrations, select Grafana, and enter your URL and credentials.

​
Private network access

If the service endpoint is not directly reachable by Traversal (as is common with self-hosted services), deploy a Traversal Connector in a network that can reach it. When configuring the integration, select that connector under Network Access Needed. The service endpoint does not need public internet exposure. See Set up the Traversal Connector for deployment and network requirements.

​
More information