Datadog

Datadog-Monitor-Alarme über eine Datadog-Webhook-Integration an Uptimeify Incident Management senden, bereits auf Titel, Alarmtyp und Übergangsstatus abgebildet.

Uptimeify bildet mit dem Datadog-Preset die Webhook-Benachrichtigungs-Payload eines Datadog-Monitors direkt ab: Alarmtitel, Alarmtyp, Übergangsstatus und Hostname sind bereits vorab gemappt.

1. Alert Source in Uptimeify anlegen

Gehe zu Incident Management → Alert Sources → Neu, wähle das Datadog-Preset, vergib einen Namen und lege die Source an. Kopiere auf dem Erfolgsbildschirm die Ingest-URL (https://deine-domain/api/im/ingest/<token>). Sie wird nur einmal angezeigt und danach nie wieder im Klartext eingeblendet. Solltest du sie verlieren, rotiere den Token im Tab Einstellungen der Source.

2. Webhooks-Integration in Datadog anlegen

Gehe in Datadog zu Integrations → Webhooks und klicke auf New.
Vergib einen Namen für den Webhook (z. B. uptimeify) und setze die URL auf die in Schritt 1 kopierte Ingest-URL.
Belasse den Payload bei Datadogs Standard-Monitor-Benachrichtigungs-Payload, unverändert, denn das Uptimeify-Preset erwartet die Standardfelder (alert_id, alert_title, alert_type, alert_transition, hostname, …). Falls du die Payload-Vorlage dieses Webhooks bereits angepasst hast, setze sie auf Datadogs Standard zurück, oder passe stattdessen den Tab Payload Mapping deiner Uptimeify-Source an deine eigenen Felder an.
Speichere den Webhook.

3. Monitore über den Webhook benachrichtigen

Datadog ruft eine Webhook-Integration nur auf, wenn die Benachrichtigungsnachricht eines Monitors sie explizit referenziert:

Öffne (oder erstelle) einen Datadog-Monitor.
Füge im Abschnitt Notify your team der Monitor-Nachricht @webhook-uptimeify hinzu (ersetze uptimeify durch den Namen, den du dem Webhook in Schritt 2 gegeben hast).
Speichere den Monitor. Datadog ruft den Webhook nun bei jedem Statuswechsel auf (Triggered, Warn, Recovered, …), den die Benachrichtigungsregeln des Monitors abdecken.

Wiederhole Schritt 2 und 3 für jeden Monitor, den du in Uptimeify sehen möchtest, oder füge @webhook-uptimeify zu einer Benachrichtigungs-Voreinstellung hinzu, die deine Monitore ohnehin teilen.

Standard-Feld-Mapping

Datadog-Feld	Normalisiertes Feld
`alert_title`	Titel
`alert_type`	Schweregrad (über die Zuordnung unten)
`alert_transition`	Status: `Recovered` löst den Alarm auf, alles andere hält ihn offen
`hostname`	Host
`alert_id`	Dedup-Key: gruppiert Benachrichtigungen für dasselbe Monitor-Event

Schweregrad-Zuordnung

Datadog `alert_type`	Uptimeify-Schweregrad
`error`	`sev1`
`warning`	`sev3`
`success`	`sev4`
`info`	`sev4`

Beispiel-Payload

So sieht die Payload aus, die das Datadog-Preset von Uptimeify erwartet:

{
  "id": "4707056510925961466",
  "alert_id": "1234567",
  "alert_title": "[Triggered] High CPU usage on host web-01",
  "alert_type": "error",
  "alert_transition": "Triggered",
  "alert_status": "Alert",
  "alert_metric": "system.cpu.user",
  "date": "1752739200000",
  "event_type": "metric_alert_monitor",
  "hostname": "web-01.prod.example.com",
  "org": { "id": "123456", "name": "Example Org" },
  "priority": "normal",
  "tags": "env:prod,service:web",
  "title": "[Triggered] High CPU usage on host web-01",
  "url": "https://app.datadoghq.com/event/event?id=4707056510925961466"
}

Du kannst genau diese Payload über den Tab Payload Mapping im Dashboard gegen das Mapping deiner Source senden, um den Aufbau zu prüfen, bevor du einen echten Monitor verbindest.