Dokumentation

Alarme und Kanäle

Ein Kanal ist ein Ort, an den ein Alarm gehen kann. Legen Sie beliebig viele an und wählen Sie dann pro Monitor, welche für den Normalfall und welche für die Eskalation sind.

Was Sie hinzufügen können

Diese legen Sie selbst an, unter Einstellungen → Benachrichtigungen:

• E-Mail — jede beliebige Adresse.
• Slack, Teams, Discord — eine Incoming-Webhook-URL aus der jeweiligen App.
• Telegram — ein Chat, verknüpft über unseren Bot.
• PagerDuty und Jira Service Management — ein Integrationsschlüssel.
• Webhook — Ihr eigener Endpunkt. Nur HTTPS, signiert, siehe unten.

Diese werden von der empfangenden Person selbst angelegt, nicht von jemand anderem eingetippt:

• Push — die mobile App installieren und Benachrichtigungen erlauben.
• SMS — die eigene Nummer eintragen und einen Code bestätigen, den wir dorthin schicken.
• WhatsApp — dasselbe, über WhatsApp.
• Satellit — ein Iridium-, Inmarsat- oder Thuraya-Gerät, per E-Mail über den Betreiber erreicht.

Wem gehört der Kanal

Jeder Kanal gehört entweder dem Team oder einer Person, und dieser Unterschied entscheidet, was passiert, wenn jemand geht.

Ein geteilter Kanal — ein #alerts-Webhook, ein PagerDuty-Service, ein Verteiler — gehört der Organisation und überdauert jeden Weggang.

Ein persönlicher — ein Handy, ein privater Telegram-Chat, eine Mobilnummer — gehört der Person, die ihn eingetragen hat, und wird gelöscht, wenn sie aus der Organisation entfernt wird. Bevor das so war, empfing der Telegram-Chat einer entfernten Kollegin unbegrenzt weiter Ausfallmeldungen, während Mitgliedschaft und API-Schlüssel längst widerrufen waren.

Prüfen Sie also beim Routen eines Alarms, wessen Kanal Sie ansteuern. Wer die Alarmierung einrichtet, ist meist nicht die Person, die sie weckt.

Eine Adresse muss zustimmen, bevor ihr etwas gesendet wird

E-Mail, SMS, WhatsApp und Satellit bestätigen zuerst. Legen Sie einen E-Mail-Kanal an, erhält die Adresse genau eine Nachricht — mit der Frage, ob sie Ziel für Alarme sein möchte — und sonst nichts, bis sie zustimmt. Beim Eintragen einer Telefonnummer tippen Sie einen Code zurück.

Das gibt es, weil ein E-Mail-Kanal eine Adresse ist, die jemand anders in das Konto von jemand anderem eingetippt hat. Ohne das könnte ein Bearbeiter einen flatternden Monitor auf den Posteingang einer fremden Person richten, und wir würden zustellen. Der Testversand wird bis zur Bestätigung verweigert, aus demselben Grund: Sonst ist er ein unbegrenzter Weg, eine Adresse ohne Einwilligung anzuschreiben, mit einer hilfreich aussehenden Beschriftung.

Chat- und Push-Kanäle fragen nicht, und das ist keine Ausnahme. Wer eine Slack-Webhook-URL eingefügt hat, musste sie besitzen, und ein Push-Kanal wird vom Besitzer des Geräts selbst registriert — keiner von beiden lässt sich durch Eintippen einer Adresse auf eine fremde Person richten.

Eine Adresse, die bereits einem bestätigten Mitglied Ihrer Organisation gehört, wird automatisch bestätigt. Diese Person hat bei der Anmeldung nachgewiesen, dass sie ihr gehört.

SMS und WhatsApp

Beide ab Pro, und beide schöpfen aus demselben Kontingent — Pro erhält 10 pro Tag, 15 pro Woche und 30 pro Monat; Business und Enterprise erhalten 15, 50 und 100. Sie sind ein Topf, weil beide pro Nachricht Geld kosten und beide dasselbe Handy erreichen — wovor die Grenze schützt, nämlich dass ein einziger flatternder Monitor ein Monatsbudget in einer Stunde ausgibt, ist ein Vorgang, gleich worüber er läuft.

Drei Fenster statt eines, weil eines die falsche Form hat. Eine reine Monatsgrenze lässt einen einzigen flatternden Monitor alles an einem Nachmittag ausgeben; eine reine Tagesgrenze lässt ein langsames Tröpfeln das Dreißigfache dessen kosten, was Sie vorhatten.

Die Grenze greift beim Einreihen der Nachricht, sodass eine blockierte nie einen Platz belegt, und gezählt wird, was tatsächlich gesendet wurde, statt ein Zähler — ein Zähler lässt sich über einen Aufruf an eine fremde API hinweg nicht ehrlich halten.

SMS erreicht nicht überall — und wir sagen das vor dem Eintragen

