Extension:NavigationTiming

MediaWiki 拡張機能マニュアル

NavigationTiming リリースの状態: 安定
実装	Ajax
説明	Logs perceived latency measurements from client-side
作者	Patrick Reilly, Ori Livneh, Asher Feldman, Timo Tijhof, Ian Marlier
互換性の方針	MediaWiki とともにリリースされるスナップショット。 master には後方互換性がありません。
データベースの変更	いいえ
ライセンス	GNU 一般公衆利用許諾書 2.0 以降
ダウンロード	拡張機能をダウンロード Git [?]: リポジトリを参照 (GitHub) Gerrit コード レビュー Git コミット ログ Download source tarball README
パラメーター $wgNavigationTimingSamplingFactor $wgNavigationTimingCpuBenchmarkSamplingFactor
使用するフック BeforePageDisplay
四半期ごとのダウンロード数	5 (Ranked 109th)
使用中の公開ウィキ	846 (Ranked 308th)
translatewiki.net で翻訳を利用できる場合は、NavigationTiming 拡張機能の翻訳にご協力ください
問題点	未解決のタスク · バグを報告

The NavigationTiming extension measures perceived latency in browsers. The extension is named after the W3C Navigation Timing API in web browsers, but today collects metrics from several different browser APIs.

よくある質問

Scope

The extension collects anonimised information from a sample of page views. The collection uses JavaScript and thus is limited to pageviews that:

1. are from a modern browser, as defined by the Grade A capability check (90%+ of traffic).
2. have the Navigation Timing API, (98% of browser traffic in 2022, 95% in Nov 2017)
3. reach the "page loaded" event (99%+ of page loads).
4. are in the random sample (configurable).

How is the information used?

Infrastructure for navtiming at WMF.

Engineers at Wikimedia Foundation intend to use this data to assess the impact (positive and negative) of changes to application code and server configuration. Thus guiding on-going work on site performance.

Dependencies

• EventLogging

Installation

• ダウンロードして、ファイルをextensions/フォルダー内のNavigationTimingという名前のディレクトリ内に配置します。
  開発者とコード寄稿者は、上記の代わりに以下を使用してGitからインストールします:cd extensions/
git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/NavigationTiming
• 以下のコードを LocalSettings.php ファイルの末尾に追加します:

  wfLoadExtension( 'NavigationTiming' );
  $wgNavigationTimingSamplingFactor = 1;  // 100% (1 of every 1)
  

• 完了 – ウィキの「Special:Version」に移動して、拡張機能が正しくインストールされたことを確認します。

Further reading

About the data we collect:

• Explainer of navtiming metrics, Wikitech.
• Wikimedia Grafana: Navigation Timing dashboard, grafana.wikimedia.org
• Performance infrastructure, Wikitech.

About the Navigation Timing API in web browsers:

• Navigation Timing API, specification from the W3C.
• Annotated Timing object: simplified descriptions of the measurements.
• Measuring Page Load Speed with Navigation Timing, HTML5 Rocks.

Code stewardship

• 不明または未割り当て^{[‍メンテナーのページ]} が保守しています。
• 問題点追跡: Phabricator MediaWiki-extensions-NavigationTiming (問題点を報告)