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

# Datadog

> Connect Datadog for collector health metrics, dashboards, and monitors.

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

***

## What the Datadog integration enables

| Feature                        | Requires                          |
| ------------------------------ | --------------------------------- |
| OTel health reports            | API key + App key                 |
| Reliability reports            | API key + App key                 |
| Create dashboards              | App key with `dashboards_write`   |
| Create monitors                | App key with `monitors_write`     |
| Automatic webhook registration | App key with `integrations_write` |

***

## Updating credentials

1. Go to **Integrations → Datadog card**.
2. Click **Edit**.
3. Update the API key, application key, or site.
4. Click **Save**.

***

## Datadog sites

| Site          | URL                 | `site` value        |
| ------------- | ------------------- | ------------------- |
| US1 (default) | `datadoghq.com`     | `datadoghq.com`     |
| EU            | `datadoghq.eu`      | `datadoghq.eu`      |
| US3           | `us3.datadoghq.com` | `us3.datadoghq.com` |
| US5           | `us5.datadoghq.com` | `us5.datadoghq.com` |
| AP1           | `ap1.datadoghq.com` | `ap1.datadoghq.com` |

Set the site to match where your Datadog organization is hosted.

***

## OTel metric naming in Datadog

The Datadog OTel exporter converts OTLP counter metrics by **dropping the `_total` suffix**:

```
Prometheus name:  otelcol_receiver_accepted_spans_total
Datadog name:     otelcol_receiver_accepted_spans     ← use this
```

Gauge metrics (e.g. `otelcol_exporter_queue_size`, `otelcol_process_memory_rss`) are unchanged.

Obsy's queries already use the correct Datadog names. If you're writing your own Datadog monitors for OTel collector health, use the names without `_total`.

***

## Webhook auto-registration

When you click **Create Monitors**, Obsy automatically registers the `obsy` webhook in your Datadog organization using your application key. After registration, Obsy adds `@webhook-obsy` to all 11 generated monitors.

You can verify the webhook in Datadog: **Integrations → Webhooks → obsy**.