Joomla

Wtyczka dla Joomla 4, 5 i 6

Dostępna bezpłatnie

Zacznij za darmo Dokumentacja

Skąd wziąć

Zobacz w katalogu rozszerzeń

Joomla Extensions Directory

Wymagania Joomla 4, 5 lub 6, PHP 8.2+

Nazwa paczki PLG_SYSTEM_DOCKRAY

Cennik Za darmo

Do czego to służy

Oficjalna wtyczka DockRay łączy Joomla z platformą monitoringu i automatycznie raportuje nieobsłużone błędy i wyjątki. Problemy pojawiające się podczas działania Joomla trafiają bezpośrednio do panelu DockRay wraz z informacjami potrzebnymi do ich analizy.

Informacje o błędach i wydajności

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

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

Wtyczka może również monitorować czas obsługi żądań HTTP oraz opcjonalnie zbierać błędy JavaScript występujące po stronie przeglądarki.

Prosta konfiguracja

Integrację skonfigurujesz w sekcji Wtyczki → System - DockRay → Opcje, podając token projektu i klucz prywatny. Konfigurację można również zdefiniować za pomocą stałych PHP w pliku configuration.php.

Prywatność i możliwości dla programistów

Przesyłanie danych zalogowanego użytkownika, adresu IP i user agenta jest opcjonalne. Pozwala to dopasować zakres zbieranych informacji do potrzeb projektu i przyjętej polityki prywatności.

Wtyczka pozwala również ręcznie raportować wyjątki z własnego kodu PHP za pomocą SDK DockRay.

Instalacja

Instalacja wtyczki

Przejdź do System → Instaluj → Rozszerzenia.
Wybierz opcję Prześlij plik pakietu.
Wskaż plik plg_system_dockray.zip i poczekaj na zakończenie instalacji.

Włączenie wtyczki

Przejdź do System → Wtyczki.
Wyszukaj System - DockRay i włącz wtyczkę.

Konfiguracja

Otwórz System - DockRay → Opcje.
Wprowadź token projektu oraz klucz prywatny dostępne w panelu DockRay.
Zapisz konfigurację.
Kliknij Send a test event, aby sprawdzić połączenie z DockRay.

Po poprawnej konfiguracji DockRay automatycznie rozpocznie raportowanie obsługiwanych błędów i wyjątków.

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 {
    $model->save($data);
} catch (\Throwable $exception) {
    captureException($exception);

    throw $exception;
}