> ## Documentation Index
> Fetch the complete documentation index at: https://docs.obsy.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Grafana Cloud

> Connect Grafana Cloud for collector health metrics and dashboards.

See [Connect an observability platform](/getting-started/connect-platform) for initial setup.

***

## What the Grafana integration enables

| Feature                        | Requires                                           |
| ------------------------------ | -------------------------------------------------- |
| OTel health reports (PromQL)   | Service account token with Viewer role             |
| Reliability reports            | Service account token with Viewer role             |
| Create dashboards              | Service 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**:

```promql theme={null}
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](/alerts/grafana) for step-by-step setup.

Unlike Datadog, Obsy cannot auto-register a webhook in Grafana — you configure it manually in **Alerting → Contact points**.