扩展:ApiFeatureUsage
ApiFeatureUsage 发行状态: 稳定版 |
|
---|---|
实现 | 特殊页面 , API |
描述 | Access API功能使用日志摘要 |
作者 | Brad Jorsch (Anomie留言) |
最新版本 | 1.0 (2016-12-07) |
兼容性政策 | 快照跟随MediaWiki发布。 master分支不向后兼容。 |
MediaWiki | 1.25+ |
PHP | 5.5.9+ |
数据库更改 | 否 |
许可协议 | GNU通用公眾授權條款2.0或更新版本 |
下載 | |
|
|
季度下載量 | 13 (Ranked 124th) |
正在使用的公开wiki数 | 847 (Ranked 303rd) |
翻译ApiFeatureUsage扩展 | |
問題 | 开启的任务 · 报告错误 |
ApiFeatureUsage 扩展添加了一个特殊页面和一个 API 模块来获取 ApiBase::logFeatureUsage() 记录的数据摘要,这通常表明使用了已弃用的 API 功能。
依赖性
日志数据必须添加到某种存储系统中。目前 Elasticsearch 通过 扩展:Elastica 获得支持。
安裝
- 下载文件,并将解压后的
ApiFeatureUsage
文件夹移动到extensions/
目录中。
开发者和代码贡献人员应从Git安装扩展,输入:cd extensions/
git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/ApiFeatureUsage - 将下列代码放置在您的LocalSettings.php 的底部:
wfLoadExtension( 'ApiFeatureUsage' );
- 完成 – 在您的wiki上导航至Special:Version,以验证已成功安装扩展。
配置
- Parameters
Name | Description |
---|---|
$wgApiFeatureUsageQueryEngineConf
|
Configuration array for accessing the log storage backend.
|
- 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
".
用法
该扩展添加了一个新的特殊页面 Special:ApiFeatureUsage,其中包含一个简单的表单来请求用户代理和日期范围内的功能使用日志摘要。
该扩展还添加了一个 API 查询子模块,meta=featureusage
。
有关详细信息,请参阅自动生成的 API 文档。
参见
此扩展用于一个或多个维基媒体项目。 这可能意味着扩展足够稳定、运作足够良好,可以用在这样的高流量的网站上。 请在维基媒体的CommonSettings.php和InitialiseSettings.php配置文件中查找此扩展的名称以查看哪些网站安装了该扩展。 特定wiki上的已安装的扩展的完整列表位于Special:Version页面。 |