Joomla

Plugin für Joomla 4, 5 und 6

Kostenlos in jedem Plan, auch im kostenlosen

Kostenlos starten Dokumentation

Woher nehmen

Im Erweiterungsverzeichnis ansehen

Joomla Extensions Directory

Voraussetzungen Joomla 4, 5 oder 6, PHP 8.2+

Paketname PLG_SYSTEM_DOCKRAY

Preise Kostenlos

Wozu es dient

Das offizielle DockRay-Plugin verbindet Joomla mit der Monitoring-Plattform und meldet automatisch unbehandelte Fehler und Ausnahmen. Probleme, die während des Betriebs von Joomla auftreten, 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 und Beschreibung des Fehlers,
Ort des Auftretens und Stack Trace,
Informationen über die Umgebung und Anwendungsversion,
Kontext der verarbeiteten Anfrage.

Das Plugin 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 Plugins → System - DockRay → Optionen, indem Sie den Projekt-Token und den privaten Schlüssel eingeben. Die Konfiguration kann alternativ auch über PHP-Konstanten in der Datei configuration.php definiert werden.

Datenschutz und Funktionen für Entwickler

Die Übermittlung von Daten des angemeldeten Benutzers, der IP-Adresse und des User-Agents ist optional. Dadurch lässt sich der Umfang der erfassten Informationen an die Anforderungen des Projekts und die geltenden Datenschutzrichtlinien anpassen.

Das Plugin ermöglicht außerdem die manuelle Meldung von Ausnahmen aus eigenem PHP-Code mithilfe des DockRay SDK.

Installation

Installation des Plugins

Gehen Sie zu System → Installieren → Erweiterungen.
Wählen Sie die Option Paketdatei hochladen.
Wählen Sie die Datei plg_system_dockray.zip aus und warten Sie, bis die Installation abgeschlossen ist.

Plugin aktivieren

Gehen Sie zu System → Plugins.
Suchen Sie nach System - DockRay und aktivieren Sie das Plugin.

Konfiguration

Öffnen Sie System - DockRay → Optionen.
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.

Nach erfolgreicher Konfiguration beginnt DockRay automatisch damit, unterstützte Fehler und Ausnahmen zu melden.

So wird es verwendet

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

php

<?php

use function Dock\Ray\captureException;

try {
    $model->save($data);
} catch (\Throwable $exception) {
    captureException($exception);

    throw $exception;
}