Test und Problembehebung - Mattermost
Die Testnachricht
Bei jedem Ereignistyp steht eine Schaltfläche Test senden. Sie postet eine Beispielnachricht mit Projektname, Ereignistyp und Erkennungszeitpunkt - auf demselben Weg wie ein echter Alert. Der Test braucht eine gespeicherte oder gerade eingegebene Webhook-Adresse und einen gewählten Kanal. Fehlt eines von beidem, endet es mit einem Hinweis auf eine unvollständige Konfiguration, bevor DockRay überhaupt versucht, die Anfrage zu senden.
Typische Probleme
DockRay lehnt die Adresse beim Speichern ab
Die Adresse muss öffentliches HTTPS sein, ohne Benutzernamen oder Passwort direkt in der Adresse, und der Hostname muss auf eine öffentliche IP-Adresse auflösen. Eine HTTP-Adresse, eine interne (etwa ein Mattermost-Server hinter einer privaten IP ohne öffentlichen Proxy) oder ein Tippfehler in der Domain enden alle in derselben Meldung - das ist eine einzige, gemeinsame Regel für jedes Feld dieser Art im Panel, keine Mattermost-spezifische Prüfung.
Der Test läuft durch, echte Alerts kommen aber nicht an
Prüfe das Routing für diesen Ereignistyp - es kann auf 'nicht senden' stehen, oder das Projekt hat die Vererbung vom Konto ausdrücklich nur mit einem Kanal überschrieben, ohne den Versand einzuschalten. Es lohnt sich auch zu prüfen, ob das Ereignis überhaupt eingetreten ist: issue feuert nur beim ersten Auftreten eines neuen Fehlers.
Der Webhook funktionierte, schweigt aber seit einiger Zeit
Jemand hat den Webhook möglicherweise auf Mattermost-Seite gelöscht - etwa beim Aufräumen der Server-Integrationen oder nach einem Wechsel der Kanaladministration. DockRay hat keine Möglichkeit, das von selbst zu erfahren: Ein gelöschter Webhook antwortet einfach nicht mehr. Lege einen neuen an und trage ihn anstelle des alten ein.
Die Nachricht landet in einem anderen Kanal als erwartet
Mattermost lässt einen Webhook in einen anderen Kanal posten als den, für den er erstellt wurde, wenn DockRay den Kanal ausdrücklich in der Anfrage angibt. Ist das Kanalfeld im Routing leer, geht die Nachricht an den Standardkanal des Webhooks - also den, für den er erstellt wurde, nicht den, der vom Namen der Integration her 'naheliegend' wirkte.
Ein plötzlicher Fehleranstieg löst keine Benachrichtigung aus
Das Kriterium für error-spike verlangt gleichzeitig eine Mindestzahl an Ereignissen im Zeitfenster und ein ausreichendes Vielfaches des normalen Verkehrs dieses Projekts, und dieser Alert-Typ wird für dasselbe Projekt höchstens einmal alle paar Stunden verschickt - eine zweite Welle im selben Zeitfenster wird absichtlich unterdrückt.
Es funktioniert weiterhin nicht
Arbeite die Checkliste zur Fehlerbehebung durch, und wenn das nicht hilft, schreib uns. Nenne den Projektnamen, die Version der Integration und ungefähr die Uhrzeit des Tests: das verkürzt den Weg zur Antwort.