Troubleshoot the Grafana Integration

Use this guide when Grafana cannot connect or queries do not return data.

Grafana shows as not connected

grafana_connection_health reports grafana_not_configured or the application shows a failed connection. Possible causes:

• the integration was never connected;
• the service account token was revoked or expired;
• the Grafana URL is incorrect or unreachable from platform-api.

Re-enter the Grafana URL and a valid read-only service account token in IncidentFlow → Integrations → Grafana.

No datasources found

grafana_connection_health reports grafana_no_datasources. Confirm:

• the Grafana instance has at least one datasource;
• the service account can read datasources (Viewer role);
• the datasource is approved for IncidentFlow use.

A query returns no data

Verify:

• the datasource UID is correct;
• the PromQL passes the server-side guardrails (bounded time range and limits);
• the metric exists for the selected time window;
• the dashboard or panel is in the approved allow-list.

Collect diagnostic information

When contacting support, include the Grafana URL host, the datasource UID, the approximate time, and the MCP request_id. Never include the service account token or raw credentials.