Drupal

Modul für Drupal 10.2+ und 11

Kostenlos in jedem Plan, auch im kostenlosen

Kostenlos starten Dokumentation

Woher nehmen

Auf Drupal.org ansehen

Drupal.org

Voraussetzungen Drupal 10.2+ oder 11, PHP 8.2+

Paketname drupal/dockray

Preise Kostenlos

Wozu es dient

Das offizielle DockRay-Modul verbindet Drupal mit der Monitoring-Plattform und meldet automatisch Fehler und Ausnahmen, die während des Betriebs der Anwendung auftreten. Die Ereignisse werden zusammen mit den für die Analyse erforderlichen Informationen direkt an das DockRay-Dashboard übermittelt.

Informationen zu Fehlern und Performance

Gemeldete Ereignisse können unter anderem folgende Informationen enthalten:

Typ, Beschreibung und Schweregrad des Fehlers,
Ort des Auftretens und Stack Trace,
Informationen über die Umgebung und Anwendungsversion,
Kontext der verarbeiteten Anfrage.

Das Modul kann außerdem die Verarbeitungszeit von HTTP-Anfragen überwachen und optional JavaScript-Fehler erfassen, die im Browser auftreten.

Einfache Konfiguration

Die Integration konfigurieren Sie unter Konfiguration → Entwicklung → DockRay, indem Sie den Projekt-Token und den privaten Schlüssel eingeben. Die Zugangsdaten können alternativ auch in der Datei settings.php gespeichert werden.

Funktionen für Entwickler

DockRay integriert sich automatisch in das Logging-System von Drupal. Sie können außerdem abgefangene Ausnahmen manuell melden und Nachrichten über den standardmäßigen Drupal-Logger senden.

Ereignisse werden im Hintergrund gesendet, nachdem die Antwort vorbereitet wurde. Dadurch verzögert eine vorübergehende Nichtverfügbarkeit des Monitoring-Dienstes die Auslieferung der Website an den Benutzer nicht.

Installation

Installieren Sie das Modul im Verzeichnis Ihres Drupal-Projekts mit Composer:
bash
```
composer require drupal/dockray
```
Aktivieren Sie das Modul mit Drush:
```
drush en dock_ray
```

Konfiguration

Gehen Sie zu Konfiguration → Entwicklung → DockRay.
Geben Sie den im DockRay-Dashboard verfügbaren Projekt-Token und den privaten Schlüssel ein.
Speichern Sie die Konfiguration.
Klicken Sie auf Send a test event, um die Verbindung mit DockRay zu überprüfen.

Der private Schlüssel kann alternativ auch in der Datei settings.php gespeichert werden. Dadurch muss er nicht in der Konfiguration hinterlegt werden, die in das Repository exportiert wird.

So wird es verwendet

Ausnahmen meldet die Integration von selbst. Das hier ist für Meldungen, die Sie bewusst senden.

php

<?php

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

    throw $exception;
}