CoNote

Datadog integration

Record triggered monitor alerts and recoveries as Incident notes, so an alert lines up with the deploy or change that set it off.

This integration puts Datadog's triggered monitor alerts (and recoveries) on your CoNote timeline as Incident notes — beside the deploys and config changes from the same moment.

What lands on your timeline

A note when a monitor triggers, and another when it recovers.

How it works

Datadog sends a webhook to CoNote when a monitor fires. Datadog webhooks don't sign requests, so CoNote verifies a secret you include (as a header or on the URL).

Setting it up

  1. Add the integration

    In Integrations, choose Datadog. Copy the webhook URL and the secret shown after you connect.

  2. Create the webhook in Datadog

    In Datadog, go to Integrations → Webhooks → New. Set the URL to the CoNote URL, add a custom header x-conote-secret with the secret (or append ?secret=… to the URL), and set the payload to the JSON shown in the connect screen.

  3. Add it to your monitors

    Add the webhook as a notification (@webhook-name) on the monitors you want on the timeline.

The payload template uses Datadog's $ALERT_TRANSITION variable, so CoNote can tell a trigger from a recovery. Keep the template as shown.

Related articles