Laravel

Pakiet dla Laravela 10+

Dostępna bezpłatnie

Zacznij za darmo Dokumentacja

Skąd wziąć

Zobacz na Packagiście

Packagist

Wymagania Laravel 10+, PHP 8.2+

Nazwa paczki dockcodes/dock-ray-laravel

Cennik Za darmo

Do czego to służy

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.

Jak tego użyć

Wyjątki integracja raportuje sama. To jest do zgłoszeń, które chcesz wysłać świadomie.

php

<?php

use Dock\Ray\Laravel\Ray;
use Illuminate\Foundation\Configuration\Exceptions;

->withExceptions(function (Exceptions $exceptions) {
    $exceptions->reportable( fn (Throwable $exception) => Ray::report($exception) );
})