Příručka:$wgDebugLogGroups

Ladění: $wgDebugLogGroups
Přímý výstup wfDebugLog() pro určité skupiny do souborů jiných než $wgDebugLogFile .
Zavedeno od verze:	1.5.0 (r10598)
Odstraněno od verze:	stále se používá
Povolené hodnoty:	(pole klíčů skupiny protokolů k názvům souborů)
Výchozí hodnota:	[]
Další nastavení: Podle abecedy | Podle funkce

Podrobnosti

Nastaví pole klíčů skupiny protokolů na názvy souborů. Je-li nastaveno, výstup wfDebugLog() pro tuto skupinu půjde do tohoto souboru místo běžných $wgDebugLogFile . Užitečné pro umožnění selektivního protokolování ve výrobě.

Pokud je skupina nakonfigurována v $wgDebugLogGroups, pak všechny ladicí zprávy s odpovídajícím skupinovým klíčem budou protokolovány do tohoto souboru, také, pokud je $wgDebugLogFile nastaveno ne! Jinými slovy: Pokud je skupinový klíč nakonfigurován v $wgDebugLogGroups, zprávy budou zapsány, i když prázdná hodnota $wgDebugLogFile obecně zakáže ladění.

Cíle protokolu mohou být jedno z následujících:

• false pro úplné odstranění z výstupu, včetně z $wgDebugLogFile.
• řetězcové hodnoty určující název souboru nebo URI.
• asociativní pole s klíči:
  • destination - požadovaný název souboru nebo URI.
  • sample - celočíselná hodnota, která určuje vzorkovací faktor (volitelné)
  • level - konstanta \Psr\Log\LogLevel, udávající minimální úrovně (volitelné, od 1.25)

Když je $wgMWLoggerDefaultSpi nastaveno na jinou než výchozí hodnotu, $wgDebugLogGroups bude pravděpodobně ignorováno a metoda konfigurace souborů protokolu bude určena jakýmkoli protokolovacím systémem vyvolaným $wgMWLoggerDefaultSpi.

Příklad

Tento příklad zaznamenává zprávy ladění skupiny "ConfirmEditExtension" do "debug-ext_confirmedit.log" a zprávy skupiny "SpamRegex" do "debug-spam.log".

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

Příklad:

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

Pokročilý příklad:

 $wgDebugLogGroups['memcached'] = [
     'destination' => '/var/log/mediawiki/memcached.log',
     'sample' => 1000,  // odhlásit 1 zprávu z každých 1 000.
     'level' => \Psr\Log\LogLevel::WARNING,
 ];
 $wgDebugLogGroups['redis'] = [
     'destination' => '/var/log/mediawiki/redis.log',
     // Úroveň může být také doslovná řetězcová hodnota libovolné konstanty Psr\Log\LogLevel
     'level' => 'info',
 ];

Více skupin protokolů v jednom souboru

Možná budete chtít nastavit dočasnou konfiguraci, jako je následující, abyste viděli všechny protokoly související s ověřováním za účelem odstraňování problémů s ověřováním.

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

Některé běžné skupiny protokolů ladění

• exception, error, fatal, silenced-error - chyby
• deprecated - upozornění na ukončení podpory
• objectcache, caches, memcached/SQLBagOStuff - mezipaměť
• rdbms - databáze (včetně všech dotazů k databázi, pokud je nastavena hodnota $wgDebugDumpSql )
• cookie - cookies odpovědí
• exec - příkazy shellu
• session - SessionManager
• authentication, login - AuthManager
• ratelimit, throttler - dosažení limitů sazeb ($wgRateLimits a další)
• resourceloader, ResourceLoaderImage - ResourceLoader
• http, HttpError - HTTP požadavky na externí služby (prostřednictvím tříd Http/MwHttpRequest)
• api - API
• thumbnail, fileupload, fileconcatenate - související s obrázkem
• runJobs - Fronta úloh
• parser, ParserCache - Parser
• slow-parse - upozornění na stránky, jejichž analýza trvá dlouho
• csp- Record of CSP reports

Další skupiny ladicích protokolů

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