Instalacja - Symfony

Zanim zaczniesz, utwórz projekt w panelu DockRay. W jego ustawieniach znajdziesz token projektu - publiczny identyfikator, który wchodzi do adresu endpointu - a w zakładce Klucze API wygenerujesz klucz prywatny. Klucz jest pokazywany tylko raz, w momencie generowania: w bazie DockRay leży wyłącznie jego skrót. Jeżeli nie masz jeszcze projektu, zacznij od zakładania konta i pierwszego projektu.

Wymagania

• Symfony 6.4 lub nowszy,
• PHP 8.2 lub nowszy,
• Composer 2.

Instalacja paczki

composer require dockcodes/dock-ray-symfony

Z Symfony Flex bundle rejestruje się sam. Bez Flexa dopisz go ręcznie w config/bundles.php:

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

Konfiguracja

Utwórz config/packages/ray.yaml. Każdy klucz jest opcjonalny; bez tokenu i klucza prywatnego bundle ładuje się i nie wysyła niczego.

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

Poświadczenia trzymaj w .env.local albo w sekretach Symfony, nie w pliku konfiguracyjnym:

RAY_TOKEN=token-projektu
RAY_PRIVATE_KEY=klucz-prywatny-projektu

Od razu dopisz NotFoundHttpException

W Symfony odpowiedź 404 jest wyjątkiem, więc bez tej jednej pozycji w ignore_exceptions monitoring zapełni się zgłoszeniami od skanerów i literówek w adresach. To najczęstsza rzecz pomijana przy pierwszej konfiguracji.

Pierwszy test

Hub jest publicznym serwisem, więc najprościej z konsoli - wywołanie idzie tą samą drogą co raportowanie z aplikacji:

php bin/console debug:container ray.hub

Jeśli serwis istnieje, wywołaj captureMessage() z dowolnej komendy albo kontrolera i sprawdź panel.