Skip to main content
Back to Integrations
🐕

Datadog

Cloud-scale monitoring and security platform

Overview

Datadog is a monitoring and security platform for cloud applications. Integrate via webhooks to send monitor alerts to Akmatori for automated investigation.

Configuration Steps

1

Create Alert Source in Akmatori

Go to Settings → Alert Sources and create a new Datadog source. Copy the generated webhook URL.

2

Create Webhook Integration

In Datadog, go to Integrations → Webhooks and create a new webhook with your Akmatori URL. If you set a webhook secret in Akmatori, provide it through DD-API-KEY or X-Datadog-Signature.

3

Configure Monitors

Add @webhook-akmatori to your monitor notification message to trigger the integration.

Webhook Payload

Here's an example of the payload Akmatori expects from Datadog:

json
{
  "id": "event-dd-123",
  "title": "CPU usage is high",
  "body": "CPU usage on host web-01 is above 95%",
  "alert_type": "error",
  "event_type": "monitor.alert",
  "priority": "normal",
  "alert_id": "alert-dd-456",
  "alert_title": "High CPU usage detected",
  "alert_status": "Triggered",
  "hostname": "web-01",
  "date": 1705315800,
  "tags": ["service:web", "env:production", "host:web-01"],
  "event_links": [
    {
      "url": "https://runbooks.example.com/cpu",
      "name": "Runbook"
    }
  ],
  "alert_cycle_key": "cycle-abc123",
  "alert_metric": "system.cpu.user",
  "alert_query": "avg(last_5m):avg:system.cpu.user{host:web-01} > 95"
}
Akmatori extracts service and host from Datadog tags, uses alert_status for firing vs. resolved state, picks a runbook URL from event_links when available, and supports optional DD-API-KEY or X-Datadog-Signature webhook secrets.