Grafana Integration
Ingest Unified Alerting incidents and deploy annotations for Quality and DORA.
Why connect Grafana
Grafana is a Monitoring & Observability source. After you connect, the platform reads Unified Alerting incidents and deploy annotations on a schedule for Quality (MTTR, incident rates) and DORA (deployment frequency when deploy-tagged annotations exist).
The integration is read-only. We never create or change dashboards, alert rules, or annotations in your Grafana stack.
Prometheus is a separate connector. Use it when alerts live in Alertmanager rather than Grafana Unified Alerting.
What you need
- Grafana Cloud or self-hosted stack URL (for example
https://your-org.grafana.net). - A service account token with read access to alerting and annotations (Viewer role is enough).
- Optional Org ID for Grafana Cloud or multi-org stacks.
Localhost and private IP addresses are not supported from production. Use a publicly reachable HTTPS URL.
Select Grafana in your tech stack under Monitoring & Observability if you use it today.
Setup
- In Grafana, open Administration → Users and access → Service accounts, create a service account, and add a service account token.
- Optional: grant the service account a Viewer role.
- In the platform, go to Settings → Integrations and choose Connect on Grafana.
- Enter Grafana URL, service account token, and Org ID if your stack requires it.
- Click Test connection. Success shows your organization or user name.
- Click Connect (or Save) to store encrypted credentials.
- Optionally click Sync now for an immediate pull, or wait for the daily batch sync.
Data we read
| Grafana data | Platform use |
|---|---|
| Unified Alerting (Alertmanager-compatible API) | incident.declared / incident.resolved → Quality, MTTR |
Annotations tagged deploy, deployment, or release |
deployment.completed → DORA deployment frequency |
| Annotation text (commit SHA, environment when present) | DORA metadata |
We fetch roughly the last 30 days on each sync (scheduled daily or Sync now).
Data we do not read or change
| Not accessed | Notes |
|---|---|
| Loki logs or Tempo traces | Not in v1 scope |
| Dashboard JSON or panel queries | Not exported |
| Alert rule writes | Read-only |
| User/password login | Service account token only |
Sync schedule
After connect, the platform syncs on a daily batch schedule (same cadence as New Relic and Prometheus). Use Sync now in Integrations → Grafana for an immediate pull. You receive an in-app notification when a sync completes or fails.
SDLC Engineering Health (Insights)
Under Insights → Engineering Health, Grafana sync contributes to the same weekly dashboard buckets as other monitoring sources: MTTR from alerts and deployment frequency from deploy annotations.
Disconnect
Remove Grafana under Integrations → Disconnect. Polling stops; previously ingested events remain until retention applies.