> ## Documentation Index
> Fetch the complete documentation index at: https://docs.traversal.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Grafana

> Connect Grafana to query dashboards, metrics, logs, traces, and alerts during investigations.

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

<Steps>
  <Step title="Copy your Grafana URL">
    Find your Grafana server URL (e.g., `https://your-instance.grafana.net` or your self-hosted URL).
  </Step>

  <Step title="Choose an authentication method">
    <Tabs>
      <Tab title="Bearer token (recommended)">
        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

        <Warning>
          If your Grafana instance uses SSO (Okta, Azure AD, Google, etc.), use a service account token — username/password will not work for API access.
        </Warning>
      </Tab>

      <Tab title="Username and password">
        Use the username and password of a user with read access to the dashboards and data sources Traversal should query.

        <Warning>
          Username/password does not work if your Grafana instance uses SSO (Okta, Azure AD, Google, etc.). Use a service account token instead.
        </Warning>
      </Tab>
    </Tabs>
  </Step>

  <Step title="Configure in Traversal">
    Go to **Company Knowledge → Integrations**, select **Grafana**, and enter your URL and credentials.
  </Step>
</Steps>

## More information

* [Grafana service accounts](https://grafana.com/docs/grafana/latest/administration/service-accounts/)