Dokumentation

Slack-Benachrichtigungen: Pingsured-Alarme in einen Slack-Kanal

Pingsured kann eine Benachrichtigung in einen Slack-Kanal senden, wenn ein Ping ausfällt, wenn er wieder läuft und wenn sein Zertifikat ersetzt wird. Es ist ein Webhook, der Slack spricht: Sie geben Pingsured die URL eines Slack-Webhooks, und jede Benachrichtigung erscheint als lesbare Nachricht in diesem Kanal. Slack-Benachrichtigungen gibt es in denselben Tarifen wie Webhooks, also in jedem kostenpflichtigen Tarif. Eingerichtet werden sie von einem Eigentümer oder Manager des Accounts, für einen einzelnen Ping oder als Standard für alle Pings des Accounts.

Was Sie brauchen

  • Einen Slack-Workspace, in dem Sie eine App hinzufügen dürfen, oder eine Administratorin bzw. einen Administrator, der sie freigibt.
  • Den Kanal, in den die Benachrichtigungen gehen sollen. Ein Webhook schreibt in genau einen Kanal; für einen zweiten Kanal legen Sie einen zweiten Webhook an.

Den Webhook in Slack anlegen

Legen Sie den Webhook in einer Slack-App an, nicht über die ältere Integration „Incoming WebHooks“ aus dem App-Verzeichnis von Slack. Slack empfiehlt diese Integration nicht mehr und kann sie abschalten.

  • Öffnen Sie api.slack.com/apps und wählen Sie Create New App, dann From scratch. Geben Sie ihr einen Namen, zum Beispiel Pingsured, und wählen Sie Ihren Workspace.
  • Öffnen Sie in den Einstellungen der App Incoming Webhooks und schalten Sie die Funktion ein.
  • Wählen Sie Add New Webhook to Workspace, den Kanal und erlauben Sie den Zugriff.
  • Kopieren Sie die Webhook URL. Sie beginnt mit https://hooks.slack.com/services/.

Behandeln Sie die URL wie ein Geheimnis: Wer sie kennt, kann in diesen Kanal schreiben. Pingsured zeigt sie nur Eigentümern und Managern vollständig an.

In Pingsured hinzufügen

  • Für alle Pings öffnen Sie Einstellungen → Benachrichtigungen, gehen unter Standardbenachrichtigungen zu Integrationen und wählen die Karte Slack.
  • Für einen Ping öffnen Sie den Ping, gehen zum Abschnitt Benachrichtigungen, wählen Benachrichtigung hinzufügen und dann Slack.

Fügen Sie die Webhook-URL ein. Pingsured akzeptiert nur Adressen von Slack selbst, die URL eines anderen Dienstes wird schon beim Speichern abgelehnt. Wählen Sie dann die Auslöser. Empfohlen sind Erster Fehler und Erstes OK, dazu Zertifikat geändert, wenn Sie Zertifikate prüfen: Sie erfahren, wenn etwas ausfällt und wenn es behoben ist.

Mit Test senden neben dem Kanal wird eine als Test gekennzeichnete Nachricht gepostet. So sehen Sie, ob URL und Kanal stimmen, bevor ein echter Alarm darauf angewiesen ist.

So sieht eine Nachricht aus

  • Eine Überschrift mit dem Namen des Pings und einem farbigen Punkt: rot bei Ausfall, gelb bei Beeinträchtigung, grün nach der Wiederherstellung.
  • Der Grund, wenn es einen gibt: der HTTP-Status, der Fehler oder warum eine Inhaltsprüfung fehlgeschlagen ist.
  • Wo es gesehen wurde: entweder der Standort, etwa Von de, oder bei einem Ping mit mehreren Standorten, welche davon ausfallen, etwa Fehler an de, sg (2 von 3 Standorten).
  • Ein Link, Ping in Pingsured ansehen, der den Ping öffnet.

Ein Zertifikatswechsel lautet Zertifikat geändert bei dem Ping, oder Unerwartetes Zertifikat bei ihm, wenn der Wechsel nicht nach einer Erneuerung aussieht, mit den Gründen darunter.

Die Sprache der Nachrichten

Nachrichten sind in der Sprache der Benachrichtigungen des Accounts geschrieben, die ein Eigentümer unter Einstellungen → Account festlegt. Es gibt sie auf Englisch, Deutsch, Spanisch, Französisch und Italienisch. Solange nichts eingestellt ist, sind sie englisch. Dieselbe Einstellung ist die Ausweichsprache für Alarm-E-Mails an Mitglieder, die keine eigene Sprache gewählt haben. Die Grundzeile steht so da, wie der geprüfte Dienst sie gemeldet hat, in dessen Sprache.

Wann Nachrichten gesendet werden

Ein Slack-Kanal folgt denselben Regeln wie jeder andere Benachrichtigungskanal: welche Änderungen, wie viele Fehler zuerst, wie oft und von wo, ist auf der Seite zu den Benachrichtigungen beschrieben. Eine Statusänderung wird immer sofort gesendet, wiederholte Alarme für denselben Ping und Kanal werden 15 Minuten zurückgehalten.

Wenn eine Nachricht nicht ankommt

Ist Slack nicht erreichbar oder antwortet mit einem Fehler, der vorübergehen kann, wird die Zustellung wiederholt, insgesamt 5 Versuche im Abstand von 30 Sekunden, 5 Minuten, 30 Minuten und 2 Stunden. Jede andere Antwort von Slack ist endgültig. Slack nennt einen kurzen Grund, zum Beispiel no_service, wenn der Webhook entfernt wurde, oder channel_is_archived, wenn der Kanal archiviert wurde. Pingsured zeigt, was Slack gemeldet hat, wenn Sie in Einstellungen → Benachrichtigungen mit der Maus über das Status-Badge neben dem Kanal fahren. Meist hilft ein neuer Webhook: in der Slack-App anlegen, in Pingsured hinzufügen und den alten entfernen.

Grenzen

  • Slack-Kanäle zählen mit den Webhooks zu denselben Grenzen: 50 für den ganzen Account und 20 pro Ping.
  • Nachrichten gehen in den Kanal, für den der Webhook angelegt wurde. Erwähnungen, Direktnachrichten und Threads gibt es noch nicht.