Installation - Symfony

Erstelle zuerst ein Projekt im DockRay-Panel. In seinen Einstellungen findest du den Projekt-Token - die öffentliche Kennung, die in die Ingest-URL eingeht - und im Tab API-Schlüssel erzeugst du einen privaten Schlüssel. Der Schlüssel wird nur einmal angezeigt, beim Erzeugen: DockRay speichert lediglich seinen Hash. Wenn noch kein Projekt existiert, beginne mit Erste Schritte.

Voraussetzungen

• Symfony 6.4 oder neuer,
• PHP 8.2 oder neuer,
• Composer 2.

Paket installieren

composer require dockcodes/dock-ray-symfony

Mit Symfony Flex registriert sich das Bundle selbst. Ohne Flex trage es in config/bundles.php ein:

return [
    // ...
    Dock\Ray\Symfony\RayBundle::class => ['all' => true],
];

Konfiguration

Erstelle config/packages/ray.yaml. Jeder Schlüssel ist optional; ohne Token und privaten Schlüssel lädt das Bundle und sendet nichts.

ray:
    token: '%env(RAY_TOKEN)%'
    private_key: '%env(RAY_PRIVATE_KEY)%'
    traces_sample_rate: 0.2
    ignore_exceptions:
        - Symfony\Component\HttpKernel\Exception\NotFoundHttpException

Bewahre die Zugangsdaten in der .env.local oder in Symfony Secrets auf, nicht in der Konfigurationsdatei:

RAY_TOKEN=projekt-token
RAY_PRIVATE_KEY=privater-projektschluessel

NotFoundHttpException gleich eintragen

In Symfony ist eine 404-Antwort eine Ausnahme; ohne diesen einen Eintrag in ignore_exceptions füllt sich das Monitoring mit Meldungen von Scannern und Adress-Tippfehlern. Das ist der am häufigsten übersehene Schritt bei der ersten Konfiguration.

Der erste Test

Der Hub ist ein öffentlicher Service, die Konsole ist also der einfachste Weg - der Aufruf nimmt denselben Weg wie das Melden aus der Anwendung:

php bin/console debug:container ray.hub

Existiert der Service, rufe captureMessage() aus einem beliebigen Befehl oder Controller auf und prüfe das Panel.