Руководство:Профилирование

This page is a translated version of the page Manual:Profiling and the translation is 17% complete.
Outdated translations are marked like this.

Профилирование отслеживает выполнение кода во время действия на странице и сообщает процент общего выполнения кода, затраченного на какую-либо конкретную функцию. Профилирование - это сложная задача, предназначенная для разработчиков и системных администраторов для отслеживания источников медлительности в MediaWiki, которые должны быть оптимизированы.

PHP профилирование

Вы можете использовать $XHProf, который доступен как для HHVM, так и для Zend PHP 5 и обеспечивает трассировку и профилирование. Вот как это делает остальной мир на PHP.

Tideways также рекламирует, казалось бы, собственный пользовательский интерфейс для визуализации результатов, но если вы будете следовать [$url инструкциям для работы без интерфейса], все будет хорошо.

Установка пакета Debian/Ubuntu php-tideways также включает в себя расширение PHP.

For XDebug, see XDebug profiling documentation. For command line scripts, you can use php -d xdebug.mode=profile maintenance/{script}. Webgrind can then be used to view profile results.

MediaWiki пользовательский профилировщик

The custom MediaWiki profiling calls (wfProfileIn/wfProfileOut) are deprecated, were no-ops since MediaWiki 1.25+, and were removed in 1.31.
Версия MediaWiki:
1.25

In MediaWiki 1.25 profiling was completely rewritten and many settings previous relating to profiling were removed in favor of consolidating them as parameters to $wgProfiler. Notably, output has been separated from class types. For documentation about profiling prior to 1.25, see an older version of this page.

Example $wgProfiler configuration:

<?php
$wgProfiler['class'] = 'ProfilerXhprof';
$wgProfiler['output'] = [ 'ProfilerOutputText' ];
$wgProfiler['visible'] = true;

Each of these parameters (and more) are described in detail:

class
'ProfilerXhprof'. ProfilerXhprof is new in MediaWiki 1.25 and provides an Xhprof-backed profiler that captures profiling data for all functions as well as sub-functional units. Old values such as ProfilerStandard, ProfilerUDP, ProfilerDB, etc do not work. Even if you are using Tideways, still specify the ProfilerXhprof class.
output
One or more of 'ProfilerOutputText', 'ProfilerOutputDump', 'ProfilerOutputStats'[1]. Text outputs the information in either HTML comments or after the skin. UDP is a format send to a udpprofile daemon. Dump produces a dump of the profiling info for use with xhprof GUI (xhprofgui role on Vagrant setup).
outputDir
Only applies to 'ProfilerOutputDump' format. Required to specify where the dump files will be stored.
visible
Only applies to 'ProfilerOutputText' format. Whether text is shown after the skin or in an HTML comment.

Maintenance scripts

Maintenance scripts support a --profiler option. This changes the output method of the profiler as well as ensuring its enabled in the CLI. Because this only changes the output method and not the profiler class, you still must have some sort of profiling setup in $wgProfiler.

Troubleshooting

If you get "Fatal error: Uncaught Exception: Neither xhprof nor tideways are installed" then you need to do:

$ sudo apt install php-tideways
$ sudo service apache2 restart

If you still get an error, then take a look at https://tideways.com/profiler/xhprof-for-php7

Output

Text output looks like:

100.00% 508.972      1 - main()
 96.67% 492.003      1 - MediaWiki::run
 96.61% 491.699      1 - MediaWiki::main
 87.12% 443.434      1 - MediaWiki::performRequest
 84.16% 428.356      1 - SpecialPageFactory::executePath
 84.11% 428.073      1 - SpecialPage::run
 84.10% 428.058      1 - SpecialRecentChanges::execute
 63.82% 324.838      1 - ChangesListSpecialPage::execute
 57.07% 290.495      1 - ChangesListSpecialPage::webOutput
 51.06% 259.877      1 - SpecialRecentChanges::outputChangesList
 44.72% 227.633    397 - Wikimedia\Rdbms\Database::query
 31.07% 158.155    922 - Message::fetchMessage
 30.61% 155.788    865 - MessageCache::get
 29.55% 150.398    398 - Wikimedia\Rdbms\Database::doProfiledQuery
 29.39% 149.570    865 - MessageCache::getMessageFromFallbackChain
 29.26% 148.923    869 - MessageCache::getMessageForLang
 29.06% 147.931    393 - Wikimedia\Rdbms\Database::select
 27.30% 138.962      1 - EnhancedChangesList::endRecentChangesList
 27.30% 138.960      1 - EnhancedChangesList::recentChangesBlock
...

The first column is the time percent; the second column is the time (in ms); the third column is the count; and the fourth column is the name of the method.

См. также

Сноски

Code steward