Einrichtung und Konfiguration - Mattermost
Was diese Integration verschickt
Die Mattermost-Integration ist eine Funktion des DockRay-Panels - der Benachrichtigungskanal postet in einen gewählten Mattermost-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 gehen.
Vorbereitung in Mattermost
- Bitte den Mattermost-Serveradministrator, Incoming Webhooks zu aktivieren, falls das noch nicht geschehen ist.
- Lege einen neuen eingehenden Webhook für den Kanal an, in dem Alerts erscheinen sollen.
- Kopiere die erzeugte Adresse - eine vollständige HTTPS-URL, die mit einer zufälligen Kennung endet.
Die Webhook-Adresse muss öffentliches HTTPS sein - sonst weist DockRay sie schon beim Speichern zurück. Das ist keine Mattermost-Besonderheit, sondern eine Bedingung, die DockRay an jede im Panel eingegebene Adresse stellt - siehe den Abschnitt zur Validierung im nächsten Artikel.
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.
- Aktiviere den Anbieter Mattermost und füge die Webhook-Adresse ein.
- Trage für jeden Ereignistyp einen Kanalnamen ein - Mattermost lässt einen Webhook auch in einen anderen Kanal posten als den, für den er erstellt wurde, wenn dieser ausdrücklich angegeben wird.
- Speichere. Ein leeres Adressfeld beim Speichern bedeutet 'das Gespeicherte behalten' - das Zugangsdatum kommt nie im Klartext ins Formular zurück.
Ein Projekt erbt die Kontokonfiguration standardmäßig und kann sie mit einem eigenen Webhook überschreiben oder einen bestimmten Ereignistyp unabhängig von den Kontoeinstellungen 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 die Webhook-Adresse gespeichert oder gerade eingegeben ist und ein Kanal feststeht. Ein erfolgreicher Test bestätigt, dass die Adresse auf Mattermost-Seite noch aktiv ist - Webhooks werden beim Aufräumen von Integrationen gern mitgelöscht.