Extension:EventLogging/ja

EventLogging拡張機能は、ユーザーがどのようにMediaWikiサイトを操作しているかについて、構造化されたデータを収集することを可能にします.

特徴

 * EventLoggingは、JavaScriptによるクライアントサイドロギングと、PHPによるサーバーサイドロギングをサポートしています.
 * ログの動作はを使って動的に設定できます.
 * イベントは、スキーマのgitリポジトリに格納されているバージョン管理されたJSONSchemasによって定義されたJSONオブジェクトです.
 * この拡張機能には、これらのイベントを転送、解析、またはロードするためのバックエンドコードは一切含まれていません. 別のサービスであるEventGateは、この機能を実装し、Kafkaにイベントを挿入する処理を行います.  イベントは、様々な取り込みパイプラインを介して、下流のデータストア（Hiveなど）に永続化されます.  これらのコンポーネントの詳細は、ウィキメディア財団の構成に固有のものです.



ウィキメディアでのEventLogging
ウィキメディア財団は、利用者データを収集、集約、保存、分析するための広範なシステムの一部として、プライバシーポリシーとデータ保持ガイドラインで定められた範囲内で、EventLogging拡張機能を使用しています.

このページでは、EventLogging拡張機能の一般的な使い方について説明します. ウィキメディア財団では、WMF専用のバックエンドコンポーネントとschema repositoriesでEventLoggingを使用しています. ウィキメディア特有の維持されている文書については、Analytics/Systems/EventLoggingとEvent Platformを参照してください.

Configuring the schema location
By default, the extension will look for schemas on Meta-Wiki. The relevant default settings are:

To use local schemas, or schemas from the central wiki of your own wikifarm, you need to override these. E.g. to use the  namespace of the local wiki, set

(and ensure the user account that will create the schemas is autoconfirmed).



EventLoggingでイベントを記録する

 * - EventLoggingスキーマの開発・導入など、様々な活動を行っています.
 * - イベントを記録するコードを書く開発者のためのヒントと提案



EventLogging拡張機能の開発


開発者向け注記
開発者であれば、開発用のWikiでEventLoggingを設定して使用し、本番での使用をシミュレートしたいと思うでしょう.



Dockerの使用
 を参照



mediawiki-vagrantを使用
mediawiki-vagrantを使って開発する場合、必要なものはすべて ロールにまとめられています. 有効にするには、次のように実行します.



JavaScript開発のために
JavaScriptクライアントで作業する場合は、開発しているフォルダから で依存関係をインストールする必要があります. そうすると、例えば をリントに使えます. 下記の「テストの実行方法」では、JavaScriptのテスト結果を確認する方法を紹介しています.

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



テストの実行方法
PHPテスト、Pythonテスト、JavaScriptテストがあります.

JavaScriptのテストを実行するには、開発wikiの「Special:JavaScriptTest/qunit」をご覧ください. (を参照)

PHPのテストを実行するには、PHPUnitを使用します. インストールされていることを確認してから