Drupal

Moduł dla Drupala 10.2+ i 11

Dostępna bezpłatnie

Zacznij za darmo Dokumentacja

Skąd wziąć

Zobacz na Drupal.org

Drupal.org

Wymagania Drupal 10.2+ lub 11, PHP 8.2+

Nazwa paczki drupal/dockray

Cennik Za darmo

Do czego to służy

Oficjalny moduł DockRay łączy Drupal z platformą monitoringu i automatycznie raportuje błędy oraz wyjątki pojawiające się podczas działania aplikacji. Zdarzenia 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, treść i poziom błędu,
miejsce wystąpienia i stos wywołań,
informacje o środowisku i wersji aplikacji,
kontekst obsługiwanego żądania.

Moduł 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 Konfiguracja → Programowanie → DockRay, podając token projektu i klucz prywatny. Dane dostępowe można również przechowywać w pliku settings.php.

Możliwości dla programistów

DockRay automatycznie integruje się z systemem logowania Drupala. Możesz również ręcznie raportować przechwycone wyjątki oraz wysyłać komunikaty za pomocą standardowego loggera Drupala.

Zdarzenia są wysyłane w tle po przygotowaniu odpowiedzi, dzięki czemu chwilowo niedostępna usługa monitoringu nie opóźnia odpowiedzi strony dla użytkownika.

Instalacja

W katalogu projektu Drupal zainstaluj moduł za pomocą Composer:
bash
```
composer require drupal/dockray
```
Włącz moduł za pomocą Drush:
```
drush en dock_ray
```

Konfiguracja

Przejdź do Konfiguracja → Programowanie → DockRay.
Wprowadź token projektu oraz klucz prywatny dostępne w panelu DockRay.
Zapisz konfigurację.
Kliknij Send a test event, aby sprawdzić połączenie z DockRay.

Klucz prywatny można również przechowywać w pliku settings.php, dzięki czemu nie musi być zapisany w konfiguracji eksportowanej do repozytorium.

Jak tego użyć

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

php

<?php

try {
    $this->import();
} catch (\Throwable $exception) {
    \Drupal::service('dock_ray.hub')->captureException($exception);

    throw $exception;
}