Test und Problembehebung - Discord
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. Sie braucht ein gespeichertes oder gerade eingegebenes Bot-Token und eine gültige Kanal-ID. Fehlt eines von beidem, endet es mit einem Hinweis auf eine unvollständige Konfiguration, bevor DockRay überhaupt versucht, Discord zu erreichen.
Typische Probleme
Der Test scheitert an einem Berechtigungsfehler
Die häufigste Ursache ist ein fehlendes Recht Send Messages oder View Channel auf dem Zielkanal - die Rolle des Bots kann Rechte auf Serverebene haben, während der konkrete Kanal engere, überschreibende Rechte gesetzt hat. Prüfe die Berechtigungen des Kanals selbst, nicht nur die Rolle des Bots.
Die Nachricht kommt an, aber ohne Formatierung und Link
Das liegt am fehlenden Recht Embed Links. Ohne es lässt Discord noch reinen Text durch, verwirft aber den Inhalt, mit dem DockRay Titel, Farbe und einen zum Panel führenden Button sendet.
DockRay lehnt die Kanal-ID beim Speichern ab
Das Feld akzeptiert ausschließlich eine Folge aus 17 bis 20 Ziffern. Ein eingefügter Kanal-Link oder dessen Name besteht die Validierung nicht - kopiere die ID über Discords Entwicklermodus (Benutzereinstellungen → Erweitert → Entwicklermodus), dann Rechtsklick auf den Kanal → Kanal-ID kopieren.
Die Konfiguration ist gespeichert, Benachrichtigungen kommen trotzdem 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 überschrieben. Es lohnt sich auch zu prüfen, ob das Ereignis überhaupt eingetreten ist: issue feuert nur beim ersten Auftreten eines neuen Fehlers.
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.
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.