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

# Grafana

> Query Grafana dashboards, alerts, and metrics from Warrnagen.

## Overview

The Grafana connector lets Warrnagen query your Grafana instance for dashboards, alerts, and metrics during incident investigations.

## Setup

1. Generate an API key from your Grafana instance (**Administration → API Keys**).
2. Go to **Settings → Connectors** and click **Install** on the Grafana connector.
3. Enter your Grafana API key and instance URL.
4. Configure tool access levels as needed.
5. Bind dashboards to your Warrn services.

## Available Tools

| Tool              | Category | Description                                 |
| ----------------- | -------- | ------------------------------------------- |
| Get Dashboard     | Read     | Retrieve a Grafana dashboard by UID         |
| List Alerts       | Read     | List active Grafana alerts                  |
| Query Metrics     | Read     | Execute metrics queries against datasources |
| Get Alert History | Read     | Get historical alert state changes          |

<Note>
  The Grafana connector supports tool discovery. Additional tools may be available beyond those listed above.
</Note>

## Service Bindings

Bind Grafana dashboards to Warrn services so Warrnagen can pull the right metrics during investigations.

| Field           | Description                            | Required |
| --------------- | -------------------------------------- | -------- |
| Dashboard UID   | Default dashboard UID for this service | No       |
| Organization ID | Grafana organization ID                | No       |

## Type

**Contextual** — Warrnagen reads dashboards and metrics from Grafana during incident investigations.