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

What the Datadog integration enables

FeatureRequires
OTel health reportsAPI key + App key
Reliability reportsAPI key + App key
Create dashboardsApp key with dashboards_write
Create monitorsApp key with monitors_write
Automatic webhook registrationApp 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

SiteURLsite value
US1 (default)datadoghq.comdatadoghq.com
EUdatadoghq.eudatadoghq.eu
US3us3.datadoghq.comus3.datadoghq.com
US5us5.datadoghq.comus5.datadoghq.com
AP1ap1.datadoghq.comap1.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.