PHP

Biblioteka dla aplikacji PHP

Dostępna bezpłatnie

Zacznij za darmo Dokumentacja

Skąd wziąć

Zobacz na Packagiście

Packagist

Wymagania PHP 8.2+ oraz Composer 2

Nazwa paczki dockcodes/dock-ray

Cennik Za darmo

Do czego to służy

Oficjalny DockRay PHP SDK pozwala zintegrować dowolną aplikację PHP z platformą monitoringu DockRay. Automatycznie raportuje nieobsłużone wyjątki i błędy PHP oraz umożliwia monitorowanie czasu obsługi żądań HTTP.

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

DockRay może automatycznie przechwytywać nieobsłużone wyjątki i błędy krytyczne oraz przesyłać je do panelu monitoringu.

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

typ i treść błędu lub wyjątku,
miejsce wystąpienia i stos wywołań,
informacje o środowisku i wersji aplikacji,
tagi, dane użytkownika i dodatkowy kontekst.

SDK pozwala również ręcznie raportować wyjątki i komunikaty oraz dodawać własne informacje diagnostyczne za pomocą tagów, danych użytkownika i breadcrumbs.

Monitoring wydajności

SDK umożliwia monitorowanie transakcji HTTP i czasu obsługi żądań. Częstotliwość zbierania danych można kontrolować za pomocą współczynnika próbkowania.

Monitoring błędów JavaScript

DockRay PHP SDK udostępnia również narzędzia do integracji monitoringu błędów JavaScript. Zdarzenia z przeglądarki są przekazywane przez aplikację PHP, dzięki czemu klucz prywatny projektu pozostaje po stronie serwera.

Stworzone dla aplikacji produkcyjnych

Domyślnie zdarzenia są kolejkowane podczas obsługi żądania i wysyłane po przygotowaniu odpowiedzi. Dzięki temu chwilowo niedostępna lub wolniejsza usługa monitoringu nie powinna opóźniać odpowiedzi aplikacji dla użytkownika.

Niezależne od frameworka

DockRay PHP SDK nie wymaga konkretnego frameworka i może być używany w dowolnej aplikacji PHP 8.2+. Stanowi również podstawę dedykowanych integracji DockRay dla popularnych frameworków i systemów CMS.

Instalacja

Zainstaluj DockRay PHP SDK za pomocą Composer:

bash

composer require dockcodes/dock-ray

Paczka wymaga PHP 8.2 lub nowszego.

Konfiguracja

Zainicjalizuj DockRay przy uruchamianiu aplikacji, podając token projektu i klucz prywatny:

php

use function Dock\Ray\init;

init([
    'token' => 'PROJECT_TOKEN',
    'private_key' => 'PROJECT_PRIVATE_KEY',
    'environment' => 'production',
    'release' => '1.4.0',
]);

Token projektu oraz klucz prywatny znajdziesz w panelu DockRay. Dane dostępowe można również przekazać za pomocą zmiennych serwerowych RAY_TOKEN i RAY_PRIVATE_KEY.

Jeśli token lub klucz prywatny nie zostaną skonfigurowane, SDK pozostanie nieaktywne i nie będzie wysyłać żadnych danych.

Jak tego użyć

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

php

<?php

use function Dock\Ray\captureException;

try {
    $order->settle();
} catch (\Throwable $exception) {
    captureException($exception);

    throw $exception;
}