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
- In Datadog, go to Organization Settings → API Keys and click New Key. Name it
obsy and copy the value.
- 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.
- In Obsy, go to Integrations, find the Datadog card, and click Connect.
- 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
- In your Grafana Cloud stack, go to Administration → Users and access → Service accounts.
- Click Add service account, name it
obsy, and assign the Editor role.
- Click Add service account token and copy the token.
- In Obsy, go to Integrations, find the Grafana Cloud card, and click Connect.
- Enter your Grafana instance URL (e.g.
https://myorg.grafana.net) and the service account token.
- Fill in your Prometheus datasource UID — find this in Grafana under Connections → Data sources → your Prometheus source → Settings (the UID is in the URL).
- 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) |
Open Integrations, find the connected platform card, and use the Edit or Disconnect actions.
Disconnecting a platform removes the stored credentials but does not delete dashboards or monitors already created in that platform.
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 for how to set up alert routing for each. 
