Skip to main content
See Connect an observability platform for initial setup.

​
What the Grafana integration enables

FeatureRequires
OTel health reports (PromQL)Service account token with Viewer role
Reliability reportsService account token with Viewer role
Create dashboardsService account token with Editor role
Alert contact point (webhooks)Configured in Grafana Alerting — no API key needed

​
Finding your Prometheus datasource UID

Obsy needs the UID of your Prometheus datasource to run PromQL queries.
  1. In Grafana, go to Connections → Data sources.
  2. Click your Prometheus or Mimir datasource.
  3. The UID is in the browser URL: grafana.net/connections/datasources/edit/{UID}.
Copy this value and enter it in the Prometheus datasource UID field when connecting.

​
Updating credentials

  1. Go to Integrations → Grafana card.
  2. Click Edit.
  3. Update the instance URL, service account token, or datasource UID.
  4. Click Save.

​
OTel metric naming in Grafana (PromQL)

Grafana uses standard Prometheus naming, so keep the _total suffix: 
rate(otelcol_receiver_accepted_spans_total[5m])
This is the opposite of Datadog. Obsy handles this automatically — the correct query format is used based on which platform is selected.

​
Setting up alert webhooks

Grafana uses Contact Points for alert routing. See Grafana alerts for step-by-step setup. Unlike Datadog, Obsy cannot auto-register a webhook in Grafana — you configure it manually in Alerting → Contact points.