Grafana integration: data source plugin
Owner Theo Hayashi · Last updated 2026-03-09 · v2.0
grafanaintegrationdatasourcepluginmetrics
Grafana integration
DevFlow ships a Grafana data source plugin so you can query our check results directly from a Grafana dashboard.
install
In Grafana, Connections → Add new connection → DevFlow. The plugin is signed and lives in Grafana's plugin marketplace. Configure with a DevFlow API key (read scope) — see rest-api-authentication.
query language
The data source supports two query types:
Time series:
json
{
"type": "timeseries",
"monitor": "payments-api-charge",
"metric": "latency_ms",
"regions": ["us-east-1", "eu-west-1"],
"step": "60s"
}Stat:
json
{
"type": "stat",
"slo": "payments-availability-99.9",
"metric": "burn_rate",
"window": "1h"
}panels we recommend
- Per-region latency for each critical monitor (timeseries).
- SLO attainment + burn rate (stat).
- Error-budget remaining (stat with thresholds).
limits
The data source caches recent queries for 30s server-side to keep our API rate-limit happy. For dashboards with very many panels, consider a datadog-integration flow instead — Datadog stores its own copy.
removing
Uninstall the plugin from Grafana, or revoke the API key in DevFlow.