Grafana

Connect Grafana to the Pagerly SRE Agent to search dashboards, check firing alerts, read annotations, and query Prometheus metrics.

What the Agent Can Do

• Search dashboards by keyword and link straight to the matching ones

• Check which Grafana alerts are currently firing (or pending, or in no data)

• Read annotations from a recent time window, optionally filtered by tag — find deployment markers and incident notes around the time of the incident

• Run PromQL queries against a Prometheus datasource through Grafana's datasource proxy

Setup Instructions

1. Log into your Grafana instance

2. Go to Administration (gear icon) > Service accounts

3. Click Add service account, give it a name (e.g., Pagerly)

4. Set the role to Viewer — the agent only reads, so Viewer is enough

5. Click Add service account token, then Generate token

6. In Pagerly, open SRE Agent Integrations, select Grafana, and paste the token and your Grafana URL

Required Credentials

Field	Description	Example
API Token	Grafana service account token	glsa_...
Grafana URL	Your Grafana instance URL. A dashboard URL also works; only the base is used.	https://your-org.grafana.net

Context Prompt Tips

The agent needs a datasource's UID to query metrics, and it can't look UIDs up on its own. Find it under Connections > Data sources > your Prometheus datasource (the last part of the page URL), and put it in the context prompt:

"Our main dashboards are in the SRE folder. Prometheus datasource UID is prom-prod. Key dashboards: api-latency, error-rates, k8s-overview. Deploys are annotated with the tag deploy."

Docs

• Grafana HTTP API