Manuel:$wgDebugLogGroups

This page is a translated version of the page Manual:$wgDebugLogGroups and the translation is 100% complete.
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 :[]

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.

Si un groupe est configuré dans $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 - erreurs
  • deprecated - avertissements d'obsolescence
  • objectcache, caches, memcached/SQLBagOStuff - cache
  • rdbms - base de données (including, if $wgDebugDumpSql is set, all DB queries)
  • cookie - cookies de réponse
  • exec - commandes shell
  • session - SessionManager
  • authentication, login - AuthManager
  • ratelimit, throttler - atteinte des limites de taux ($wgRateLimits et autres)
  • resourceloader, ResourceLoaderImage - ResourceLoader
  • http, HttpError - requêtes HTTP à des services externes (via les classes Http/MwHttpRequest)
  • api - API
  • thumbnail, fileupload, fileconcatenate - en lien avec les images
  • runJobs - File d’attente des travaux
  • parser, ParserCache - Parser
  • slow-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