Laravel

Pakiet dla Laravela 10+

Oficjalna paczka DockRay integruje aplikacje Laravel z platformą monitoringu i umożliwia automatyczne raportowanie wyjątków oraz monitorowanie czasu obsługi żądań HTTP. Zdarzenia trafiają bezpośrednio do panelu DockRay wraz z informacjami potrzebnymi do szybkiej diagnostyki problemów.

Monitoring błędów i wyjątków

DockRay integruje się z mechanizmem raportowania wyjątków Laravel i pozwala automatycznie przesyłać błędy aplikacji do jednego panelu monitoringu.

Zgłoszone zdarzenia mogą zawierać między innymi:

typ i treść wyjątku,
miejsce wystąpienia i stos wywołań,
informacje o środowisku i wersji aplikacji,
kontekst obsługiwanego żądania.

Wybrane klasy wyjątków można wykluczyć z raportowania. DockRay respektuje również standardową konfigurację dontReport Laravel.

Monitoring wydajności

Paczka może monitorować czas obsługi żądań HTTP dla wybranych grup middleware, takich jak web i api. Transakcje są grupowane według wzorca trasy, dzięki czemu żądania do tej samej trasy są analizowane razem niezależnie od przekazanych identyfikatorów.

Częstotliwość zbierania danych o transakcjach można kontrolować za pomocą współczynnika próbkowania.

Kontekst użytkownika i prywatność

Opcjonalnie DockRay może dołączać do zdarzeń informacje o zalogowanym użytkowniku, takie jak identyfikator, adres e-mail i nazwa. Przesyłanie adresu IP oraz user agenta jest kontrolowane osobnym ustawieniem i domyślnie nie musi być włączone.

Kolejki i komendy Artisan

Błędy występujące w kolejkach i procesach konsolowych również mogą być raportowane do DockRay. Ponieważ działają one poza stosem middleware HTTP, nie generują transakcji wydajnościowych.

Bezpieczne raportowanie

Metody raportujące DockRay nie rzucają wyjątków, dzięki czemu chwilowa niedostępność platformy monitoringu nie zakłóca standardowej obsługi błędów aplikacji.

Instalacja

Instalacja paczki

Zainstaluj DockRay za pomocą Composer:

bash

composer require dockcodes/dock-ray-laravel

Następnie opublikuj plik konfiguracyjny:

bash

php artisan vendor:publish --tag=ray-config

Service Provider jest wykrywany automatycznie przez Laravel i nie wymaga ręcznej rejestracji.

Konfiguracja

Dodaj dane projektu DockRay do pliku .env:

RAY_TOKEN=project-token
RAY_PRIVATE_KEY=project-private-key
RAY_TRACES_SAMPLE_RATE=0.2

Token projektu oraz klucz prywatny znajdziesz w panelu DockRay. Bez ustawionych wartości RAY_TOKEN i RAY_PRIVATE_KEY paczka pozostaje nieaktywna i nie wysyła żadnych danych.

Pozostałe ustawienia integracji znajdują się w pliku config/ray.php.