Test und Problembehebung - Slack
Die Testnachricht
Bei jedem Ereignistyp steht eine Schaltfläche Test senden. Sie postet eine Beispielnachricht mit Projektname, Ereignistyp und Erkennungszeitpunkt - auf demselben Weg und im selben Format wie ein echter Alert. Der Test braucht alles vorhanden: ein gespeichertes oder gerade eingegebenes Token und einen gewählten Kanal. Fehlt eines von beidem, endet es mit einem Hinweis auf eine unvollständige Konfiguration, bevor DockRay überhaupt versucht, Slack zu erreichen.
Typische Probleme
Der Test schlägt fehl, obwohl das Token richtig aussieht
Die häufigste Ursache ist ein Bot, der nie in den Zielkanal eingeladen wurde. Das Token authentifiziert die App, aber Slack prüft trotzdem, ob diese App Mitglied des Kanals ist, bevor es ihr erlaubt, dort etwas zu posten. Lade den Bot mit /invite @bot-name in den Zielkanal ein und versuche es erneut.
DockRay lehnt das Token beim Speichern ab
Die Validierung verlangt das Präfix xoxb-. Ein Benutzer-Token (xoxp-) oder ein Signing-Token (xoxs-) sieht ähnlich aus, ist aber kein Bot-Token - Slack stellt bei einer App-Installation mehrere verschiedene Tokens aus, und das DockRay-Formular akzeptiert nur dieses eine.
Die Konfiguration ist gespeichert, Benachrichtigungen kommen trotzdem nicht an
Prüfe das Routing für den betreffenden Ereignistyp - es kann auf nicht senden stehen, oder das Projekt hat die Vererbung vom Konto ausdrücklich überschrieben. Es lohnt sich auch zu prüfen, ob das Ereignis überhaupt eingetreten ist: issue feuert nur beim ersten Auftreten eines neuen Fehlers, nicht bei jeder Wiederholung.
Der Plattformkanal funktioniert nicht für ein Abonnentenkonto
Das ist Absicht, kein Fehler. Die Konfiguration ohne zugeordnetes Konto bedient ausschließlich Docks interne Projekte - ein Abonnent nutzt sie nie, selbst wenn er den Kanalnamen kennt.
Ein plötzlicher Fehleranstieg löst keine Benachrichtigung aus
Das Kriterium für error-spike sind zwei Bedingungen gleichzeitig: eine Mindestzahl an Ereignissen im Zeitfenster und ein ausreichendes Vielfaches des normalen Verkehrs genau dieses Projekts. Ein stilles Projekt, das anfängt, vereinzelte Fehler zu werfen, erreicht die Ereigniszahl-Schwelle womöglich nicht, selbst bei einem echten prozentualen Sprung. Außerdem wird dieser Alert-Typ für dasselbe Projekt höchstens einmal alle paar Stunden verschickt - eine Wiederholung im selben Fenster 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.