Extension:EventLogging/fr

L'extension EventLogging permet de collecter des données structurées sur la manière dont les utilisateurs interagisssent avec les sites MediaWiki.

Fonctionnalités

 * EventLogging prend en charge la connexion à partir du JavaScript côté client et du côté serveur à partir de PHP.
 * Le comportement de la connexion peut être configuré dynamiquement en utilisant.
 * Les événements sont des objets JSON définis par des schémas JSON versionnés (JSONSchemas) enregistrés dans dépôt Git de schémas.
 * L'extension n'inclut aucun code du serveur pour transporter, analyser ou charger ces événements. Un service séparé, EventGate, implémente cette fonction et gère l'insertion des événements dans Kafka. Les événements sont ensuite persistants dans les dépôts de données descendantes (comme Hive) via divers pipeline d'absorbsion. Les détails de ces composants sont spécifiques à la configuration de la Fondation Wikimedia.



EventLogging pour Wikimedia
La Fondation Wikimedia utilise l'extension EventLogging comme partie d'un système plus large de collecte, d'agrégation, d'enregistrement et d'analyse des données utilisateur à l'intérieur des limites fixées par notre politique de confidentialité et nos règles de conservation des données.

Cette page concerne l'utilisation générale de l'extension EventLogging. La Fondation Wikimedia utilise EventLogging avec des composants arrière spécifiques à la WMF ainsi que des dépôts de schémas. Pour la documentation spécifique à Wikimedia et la documentation maintenue, voir Analytics/Systems/EventLogging et Event Platform.

Installation


Configurer l'emplacement des schemas
Par défaut, l'extension cherche les schémas sur Meta-Wiki. Les paramètres par défaut significatifs sont :

Pour utiliser des schémas locaux, ou des schémas du wiki central de votre propre ferme de wikis, il faut réécrire ces lignes. Par exemple pour utiliser l'espace de noms  du wiki local, déclarez :

(et assurez-vous que le compte utilisateur qui va créer les schémas est autoconfirmé).



Tracer les événements avec EventLogging

 * - pour développer et déployer les schémas EventLogging, et plus
 * - conseils et suggestions pour les développeurs qui écrivent du code pour tracer les événements



Développer l'extension EventLogging


Configuration développeur
En tant que développeur, vous voudrez configurer et utiliser EventLogging sur votre wiki de développement pour simuler son utilisation en production.



Utiliser Docker
Voir 



Utiliser mediawiki-vagrant
Si vous développez avec mediawiki-vagrant, tout ce dont vous avez besoin est encapsulé dans le rôle. Pour l'activer, exécutez :



Pour les développements JavaScript
Si vous travaillez sur le client JavaScript, vous devrez installler les dépendances avec  à partir du dossier dans lequel vous développez. Puis vous pouvez utiliser  pour exécuter ESLint par exemple. La section « Comment exécuter les tests » ci-dessous montre comment voir le résultat des tests JavaScript.

Lorsque vous ajoutez le paramètre  à l'URL, la console des outils développeur du navigateur affiche l'événement tracé en cours de traitement.



Comment exécuter les tests
Il existe des tests PHP, Python, et JavaScript.

Pour exécuter les tests JavaScript, visitez Special:JavaScriptTest/qunit sur votre wiki de développement. (Voir ).

Pour exécuter les tests PHP, nous utilisons PHPUnit. Vérifiez qu'elle est installée, puis :