Dokumentation

Discord-Benachrichtigungen: Pingsured-Alarme in Discord

Pingsured kann eine Benachrichtigung in einen Discord-Kanal senden, wenn ein Ping ausfällt, wenn er wieder läuft und wenn sein Zertifikat ersetzt wird. Es ist ein Webhook, der Discord spricht: Sie geben Pingsured die URL eines Discord-Webhooks, und jede Benachrichtigung erscheint als Nachricht in diesem Kanal. Discord-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 Discord-Server, auf dem Sie Webhooks verwalten dürfen (die Berechtigung Webhooks verwalten), und den Kanal, in den die Benachrichtigungen gehen sollen. Ein Webhook schreibt in genau einen Kanal; für einen zweiten legen Sie einen zweiten Webhook an.

Den Webhook in Discord anlegen

  • Öffnen Sie in Discord die Einstellungen des Kanals (das Zahnrad neben seinem Namen), gehen Sie zu Integrationen und dann zu Webhooks, und wählen Sie Neuer Webhook.
  • Geben Sie ihm einen Namen und, wenn Sie möchten, ein Symbol, zum Beispiel Pingsured, und prüfen Sie, ob der Kanal der richtige ist.
  • Wählen Sie Webhook-URL kopieren. Sie sieht so aus: https://discord.com/api/webhooks/…/….

Discord ändert die Namen seiner Menüs von Zeit zu Zeit. Pingsured braucht die URL eines Webhooks.

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. Ist sie bekannt geworden, löschen Sie den Webhook in Discord und legen einen neuen an.

In Pingsured hinzufügen

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

Fügen Sie die Webhook-URL vollständig ein, mit Token. Pingsured akzeptiert nur Adressen, wie Discord-Webhooks sie haben (auf discord.com, unter /api/webhooks/); die URL eines anderen Dienstes oder eine vor dem Token abgeschnittene URL 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 Nachricht mit farbigem Balken und einer Überschrift aus dem Namen des Pings und einem Punkt, der den Zustand zeigt: 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.

Nachrichten benachrichtigen niemanden per Erwähnung: Ein Ping namens @everyone oder ein Fehlertext mit einer Erwähnung wird als Text angezeigt und löst nichts aus, was über die eigenen Einstellungen des Kanals für neue Nachrichten hinausgeht.

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 Discord-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 Discord nicht erreichbar, begrenzt es die Anfragen 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 ist endgültig, und Pingsured zeigt, was Discord gemeldet hat, wenn Sie in Einstellungen → Benachrichtigungen mit der Maus über das Status-Badge neben dem Kanal fahren. Üblich ist Unknown Webhook: Der Webhook wurde in Discord gelöscht. Abhilfe ist ein neuer Webhook: in Discord anlegen, in Pingsured hinzufügen und den alten entfernen.

Grenzen

  • Discord-Kanäle zählen mit den Webhooks zu denselben Grenzen: 50 für den ganzen Account und 20 pro Ping.
  • Nachrichten werden unter dem Namen und Symbol gepostet, die der Webhook in Discord hat. Erwähnungen und Direktnachrichten gibt es noch nicht.