Installation - Drupal

Erstelle zuerst ein Projekt im DockRay-Panel. In seinen Einstellungen findest du den Projekt-Token - die öffentliche Kennung, die in die Ingest-URL eingeht - und im Tab API-Schlüssel erzeugst du einen privaten Schlüssel. Der Schlüssel wird nur einmal angezeigt, beim Erzeugen: DockRay speichert lediglich seinen Hash. Wenn noch kein Projekt existiert, beginne mit Erste Schritte.

Voraussetzungen

• Drupal 10.2 oder neuer bzw. Drupal 11,
• PHP 8.2 oder neuer,
• ausgehende HTTPS-Verbindungen vom Server erlaubt.

Installation

composer require drupal/dockray
drush en dock_ray

Der Maschinenname des Moduls ist dock_ray - so erscheint es in Drush, in den Schlüsseln der settings.php, im Servicenamen dock_ray.hub und in den Routen /dock-ray/*.

Du kannst es auch über die Oberfläche aktivieren: Erweitern (/admin/modules) → DockRay markieren → Installieren.

Zugangsdaten in der settings.php

Der private Schlüssel ist ein Geheimnis, und exportierte Drupal-Konfiguration landet meist im Repository - halte die Zugangsdaten daher in der settings.php statt in der Modulkonfiguration:

$settings['dock_ray'] = [
  'token' => 'projekt-token',
  'private_key' => 'privater-projektschluessel',
  'url' => 'https://dockray.io',
];

Dieselbe Struktur deckt jede Umgebung ab: jede hat ihre eigene settings.local.php oder eigene Settings-Datei, Produktion und Staging berichten also in getrennte Projekte, ohne dass die exportierte Konfiguration auseinanderläuft.

Der erste Test

1. Gehe zu Konfiguration → Entwicklung → DockRay (/admin/config/development/dock-ray).
2. Prüfe den Statusbereich: er sollte vollständige Zugangsdaten anzeigen.
3. Klicke auf Testereignis senden.

Das Modul ohne Zugangsdaten zu aktivieren ist unbedenklich - ohne Token und Schlüssel geht keine einzige Anfrage hinaus.

Nach der Installation

Gehe weiter zur Konfiguration: dort legst du die minimale Log-Stufe fest, die zu Ereignissen wird, die Transaktions-Stichprobenrate und - optional - das Sammeln von JavaScript-Fehlern auf Nicht-Admin-Seiten.