Einrichtung und Konfiguration - Slack

Was diese Integration verschickt

Die Slack-Integration ist eine Funktion des DockRay-Panels selbst, nicht etwas, das du bei deinen Kunden installierst. Der Benachrichtigungskanal postet in gewählte Slack-Kanäle, 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 eigenen Kanal gehen - Verfügbarkeitsstörungen in den Bereitschaftskanal, Leistungsdaten an die Person, die den Betrieb verantwortet.

Vorbereitung auf Seiten von Slack

1. Lege eine Slack-App in deinem Workspace an (api.slack.com/apps).
2. Füge unter OAuth & Permissions dem Bot den Scope chat:write hinzu.
3. Installiere die App im Workspace und kopiere das Bot User OAuth Token - es beginnt mit xoxb-.
4. Lade den Bot in die Kanäle ein, in denen Alerts erscheinen sollen: bei privaten Kanälen immer, bei öffentlichen ebenfalls, wenn der Bot ihnen nicht selbst beitreten kann.

DockRay lehnt ein Token ohne das Präfix xoxb- schon beim Speichern des Formulars ab - der häufigste Fehler an dieser Stelle ist, ein Benutzer-Token (xoxp-) oder ein Signing-Token (xoxs-) statt des Bot-Tokens einzufügen.

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 Slack und füge das Bot-Token ein.
2. Trage für jeden Ereignistyp einen Kanal ein - einen Namen (z. B. #alerts) oder eine Kanal-ID.
3. Speichere. Ein leeres Token-Feld beim Speichern bedeutet 'das Gespeicherte behalten' - das Zugangsdatum kommt nie im Klartext ins Formular zurück.

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

Die Testnachricht

Bei jedem Ereignistyp gibt es eine Schaltfläche Test senden. Sie postet eine Beispielnachricht genau auf dem Weg, den ein echter Alert nehmen würde - sie funktioniert erst, wenn alles vorhanden ist: ein gespeichertes oder gerade eingegebenes Token und ein gewählter Kanal. Der Test bestätigt also nicht nur, dass das Token gültig ist, sondern dass der Bot im Zielkanal tatsächlich sichtbar ist.