Überprüfung und typische Probleme - WordPress

Das Testereignis

Du musst die Website nicht kaputt machen, um die Verbindung zu prüfen. Klicke unter Einstellungen → DockRay auf Testereignis senden: das Plugin sendet ein Ereignis synchron und zeigt das Ergebnis samt ID, ohne die Seite neu zu laden. Ein erfolgreicher Test wartet auf die Antwort 200 {"success": true}; Ergebnis und Zeitstempel bleiben als Status-Pille auf dem Bildschirm.

Das Ereignis sollte im Panel unter Fehler des Projekts erscheinen, auf das der Token zeigt. Prüfe dort gleich drei Dinge: Umgebung, Zeit und Anfragekontext. Eine leere Umgebung heißt, dass das Plugin weder einen Wert vom Bildschirm noch einen Umgebungstyp von WordPress bekommen hat.

Prüfung an einem echten Fehler

Der Test vom Bildschirm bestätigt die Verbindung, nicht aber das automatische Erfassen. Um auch das zu prüfen, löse in einer Staging-Umgebung eine unbehandelte Ausnahme aus - etwa aus einem temporären Shortcode oder aus einem init-Hook unter einer einzigen Adresse - und sieh nach, ob das Ereignis ankommt. Entferne diesen Code nach dem geglückten Test: jeder weitere Aufruf erhöht den Zähler eines künstlichen Fehlers und verbraucht das Monatskontingent.

Typische Probleme

Es kommt nichts im Panel an

Prüfe der Reihe nach: sind die Zugangsdaten vollständig (die Status-Pille antwortet direkt darauf), gehören Token und Schlüssel zum gleichen Projekt, wurde der Schlüssel im Panel widerrufen, und erlaubt der Hoster ausgehendes HTTPS. Das Plugin folgt keinen Weiterleitungen, die Adresse einer eigenen DockRay-Instanz muss also die endgültige sein und keine, die weiterleitet.

Ich habe einen Token eingetragen, das Plugin nutzt aber einen anderen

Meist steht in der wp-config.php ein DOCK_RAY_TOKEN oder DOCK_RAY_PRIVATE_KEY, während die Konfigurationsquelle auf Auto steht - dann gewinnt die Konstante. Der Statusbereich listet die aktiven Konstanten auf. Stelle die Quelle auf Nur dieser Bildschirm, wenn diese Website in ein anderes Projekt berichten soll als die gemeinsame Serverkonfiguration.

Ereignisse kommen an, aber ohne Stacktrace oder ohne Anfragekontext

Ein Ereignis aus einem Hook, den WP-CLI oder Cron ausgelöst hat, hat keine HTTP-Anfrage und damit auch keinen Anfragekontext - so ist es richtig. Ein fehlender Stack bei einem PHP-Fehler bedeutet dagegen, dass das Ereignis aus einem Fehler und nicht aus einer Ausnahme entstand; dort zeigen Datei und Zeile die Fehlerstelle.

Zu viele Notices und Deprecations

Eine Installation mit einem Dutzend Plugins kann hunderte pro Tag erzeugen und das Bedeutsame aus der Liste drängen. Enge DOCK_RAY_ERROR_TYPES in der wp-config.php auf die Stufen ein, auf die euer Team wirklich reagiert.

JavaScript-Fehler kommen nicht an

Der Kollektor ist standardmäßig aus - aktiviere JavaScript-Fehler sammeln im Einstellungsbildschirm. Kommt danach trotzdem nichts, denke an die drei Schranken des Empfängers: die Nonce, das Limit von 16 kB pro Meldung und 20 Meldungen pro IP-Adresse und Minute. Der Empfänger antwortet auch bei abgelehnter Meldung mit 202, der Antwortstatus in der Browserkonsole entscheidet also nichts.

Ein Fehler füllt die ganze Liste

Das ist meist eine einzige Ausnahme in einer Schleife oder im Cron. Das Panel gruppiert Fehler über den Fingerabdruck sha256(Projekt-Token + Typ + Meldung) und hält eine Zeile pro Fehler pro Tag, ein solcher Fall erscheint also als eine Zeile mit hohem Zähler. Zerfällt er dennoch in viele Zeilen, enthält die Meldung einen variablen Teil - eine Bestellnummer oder einen Zeitstempel - und genau der muss aus dem Ausnahmetext heraus.

Das Panel antwortet 200, aber es gibt kein Ereignis

Eine Antwort 200 {"success": false} bedeutet, dass das Konto sein monatliches Fehlerkontingent aufgebraucht hat. Die Integration behandelt das nicht als Störung - zu Recht. Das Kontingent siehst du im Konto-Dashboard; bis zum Monatsende wird es aus der erfassten Nutzung berechnet, Fehler zu löschen setzt es also nicht zurück.

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.