Kézikönyv:$wgDebugLogGroups

Debug: $wgDebugLogGroups
A $DebugLog egyes csoportokhoz tartozó kimenetét a $DebugLogFile-ban rögzítettől eltérő állományba irányítja.
Bevezetve:	1.5.0 (r10598)
Eltávolítva:	használatban
Megengedett értékek:	(fájlnevekre mutató naplózási csoportkulcsok tömbje)
Alapértelmezett érték:	[]
Egyéb beállítások: Betűrendben | Funkció szerint

Részletek

A változóban fájlnevekre mutató naplózási csoportkulcsok tömbjét lehet rögzíteni. Beállítása esetén a $DebugLog ezen csoporthoz tartozó kimenete a $DebugLogFile helyett a definiált állományba kerül. Hasznos a szelektív naplózás éles helyzetben való engedélyezéséhez.

If a group is configured in $wgDebugLogGroups, then all debug messages with the according group key will be logged to that file, also if $wgDebugLogFile is not set! With other words: If a group key is configured in $wgDebugLogGroups, messages will be written, even if an empty value of $wgDebugLogFile generally disables debugging.

A naplózási célértékek a következők lehetnek:

• „false” – az eredmény teljes törlése a kimenetről, a $wgDebugLogFile-ból is

• sztring – fájlnév vagy URI
• asszociatív tömb kulcsokkal:
  • destination - ** 'destination' –a kívánt fájlnév vagy URI
  • sample - ** 'sample' – pozitív egész szám, amely a mintavevő faktort határozza meg (opcionális)
  • level - ** 'level' – \Psr\Log\LogLevel-konstans, a napló legalacsonyabb szintjét jelöli (opcionális, az 1.25 óta)

Ha a $MWLoggerDefaultSpi beállítása nem az alapértelmezett érték, a $DebugLogGroups valószínűleg figyelmen kívül lesz hagyva, a naplófájlok konfigurálási módját pedig a $MWLoggerDefaultSpi által meghívott naplózási rendszer határozza meg.

Példa

A következő példában a „ConfirmEditExtension” hibakeresési üzeneteit a „debug-ext_confirmedit.log”, a „SpamRegex”-ét pedig a „debug-spam.log” tárolja.

$wgDebugLogGroups = [
	'ConfirmEditExtension'	=> $IP . '/../../home/debug-ext_confirmedit.log',
	'SpamRegex'		=> $IP . '/../../home/debug-spam.log',
];

Példa:

$wgDebugLogGroups['redis'] = '/var/log/mediawiki/redis.log';

Haladó példa:

 $wgDebugLogGroups['memcached'] = [
     'destination' => '/var/log/mediawiki/memcached.log',
     'sample' => 1000,  // minden ezredik üzenet naplózása
     'level' => \Psr\Log\LogLevel::WARNING,
 ];
 $wgDebugLogGroups['redis'] = [
     'destination' => '/var/log/mediawiki/redis.log',
     // a szint bármely Psr\Log\LogLevel–konstans sztringjének szó szerinti értéke lehet
     'level' => 'info',
 ];

Multiple log groups in a single file

You might want to setup a temporary configuration like the following to see all authentication related logging to trouble-shoot authentication.

$wgDebugLogGroups['cookie'] =
	$wgDebugLogGroups['session'] =
	$wgDebugLogGroups['SimpleSAMLphp'] =
	$wgDebugLogGroups['PluggableAuth'] = "$IP/cache/PluggableAuth.log";

Some common debug log groups

• exception, error, fatal - errors
• deprecated - deprecation warnings
• objectcache, caches, memcached/SQLBagOStuff - cache
• rdbms - adatbázis (including, if $wgDebugDumpSql is set, all DB queries)
• cookie - response cookies
• exec - shell commands
• session - SessionManager
• authentication, login - AuthManager
• ratelimit, throttler - hitting rate limits ($wgRateLimits and other)
• resourceloader, ResourceLoaderImage - ResourceLoader
• http, HttpError - HTTP requests to external services (via the Http/MwHttpRequest classes)
• api - API
• thumbnail, fileupload, fileconcatenate - image-related
• runJobs - Job queue
• parser, ParserCache - Parser
• slow-parse - warnings about pages that take long to parse

Other debug log groups

• squid
• localisation
• gitinfo
• UserOptionsManager
• Mime
• OldRevisionImporter
• MessageCache
• GlobalTitleFail
• DeferredUpdates
• ContentHandler
• BlockManager
• MediaHandlerFactory