---
title: "Alert-Source-Einrichtungsanleitungen"
description: "Schritt-für-Schritt-Anleitungen, um Zabbix, Datadog, Grafana Alerting, Prometheus Alertmanager, Sentry oder einen beliebigen eigenen Webhook mit Uptimeify Incident Management zu verbinden."
---

Jede der folgenden Anleitungen zeigt, wie du ein Monitoring- oder Alerting-Tool so konfigurierst, dass es seine Alarme an eine Uptimeify **Alert Source** sendet, an einen Tool-spezifischen Ingest-Endpunkt mit fertigem Feld-Mapping. Dadurch landen Alarme bereits normalisiert (Titel, Schweregrad, Status, Host) in Incident Management, ohne dass du eine eigene Integration schreiben musst.

## Anleitungen

- [Zabbix](./zabbix)
- [Datadog](./datadog)
- [Grafana Alerting](./grafana-alerting)
- [Prometheus Alertmanager](./prometheus-alertmanager)
- [Sentry](./sentry)
- [Benutzerdefinierter Webhook](./custom-webhook)
- [E-Mail](./email)

Die Anleitung **E-Mail** funktioniert anders als die übrigen: eine E-Mail-Source hat keine JSON-Webhook-Payload, daher gelten die Abschnitte „So funktioniert das Einspeisen“ und „Schweregrad-Mapping“ unten (beide Webhook-spezifisch) nicht für sie; sieh dir direkt diese Anleitung an.

## So funktioniert das Einspeisen

1. Gehe im Uptimeify-Dashboard zu **Incident Management → Alert Sources → Neu** und wähle das Preset, das zu deinem Tool passt. Vergib einen Namen und weise die Source optional einem Team zu.
2. Uptimeify erzeugt eine eindeutige Ingest-URL:

   ```
   https://<deine-domain>/api/im/ingest/<token>
   ```

   Der `<token>` wird **einmalig** direkt nach dem Anlegen der Source angezeigt. Kopiere ihn sofort. Danach wird er nie wieder im Klartext angezeigt. Solltest du ihn verlieren, öffne den Tab **Einstellungen** der Source und rotiere den Token, um eine neue URL zu erhalten (ebenfalls nur einmalig sichtbar).

3. Konfiguriere dein Tool (siehe die jeweilige Anleitung) so, dass es bei jedem ausgelösten oder aufgelösten Alarm eine HTTP-`POST`-Anfrage mit JSON-Body an diese URL sendet.
4. Uptimeify parst das Payload anhand des Feld-Mappings des Presets (oder deines eigenen, angepassten Mappings im Tab **Payload Mapping** der Source) und reiht es zur asynchronen Verarbeitung in Incident Management ein.

Das ist ein anderer Mechanismus als der [Events-Ingest](../events-ingest)-Endpunkt (`POST /api/im/events`): Dieser wird mit einem organisationsweiten API-Token authentifiziert und hat kein voreingestelltes Feld-Mapping (jede Anfrage läuft über eine einzige, automatisch angelegte Source vom Typ `api`). Die Tool-spezifische Ingest-URL oben hat keine separate Authentifizierung (der in der URL enthaltene Token **ist** das Credential, behandle die vollständige URL also wie ein Passwort), bringt dafür aber ein fertiges Mapping für das gewählte Tool mit.

## Anfragelimits

Für jede Ingest-URL gelten unabhängig vom Preset dieselben Limits:

| Limit | Wert | Fehler |
|-------|-------|---------|
| Body-Größe | 256 KB | `413 Payload Too Large` |
| JSON-Verschachtelungstiefe | 20 Ebenen | `422 Unprocessable Entity` (`payload_too_deep`) |
| Body muss gültiges JSON sein | — | `422 Unprocessable Entity` (`invalid_json`) |

Ein leerer Request-Body wird als `{}` behandelt.

## Antwort

Eine erfolgreiche Anfrage liefert immer sofort `202 Accepted`: der Alarm ist eingereiht, aber noch nicht verarbeitet:

```json
{ "accepted": true }
```

Ein unbekannter, falscher oder durch Rotation ungültig gewordener Token liefert `404 Not Found` (`not_found`). Jede Art von Authentifizierungsfehler liefert bewusst dieselbe Antwort, so wird nie verraten, ob ein Token jemals existiert hat. `503 Service Unavailable` (`unavailable`) bedeutet, dass der Alarm nicht eingereiht werden konnte, und ist sicher wiederholbar.

## Schweregrad-Mapping

Jedes Preset außer **Benutzerdefinierter Webhook** (der keinen Schweregrad-Selektor hat) bildet den rohen Schweregrad-Wert des Anbieters auf einen von Uptimeifys vier Incident-Schweregraden ab:

| Uptimeify-Schweregrad | Bedeutung |
|---------------------|---------|
| `sev1` | Schlimmster / kritisch |
| `sev2` | Hoch |
| `sev3` | Warnung |
| `sev4` | Niedrig / informativ |

Ein Schweregrad-Wert des Anbieters, der nicht in der Zuordnung enthalten ist, oder ein fehlendes Schweregrad-Feld, fällt auf den in der Alert Source konfigurierten Standard-Schweregrad zurück, nicht automatisch auf `sev4`.