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 1|größeren Systems zum Sammeln, Aggregieren, Speichern und Analysieren von Nutzerdaten innerhalb der Grenzen, die in unserer 2|Datenschutzrichtlinie und 3|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).

Logging events using EventLogging

 * - to developing and deploying EventLogging schemas, and more
 * - tips and suggestions for developers writing code to log events

Developing the EventLogging extension


Entwickler-Einrichtung
As a developer, you will want to set up and use EventLogging on your development wiki to simulate its use in production.



Mit Docker
Siehe 



Mit mediawiki-vagrant
If you develop using mediawiki-vagrant, everything you need is encapsulated in the  role. To enable it, run:



Für JavaScript-Entwicklung
If working on the JavaScript client, you'll need to install dependencies with  from the folder you're developing in. Then you can use  to run ESLint for example. The "How to run tests" section below points out how to see JavaScript test results.

When adding the parameter  to the URL, the console in the browser's devtools will show the event logging being triggered.



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: