> ## 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.

# Connect an observability platform

> Link Datadog or Grafana Cloud to receive collector health data and create monitors.

Obsy reads collector health metrics and creates dashboards and monitors in your observability platform. You need at least one platform connected to use OTel Collector health reports, reliability reports, and alert monitors.

Go to **Integrations** in the sidebar to manage platform connections.

***

## Datadog

### Prerequisites

* A Datadog account with **Admin** or **Standard** role.
* An **API key** and an **Application key**.

### Steps

1. In Datadog, go to **Organization Settings → API Keys** and click **New Key**. Name it `obsy` and copy the value.
2. Go to **Organization Settings → Application Keys** and click **New Key**. Name it `obsy` and copy the value. The application key must belong to a user with **Admin** role.
3. In Obsy, go to **Integrations**, find the **Datadog** card, and click **Connect**.
4. Paste the API key and application key, enter your Datadog site (default `datadoghq.com` — change to `datadoghq.eu` for EU), and click **Save**.

Obsy verifies the keys by making a lightweight validate API call. A green **Connected** badge appears when successful.

### What Obsy does with Datadog

| Feature             | Required scopes    |
| ------------------- | ------------------ |
| OTel health reports | `metrics_read`     |
| Create dashboards   | `dashboards_write` |
| Create monitors     | `monitors_write`   |
| Send alert webhooks | `webhooks_write`   |

***

## Grafana Cloud

### Prerequisites

* A Grafana Cloud stack.
* A service account or API key with **Editor** role.

### Steps

1. In your Grafana Cloud stack, go to **Administration → Users and access → Service accounts**.
2. Click **Add service account**, name it `obsy`, and assign the **Editor** role.
3. Click **Add service account token** and copy the token.
4. In Obsy, go to **Integrations**, find the **Grafana Cloud** card, and click **Connect**.
5. Enter your **Grafana instance URL** (e.g. `https://myorg.grafana.net`) and the service account token.
6. Fill in your **Prometheus datasource UID** — find this in Grafana under **Connections → Data sources → your Prometheus source → Settings** (the UID is in the URL).
7. Click **Save**.

### What Obsy does with Grafana

| Feature                      | Required role                      |
| ---------------------------- | ---------------------------------- |
| OTel health reports (PromQL) | Viewer                             |
| Create dashboards            | Editor                             |
| Send alert webhooks          | — (configured in Grafana Alerting) |

***

## Updating or removing a platform

Open **Integrations**, find the connected platform card, and use the **Edit** or **Disconnect** actions.

<Warning>
  Disconnecting a platform removes the stored credentials but does not delete dashboards or monitors already created in that platform.
</Warning>

***

## Multiple platforms

You can connect both Datadog and Grafana at the same time. When creating dashboards or monitors, Obsy asks which platform to use. Webhook routing is per-platform — see [Webhooks](/integrations/webhooks) for how to set up alert routing for each.