Instalacja - Drupal

Zanim zaczniesz, utwórz projekt w panelu DockRay. W jego ustawieniach znajdziesz token projektu - publiczny identyfikator, który wchodzi do adresu endpointu - a w zakładce Klucze API wygenerujesz klucz prywatny. Klucz jest pokazywany tylko raz, w momencie generowania: w bazie DockRay leży wyłącznie jego skrót. Jeżeli nie masz jeszcze projektu, zacznij od zakładania konta i pierwszego projektu.

Wymagania

• Drupal 10.2 lub nowszy albo Drupal 11,
• PHP 8.2 lub nowszy,
• możliwość wykonywania połączeń wychodzących HTTPS z serwera.

Instalacja

composer require drupal/dockray
drush en dock_ray

Nazwa maszynowa modułu to dock_ray - pod nią występuje w Drushu, w kluczach settings.php, w nazwie serwisu dock_ray.hub i w trasach /dock-ray/*.

Moduł można włączyć także z interfejsu: Rozszerz (/admin/modules) → zaznacz DockRay → Zainstaluj.

Poświadczenia w settings.php

Klucz prywatny jest sekretem, a wyeksportowana konfiguracja Drupala zwykle ląduje w repozytorium - dlatego poświadczenia trzymaj w settings.php, a nie w konfiguracji modułu:

$settings['dock_ray'] = [
  'token' => 'token-projektu',
  'private_key' => 'klucz-prywatny-projektu',
  'url' => 'https://dockray.io',
];

Ta sama tablica obsługuje wszystkie środowiska: każde ma własny settings.local.php albo własny plik ustawień, więc produkcja i staging raportują do osobnych projektów bez rozjeżdżania się wyeksportowanej konfiguracji.

Pierwszy test

1. Przejdź do Konfiguracja → Programowanie → DockRay (/admin/config/development/dock-ray).
2. Sprawdź obszar statusu: powinien pokazywać komplet poświadczeń.
3. Kliknij Wyślij zdarzenie testowe.

Włączenie modułu bez poświadczeń jest bezpieczne - bez tokenu i klucza nie wychodzi ani jedno żądanie.

Po instalacji

Przejdź do konfiguracji: tam ustawisz minimalny poziom logów zamienianych na zdarzenia, próbkowanie transakcji i - opcjonalnie - zbieranie błędów JavaScriptu ze stron nieadministracyjnych.