---
title: "Datadog"
description: "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

1. Gehe in Datadog zu **Integrations → Webhooks** und klicke auf **New**.
2. Vergib einen Namen für den Webhook (z. B. `uptimeify`) und setze die **URL** auf die in Schritt 1 kopierte Ingest-URL.
3. 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.
4. Speichere den Webhook.

## 3. Monitore über den Webhook benachrichtigen

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

1. Öffne (oder erstelle) einen Datadog-**Monitor**.
2. 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).
3. 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:

```json
{
  "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.
