Manuel:$wgDebugLogGroups
Débogage: $wgDebugLogGroups | |
---|---|
Dirige la sortie de wfDebugLog() pour certains groupes, vers des fichiers autres que $wgDebugLogFile . |
|
Introduit dans la version : | 1.5.0 (r10598) |
Retiré dans la version : | Encore utilisé |
Valeurs autorisées : | (tableau de clés de groupe de journalisation associées aux noms de fichiers) |
Valeur par défaut : | [] |
Autres paramètres : Alphabétique | Par fonction |
Détails
Fixé à un tableau de clés de groupe de journalisation associées à des noms de fichiers.
S'il est initialisé, la sortie wfDebugLog()
pour ce groupe ira vers ce fichier plutôt que vers l'habituel $wgDebugLogFile
.
Utile pour activer la journalisation sélective en production.
$wgDebugLogGroups
, alors tous les messages de debogage ayant la même clé de groupe correspondante seront tracés dans ce fichier, de même que lorsque $wgDebugLogFile
n'est pas initialisé ! En d'autres termes : si une clé de groupe est configurée dans $wgDebugLogGroups
, les messages seront écrits, même si une valeur vide de $wgDebugLogFile
désactive généralement le débogage.Les destinations de la journalisation peuvent être :
false
pour les supprimer complètement dans la sortie, et dans $wgDebugLogFile.- une valeur littérale représentant un nom de fichier ou un URI.
- un tableau associatif avec les clés :
destination
- nom de fichier souhaité ou URI.sample
- nombre entier, représentant un facteur d'échantillonnage (optionnel)level
- constante de type\Psr\Log\LogLevel
, indiquant le niveau minimum de traçabilité (optionnel, depuis v1.25)
Si $wgMWLoggerDefaultSpi
est initialisé avec une valeur différente de celle par défaut, $wgDebugLogGroups
est probablement ignoré, et la méthode pour configurer les fichiers du journal est déterminée en fonction du système de suivi appelé par $wgMWLoggerDefaultSpi
.
Exemple
Cet exemple trace les messages de debogage des groupes « ConfirmEditExtension » à « debug-ext_confirmedit.log » ainsi que ceux des groupes « SpamRegex » à « debug-spam.log ».
$wgDebugLogGroups = [
'ConfirmEditExtension' => $IP . '/../../home/debug-ext_confirmedit.log',
'SpamRegex' => $IP . '/../../home/debug-spam.log',
];
Exemple :
$wgDebugLogGroups['redis'] = '/var/log/mediawiki/redis.log';
Exemple plus élaboré :
$wgDebugLogGroups['memcached'] = [
'destination' => '/var/log/mediawiki/memcached.log',
'sample' => 1000, // journalise 1 message sur 1000.
'level' => \Psr\Log\LogLevel::WARNING,
];
$wgDebugLogGroups['redis'] = [
'destination' => '/var/log/mediawiki/redis.log',
// Le niveau peut aussi être une valeur littérale parmi les constantes de Psr\Log\LogLevel.
'level' => 'info',
];
- Plusieurs groupes journalisés dans un seul fichier
- Vous pourriez vouloir définir une configuration temporaire comme ci-dessous pour voir toutes les traces relatives aux authentifications afin de résoudre les problèmes qui la concernent.
$wgDebugLogGroups['cookie'] =
$wgDebugLogGroups['session'] =
$wgDebugLogGroups['SimpleSAMLphp'] =
$wgDebugLogGroups['PluggableAuth'] = "$IP/cache/PluggableAuth.log";
Quelques groupes communs d'analyseurs de journaux
exception
,error
,fatal
- erreursdeprecated
- avertissements d'obsolescenceobjectcache
,caches
,memcached
/SQLBagOStuff
- cacherdbms
- base de données (including, if $wgDebugDumpSql is set, all DB queries)cookie
- cookies de réponseexec
- commandes shellsession
- SessionManagerauthentication
,login
- AuthManagerratelimit
,throttler
- atteinte des limites de taux ($wgRateLimits et autres)resourceloader
,ResourceLoaderImage
- ResourceLoaderhttp
,HttpError
- requêtes HTTP à des services externes (via les classesHttp
/MwHttpRequest
)api
- APIthumbnail
,fileupload
,fileconcatenate
- en lien avec les imagesrunJobs
- File d’attente des travauxparser
,ParserCache
- Parserslow-parse
- avertissements de pages qui prennent longtemps à être analysées
Other debug log groups
squid
localisation
gitinfo
UserOptionsManager
Mime
OldRevisionImporter
MessageCache
GlobalTitleFail
DeferredUpdates
ContentHandler
BlockManager
MediaHandlerFactory