Einrichtung und Konfiguration - Discord

Was diese Integration verschickt

Die Discord-Integration ist eine Funktion des DockRay-Panels - der Benachrichtigungskanal postet in einen gewählten Discord-Kanal, sobald der Scheduler oder die Ingest-Pipeline eines von fünf Monitoring-Ereignissen erkennt:

• ping - der Anwendungsserver antwortet nicht mehr,
• ssl - das Zertifikat läuft bald ab,
• google-page-speed - ein Leistungseinbruch,
• issue - ein neuer, bisher unbekannter Fehler,
• error-spike - ein plötzlicher Anstieg der Fehlerzahl.

Jeder Ereignistyp hat einen eigenen Schalter und kann in einen anderen Kanal desselben Discord-Servers gehen.

Vorbereitung in Discord

1. Lege im Discord Developer Portal eine Anwendung an und füge ihr einen Bot hinzu.
2. Kopiere das Bot-Token aus dem Tab Bot.
3. Lade den Bot mit einem OAuth2-Link, der den Scope bot enthält, auf deinen Server ein.
4. Gib ihm auf den Kanälen, in denen Alerts erscheinen sollen, die Rechte View Channel, Send Messages und Embed Links.
5. Kopiere die ID jedes Zielkanals (Discord-Entwicklermodus → Rechtsklick auf den Kanal → Kanal-ID kopieren).

DockRay erkennt einen Kanal ausschließlich über seine numerische ID, nie über den Namen - Discord erlaubt zwei Kanäle mit demselben Namen auf einem Server, ein Name wäre also nicht eindeutig.

Konfiguration im DockRay-Panel

Es gibt einen Bildschirm für das Konto und einen für Projekte: Einstellungen → Benachrichtigungskanäle, für ein einzelnes Projekt Projekteinstellungen → Benachrichtigungskanäle. Zum Bearbeiten ist die Berechtigung zur Projektverwaltung nötig - sie haben die Rolle developer und höher.

1. Aktiviere den Anbieter Discord und füge das Bot-Token ein.
2. Trage für jeden Ereignistyp die Kanal-ID ein - eine Folge aus 17 bis 20 Ziffern; jedes andere Format wird sofort abgelehnt.
3. Speichere. Ein leeres Token-Feld beim Speichern bedeutet 'das Gespeicherte behalten'.

Ein Projekt erbt die Kontokonfiguration standardmäßig und kann sie mit eigenem Bot und eigenen Kanälen überschreiben oder einen bestimmten Ereignistyp unabhängig von den Kontoeinstellungen abschalten.

Die Testnachricht

Bei jedem Ereignistyp gibt es eine Schaltfläche Test senden. Sie funktioniert erst, wenn das Token gespeichert oder gerade eingegeben ist und das Kanalfeld eine gültige ID enthält. Ein erfolgreicher Test bestätigt außerdem, dass der Bot im Zielkanal tatsächlich schreiben darf, nicht nur, dass das Token gültig ist.