Incident Management
Öffentliche REST-API für Uptimeify Incident Management (IM): Alerts aus eigenen Monitoring-Systemen einspeisen und Incidents programmatisch verwalten.
Incident Management (IM) ist eine von Monitoring getrennte Domäne: ein zweistufiges Alert-/Incident-Modell mit Teams, On-Call-Zeitplänen und Eskalationsrichtlinien. Dieser Abschnitt beschreibt die öffentlichen REST-Endpunkte zum Einspeisen von Alerts und zum programmatischen Verwalten von Incidents.
Authentifizierung
Jeder der folgenden Endpunkte erfordert einen organisationsweiten API-Token:
BASE_URL="https://uptimeify.io"
TOKEN="wsm_<dein-organisationsweiter-api-token>"Erstelle einen über Organisations-Token erstellen und lasse customerId dabei weg. Ein Token, der mit einer customerId erstellt wurde (ein kunden-gescopter Token), wird immer mit 403 Forbidden (imAccessDenied) abgelehnt; Incident Management hat bewusst keine kundenseitige Oberfläche.
Incident Management muss außerdem für deine Organisation aktiviert sein, sonst liefert jeder der folgenden Endpunkte 403 Forbidden (imNotEnabled).
Endpunkte
- Events Ingest:
POST /api/im/events - Incidents auflisten:
GET /api/im/incidents - Incident abrufen:
GET /api/im/incidents/:id - Incident erstellen:
POST /api/im/incidents - Incident bestätigen / Status ändern:
POST /api/im/incidents/:id/status - Incident lösen:
POST /api/im/incidents/:id/resolve - Teams:
GET /api/im/teams - Schedules:
GET/POST /api/im/schedules - Schedule-Overrides:
GET/POST /api/im/schedules/:id/overrides - Wer hat Bereitschaft:
GET /api/im/on-call
Alert-Source-Einrichtungsanleitungen
Möchtest du Alarme lieber aus einem bestehenden Monitoring-Tool senden, statt die API direkt aufzurufen? Die Alert-Source-Einrichtungsanleitungen enthalten Schritt-für-Schritt-Anleitungen für Zabbix, Datadog, Grafana Alerting, Prometheus Alertmanager, Sentry und jeden benutzerdefinierten Webhook. Jede nutzt ihre eigene, Source-spezifische Ingest-URL (POST /api/im/ingest/:token), getrennt vom oben genannten Events-Ingest-Endpunkt.
Fehlercodes
Siehe Fehlerliste und bekannte API-Fallen für die vollständige Liste der data.code-Werte, die diese Endpunkte liefern können.
Maintenance Window aktualisieren
Aktualisiert ein Wartungsfenster partiell. Alle Felder sind optional; nur angegebene Felder werden geändert. Wenn targets oder tagIds angegeben werden, ersetzen sie die bestehende Auswahl vollständig.
Incident bestätigen / Status ändern
Bewegt einen Incident-Management-Incident zwischen den offenen Status (acknowledged, investigating, identified, monitoring). status auf acknowledged setzen, um einen Incident zu bestätigen.