Die SMS-Reichweite hängt vom Land der Empfängerin ab. Manche Netze transportieren eine Nachricht von einem Absender wie unserem gar nicht; andere akzeptieren sie nur von einem Absendernamen, der bei der örtlichen Regulierungsbehörde registriert ist. Die Länderauswahl bietet nur Ziele an, die wir zu erreichen glauben, und die Preisseite führt die vollständige Liste.

Wo der Absendername durch eine lokale Nummer ersetzt werden kann, erfahren Sie das beim Eintragen und nicht aus einer Nachricht, die von einer fremden Nummer eintrifft. WhatsApp hat keine dieser Einschränkungen, braucht nirgends eine Registrierung und erreicht jedes Land, das SMS nicht erreicht.

Alarme enthalten niemals Links. Netzbetreiber filtern unbekannte URLs, und ein gefilterter Alarm ist einer, den Sie nie erhalten — ein Monitor namens acme.com kommt daher als acme com an.

Satellit

Für ein Gerät ganz ohne Mobilfunknetz. Nachrichten laufen per E-Mail über das Gateway des Betreibers, Sie zahlen also E-Mail- statt SMS-Tarife — aber die Betreiber begrenzen die Zustellung auf fünf Nachrichten pro Tag je Gerät, was deren Grenze ist und nicht unsere, und jede Nachricht wird auf 160 Zeichen gekürzt.

Ungewöhnlich langsam

Ein Monitor kann jede Prüfung bestehen und trotzdem in Schwierigkeiten sein. Sobald er mindestens einen Tag Verlauf hat, vergleichen wir, wie schnell er jetzt antwortet, mit seiner üblichen Antwortzeit vom selben Messpunkt aus, und melden uns, wenn er deutlich langsamer ist als sonst — über dieselben Kanäle wie ein Vorfall auf diesem Monitor. Ist er wieder so schnell wie üblich, sagen wir auch das. Das gibt es in jedem Tarif.

Es ist kein Vorfall. Nichts ist ausgefallen, daher zählt es nicht gegen die Verfügbarkeit, erscheint auf keiner Statusseite und eskaliert nicht. Schneller als üblich löst nie eine Warnung aus; eine Verlangsamung muss mindestens 100 ms betragen und deutlich außerhalb der normalen Schwankung des Monitors liegen; und nichts wird bewertet, solange der Monitor pausiert ist, in einem Wartungsfenster liegt oder bereits einen offenen Vorfall hat.

Ein Webhook erhält diese Ereignisse als latency_anomaly und latency_recovered, mit der üblichen und der gemessenen Antwortzeit in Millisekunden.

Webhooks

Nur HTTPS. Jede Anfrage ist signiert, damit Sie prüfen können, dass sie von uns kam. Private und Link-Local-Adressen werden beim Speichern der URL abgelehnt und erneut beim Senden des Alarms — denn ein Hostname, der beim Speichern auf eine öffentliche Adresse zeigte, kann später woanders hinzeigen, und eine URL, die gültig war, kann mit einer Weiterleitung irgendwohin antworten. Weiterleitungen werden nicht gefolgt.

Rufbereitschaft

Ab Pro. Bauen Sie eine Rotation, legen Sie die Eskalationsstufen fest, und ein unbestätigter Vorfall wandert sie hinauf. Bestätigen stoppt die Eskalation; Schließen beendet sie.

Die Eskalation ist es, die einen persönlichen Kanal lohnend macht: Die erste Stufe kann der Team-Chat sein und die letzte das Telefon einer Person um vier Uhr morgens.

Nachbetrachtungen

In jedem Tarif. Sobald ein Vorfall behoben ist, kann jeder, der Vorfälle beheben darf, seine Nachbetrachtung schreiben — was passiert ist, warum, und was sich ändert — und sie im Laufe der Untersuchung überarbeiten. Es gibt eine pro Vorfall, geschrieben in Markdown: Überschriften, fett und kursiv, Listen, Code, Zitate und Links. HTML wird als Text angezeigt und nie ausgeführt.

Eine Nachbetrachtung ist intern. Sie erscheint nie auf einer Statusseite, weil sie meist Personen, Systeme und Fehler benennt. Das Speichern wird im Audit-Log festgehalten — mit der Länge, nicht mit dem Inhalt.

Was passiert, wenn nichts zugestellt werden kann

Ein Kanal, der fehlschlägt, hält den Grund an sich selbst fest, in den Worten des Anbieters, statt still zu scheitern. Eine abgelehnte SMS sagt, was das Netz gesagt hat. Eine WhatsApp-Nachricht, die Minuten nach der Annahme abgelehnt wird, sagt, welches Template und welche Sprache.

Das ist wichtiger, als es klingt. Jeder dieser Anbieter antwortet sofort „angenommen“ und meldet das tatsächliche Ergebnis später — ohne diese Meldung sähe ein Kanal also bestätigt aus, die Nachricht sähe gesendet aus, und das Erste, was jemand hört, wäre ein Ausfall, von dem niemand erfahren hat.