Wie wir dich informieren oder benachrichtigen
Eine Störung ist nur dann relevant, wenn die richtigen Personen davon erfahren. Wir senden Benachrichtigungen dorthin, wo dein Team bereits ist, und an deine eigenen Systeme über Webhooks.
Die Kanäle
Jeder Kanal erhält die gleiche Nachricht: welcher Monitor, seit wann und warum. Unten findest du eine Liste der verfügbaren Kanäle.
-
Email Jeder Tarif
Eine Nachricht an jede Adresse. Die E-Mail-Adresse muss einmal bestätigt werden.
-
Webhook (POST) Jeder Tarif
Ein JSON-Body mit den relevanten Daten wird an eine von dir angegebene URL gesendet. Für deine eigene Automatisierung: ein Ticket öffnen, jemanden benachrichtigen, eine Statusanzeige ändern.
-
Webhook (GET) Jeder Tarif
Die gleichen Felder wie beim POST-Webhook, aber jetzt als Query-Parameter, für einen Empfänger, der GET-Anfragen akzeptiert.
-
PagerDuty Starter und höher
Ein Vorfall über die Events API v2, eröffnet bei einer Störung und gelöst bei der Wiederherstellung, sodass PagerDutys eigene Eskalation übernimmt.
-
Slack Pro und Business
Eine Nachricht in einem Kanal, rot für offline und grün für wieder online, über einen Webhook.
-
Microsoft Teams Pro und Business
Die gleiche Nachricht in einem Teams-Kanal, über einen Webhook.
-
Discord Pro und Business
Die gleiche Nachricht in einem Discord-Kanal, über einen Kanal-Webhook.
-
Telegram Pro und Business
Die gleiche Nachricht in einem Chat, über deinen eigenen Bot.
Wer erfährt was, und wann
Zuerst bestätigt
Nichts wird basierend auf der Aussage einer einzelnen Probe gesendet. Ein Fehler wird zu einer Störung, wenn Proben auf drei Kontinenten übereinstimmen, sodass eine Warnung bedeutet, dass die Seite offline ist und nicht nur ein Netzwerkproblem.
Regeln und Eskalation
Eine Regel beschreibt, wer über welche Monitore und zu welcher Zeit informiert wird. Setze die Bereitschaftsliste in eine Kontaktgruppe mit einer Verzögerung pro Mitglied. Das funktioniert als deine Eskalationsrichtlinie.
Wieder online, einmal gesagt
Jeder, der über die Störung informiert wurde, wird informiert, wenn sie endet, mit der Dauer. Wir wecken dich nicht, um dir zu sagen, dass die Störung vorbei ist.
Teste es, bevor du es brauchst
Jede Adresse hat einen Button, der einen Test über denselben Weg sendet, den eine echte Benachrichtigung nimmt, so formuliert, dass er nicht mit einer echten Störung verwechselt werden kann.
Der Webhook, für deine eigenen Systeme
Eine Webhook-Adresse ist eine URL von dir. Wir rufen sie auf, wenn eine Störung bestätigt wird, wenn sie behoben ist und wenn du Test drückst. POST sendet die Felder als JSON-Body; GET sendet sie als Query-Parameter. Die URL wird verschlüsselt gespeichert und nie wieder vollständig angezeigt, da jeder, der sie hat, darauf posten kann.
| Feld | Was es enthält |
|---|---|
| reason | down bei bestätigter Störung, recovery wenn sie endet, test wenn jemand den Button gedrückt hat |
| monitor | Der Name des Monitors |
| monitor_id | Seine id |
| target | Was es prüft: die URL, den Host oder den Namen |
| type | Die Art der Prüfung, als Kurzname wie https, dns oder ssl_cert |
| cause | Warum es fehlgeschlagen ist, in ein paar Worten, wenn wir es wissen |
| error_class | Dasselbe als Kurzname, auf den ein Programm verzweigen kann, wie timeout, connection oder certificate_expired |
| started | Wann die Störung begann |
| confirmed_at | Wann der Fehler bestätigt wurde |
| confirmed_from | Die Kontinente, die es bestätigt haben, als Liste von Namen. |
| degraded | true, wenn der Monitor langsam ist oder Pakete verliert, statt offline zu sein |
| resolved | Wann es endete, als ISO-8601-Zeitstempel, bei einer Wiederherstellung |
| duration | Wie lange es dauerte, in Worten, bei einer Wiederherstellung |
| incident_id | Die ID des Vorfalls, dieselbe bei der Störung und ihrer Wiederherstellung |
Ein Feld ohne Wert ist null im JSON und wird bei einem GET weggelassen. Du musst mit einem Status unter 400 antworten. Alles andere zählt als fehlgeschlagene Zustellung und wird nach 30 Sekunden, 2 Minuten und 10 Minuten erneut versucht, dann aufgegeben: eine Warnung, die innerhalb einer Viertelstunde nicht angekommen ist, ist Geschichte, keine Nachricht.