MediaWiki extensions manual

ApiFeatureUsage Release status: stableCategory:Stable extensions
Implementation	Special page Category:Special page extensions, API Category:API extensions
Description	Access API feature usage log summaries
Author(s)	Brad Jorsch (Anomietalk)
Latest version	1.0 (2016-12-07)
Compatibility policy	Snapshots releases along with MediaWiki. Master is not backward compatible.Category:Extensions with release branches compatibility policy
MediaWiki	1.25+Category:Extensions with manual MediaWiki version
PHP	5.5.9+
Database changes	No
License	GNU General Public License 2.0 or later
Download	Download extension Git [?]: Browse repository (GitHub) Gerrit code review Git commit log Download source tarball Category:Extensions in Wikimedia version control
Parameters $wgApiFeatureUsageQueryEngineConf
Hooks used ApiDeprecationHelp Category:ApiDeprecationHelp extensions ApiLogFeatureUsage Category:ApiLogFeatureUsage extensions LoadExtensionSchemaUpdates Category:LoadExtensionSchemaUpdates extensions
Quarterly downloads	3 (Ranked 93rd)
Public wikis using	847 (Ranked 302nd)
Translate the ApiFeatureUsage extension
Issues	Open tasks · Report a bug

The ApiFeatureUsage extension adds a special page and an API module to fetch summaries of data logged by ApiBase::logFeatureUsage(), which is typically an indication of use of deprecated API features.

Dependencies

Log data must be added to some sort of storage system. Currently Elasticsearch is supported via Extension:Elastica .

Installation

• Download and move the extracted ApiFeatureUsage folder to your extensions/ directory.
  Developers and code contributors should install the extension from Git instead, using:cd extensions/
git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/ApiFeatureUsage
• Add the following code at the bottom of your LocalSettings.php file:

  wfLoadExtension( 'ApiFeatureUsage' );
  

• Done – Navigate to Special:Version on your wiki to verify that the extension is successfully installed.

Configuration

Parameters

Elastica backend (ApiFeatureUsageQueryEngineElastica)

Additional configuration values in $wgApiFeatureUsageQueryEngineConf:

serverList

Array of Elasticsearch servers. Required.

maxConnectionAttempts

Maximum connection attempts, default 1.

indexPrefix

Prefix for the indexes to use. Default "apifeatureusage-".

indexFormat

Date formatting for the indexes to use, see the PHP manual. Default "Y.m.d".

type

Elasticsearch type to query. Default "api-feature-usage-sanitized".

featureField

Field name for the logged value of $feature. Default "feature".

timestampField

Field name for the logged timestamp. Default "@timestamp".

agentField

Field name for the logged user agent. Default "agent".

Usage

The extension adds a new special page, Special:ApiFeatureUsage, with a simple form to request a summary of feature usage logs for a user agent and date range.

The extension also adds an API query submodule, meta=featureusage. See the auto-generated API documentation for details.

See also

• Extension:Elastica

This extension is being used on one or more Wikimedia projects. This probably means that the extension is stable and works well enough to be used by such high-traffic websites. Look for this extension's name in Wikimedia's CommonSettings.php and InitialiseSettings.php configuration files to see where it's installed. A full list of the extensions installed on a particular wiki can be seen on the wiki's Special:Version page.