Extension:EventLogging/de

Die EventLogging-Erweiterung ermöglicht es, strukturierte Daten darüber zu sammeln, wie Nutzer mit MediaWiki-Seiten interagieren.

Funktionen

 * EventLogging unterstützt Client-seitiges Logging von JavaScript und Server-seitiges Logging von PHP.
 * Das Logging-Verhalten kann mit dynamisch konfiguriert werden.
 * Die Ereignisse sind JSON-Objekte, die durch versionierte JSONSchemas definiert sind, die in einem Schema-Git-Repository gespeichert sind.
 * Die Erweiterung enthält keinen Back-End-Code für den Transport, das Parsing oder das Laden dieser Ereignisse. Ein separater Dienst, EventGate, implementiert diese Funktionalität und kümmert sich um das Einfügen von Ereignissen in Kafka. Die Ereignisse werden dann über verschiedene Ingestion-Pipelines in nachgelagerten Datenspeichern (z. B. Hive) persistiert. Die Details dieser Komponenten sind spezifisch für die Konfiguration der Wikimedia Foundation.



EventLogging bei Wikimedia
Die Wikimedia Foundation verwendet die EventLogging-Erweiterung als Teil eines größeren Systems zum Sammeln, Aggregieren, Speichern und Analysieren von Nutzerdaten innerhalb der Grenzen, die in unserer Datenschutzrichtlinie und Datenaufbewahrungsrichtlinie festgelegt sind.

Auf dieser Seite geht es um die allgemeine Verwendung der EventLogging-Erweiterung. Die Wikimedia Foundation verwendet EventLogging mit WMF-spezifischen Backend-Komponenten und. Für Wikimedia-spezifische und gepflegte Dokumentation, siehe Analytics/Systems/EventLogging und Event Platform.

Installation


Konfigurieren des Schemaspeicherorts
Standardmäßig sucht die Erweiterung nach Schemas auf Meta-Wiki. Die relevanten Standardeinstellungen sind:

Um lokale Schemas oder Schemas aus dem zentralen Wiki deiner eigenen wikifarm zu verwenden, musst du diese überschreiben. Um z.B. den -Namensraum des lokalen Wikis zu verwenden, setze

(und stelle sicher, dass das Benutzerkonto, das die Schemas erstellt, autoconfirmed ist).



Ereignisse protokollieren mit EventLogging

 * - zur Entwicklung und zum Einsatz von EventLogging-Schemata und mehr
 * - Tipps und Vorschläge für Entwickler, die Code zum Protokollieren von Ereignissen schreiben



Entwicklung der EventLogging-Erweiterung


Entwickler-Einrichtung
Als Entwickler möchtest du EventLogging auf deinem Entwicklungs-Wiki einrichten und verwenden, um den Einsatz in der Produktion zu simulieren.



Mit Docker
Siehe 



Mit mediawiki-vagrant
Wenn du mit mediawiki-vagrant entwickelst, ist alles, was du brauchst, in der -Rolle gekapselt. Um sie zu aktivieren, führe aus:



Für JavaScript-Entwicklung
Wenn du mit dem JavaScript-Client arbeitest, musst du die Abhängigkeiten mit  aus dem Ordner installieren, in dem du entwickelst. Dann kannst du  verwenden, um zum Beispiel ESLint auszuführen. Im Abschnitt "Wie führe ich Tests durch?" weiter unten erfährst du, wie du die Ergebnisse von JavaScript-Tests sehen kannst.

Wenn du den Parameter  zur URL hinzufügst, zeigt die Konsole in den Devtools des Browsers die ausgelöste Ereignisprotokollierung an.



Wie man Tests ausführt
Es gibt PHP-Tests, Python-Tests und JavaScript-Tests.

Um JavaScript-Tests auszuführen, besuche Special:JavaScriptTest/qunit auf deinem Entwicklungswiki. (Siehe .)

Um PHP-Tests auszuführen, verwenden wir PHPUnit. Stelle sicher, dass es installiert ist, dann: