Überprüfung und typische Probleme - Laravel

Ein kontrolliertes Testereignis

php artisan tinker --execute="\Dock\Ray\Laravel\Ray::message('DockRay-Kontrollmeldung');"

Die Meldung sollte im Panel unter Fehler des Projekts erscheinen, auf das der Token zeigt. Prüfe Umgebung und Zeit: die Umgebung kommt aus RAY_ENVIRONMENT, andernfalls aus APP_ENV.

Um das automatische Erfassen zu prüfen, löse in einer Staging-Umgebung eine unbehandelte Ausnahme aus einer temporären Route aus. Entferne die Route nach dem geglückten Test - weitere Aufrufe erhöhen den Zähler eines künstlichen Fehlers und verbrauchen das Monatskontingent.

Typische Probleme

Es kommt nichts im Panel an

Prüfe der Reihe nach: sind RAY_TOKEN und RAY_PRIVATE_KEY gesetzt und gehören zum gleichen Projekt, wirkt noch ein veraltetes config:cache (nach Änderung der .env php artisan config:clear ausführen), wurde der Schlüssel im Panel widerrufen, und erlaubt der Server ausgehendes HTTPS.

Ausnahmen werden nicht gemeldet, obwohl der Test durchgeht

Meist fehlt der reportable()-Haken. Prüfe außerdem, ob die Ausnahme in ray.ignore_exceptions oder in Laravels eigener dontReport-Liste steht - ValidationException und HttpException werden standardmäßig übersprungen, und das ist beabsichtigt.

Transaktionen fehlen

Zwei unabhängige Ursachen: ray.traces_sample_rate bei 0, oder die Middleware TrackTransaction fehlt in der Gruppe. Token und Schlüssel allein schalten die Messung nicht ein.

Die Transaktionsliste ist in tausende Zeilen zerfallen

Eine Transaktion wird nach dem Routenmuster benannt, dieses Bild heißt also, dass die Route ohne Parameter deklariert ist - etwa in einer Schleife über Kennungen registriert oder von einem einzigen Route::any('{path}') bedient. Korrigiere die Routendefinition, nicht das Panel.

Queue-Fehler kommen an, aber ohne Transaktionen

So ist es gewollt: Queues und Artisan-Befehle laufen außerhalb des HTTP-Middleware-Stacks, sie melden Fehler und erzeugen keine Transaktionen.

Ein Queue-Worker übernimmt eine Konfigurationsänderung nicht

Der Hub ist ein Singleton für den ganzen Prozess, und ein Worker liest die Konfiguration beim Start. Starte die Worker nach einer Änderung der .env oder der config/ray.php neu (php artisan queue:restart).

Ein Fehler zerfällt in viele Einträge

Das Panel gruppiert über den Fingerabdruck sha256(Projekt-Token + Typ + Meldung). Eine Meldung mit eingesetzter Datensatz-ID zerlegt einen Fehler in tausend Zeilen. Verschiebe den variablen Teil in den Kontext oder in Tags.

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.