Module Apache mod_log_config

BufferedLogs Directive

Lorsque la directive BufferedLogs est � "on", mod_log_config stocke de nombreuses entr�es du journal en m�moire, et les �crit d'un seul bloc sur disque, plut�t que de les �crire apr�s chaque requ�te. Sur certains syst�mes, ceci peut am�liorer l'efficacit� des acc�s disque, et par cons�quent les performances. La directive ne peut �tre d�finie qu'une seule fois pour l'ensemble du serveur ; elle ne peut pas �tre d�finie au niveau d'un serveur virtuel.

CustomLog Directive

La directive CustomLog permet de contr�ler la journalisation des requ�tes destin�es au serveur. Un format de journal est sp�cifi�, et la journalisation peut s'effectuer de mani�re conditionnelle en fonction des caract�ristiques de la requ�te en utilisant des variables d'environnement.

Le premier argument, qui sp�cifie l'emplacement o� les journaux seront �crits, accepte deux types de valeurs :

fichier

Un nom de fichier, relatif au r�pertoire d�fini par la directive ServerRoot.

pipe

Le caract�re pipe "|", suivi du chemin vers un programme qui recevra les informations de la journalisation sur son entr�e standard. Voir les notes � propos de la journalisation redirig�e pour plus d'informations.

S�curit� :

Si les journaux sont redirig�s vers un programme, ce dernier s'ex�cutera sous l'utilisateur qui a d�marr� httpd. Ce sera l'utilisateur root si le serveur a �t� d�marr� par root ; v�rifiez que le programme est s�curis�.

Note

Lors de la sp�cification d'un chemin de fichier sur les plate-formes non-Unix, il faut prendre soin de ne pas oublier que seuls les slashes directs doivent �tre utilis�s, m�me si la plate-forme autorise l'emploi d'anti-slashes. D'une mani�re g�n�rale, c'est une bonne id�e que de n'utiliser que des slashes directs dans les fichiers de configuration.

Le second argument permet de d�finir ce qui va �tre �crit dans le fichier journal. Il peut contenir soit un alias pr�d�fini par une directive LogFormat, soit une cha�ne de format explicite comme d�crit dans la section formats de journaux.

Par exemple, les deux blocs de directives suivants produisent le m�me effet :

# Journal personnalis� avec alias de format
LogFormat "%h %l %u %t \"%r\" %>s %b" common
CustomLog logs/access_log common

# Journal personnalis� avec cha�ne de format explicite
CustomLog logs/access_log "%h %l %u %t \"%r\" %>s %b"
    

Le troisi�me argument est optionnel et permet de contr�ler si une requ�te doit �tre ou non journalis�e. Dans le cas d'une clause 'env=!nom', la condition peut �tre la pr�sence ou l'absence d'une variable particuli�re dans l'environnement du serveur. Dans le cas d'une clause 'expr=expression', la condition consiste en une expression bool�enne quelconque. Si la condition n'est pas v�rifi�e, la requ�te ne sera pas journalis�e. D'�ventuelles r�f�rences � des en-t�tes HTTP dans l'expression rationnelle n'entra�neront pas l'ajout des noms d'en-t�te correspondants � l'en-t�te Vary.

Les variables d'environnement peuvent �tre d�finies au niveau de chaque requ�te en utilisant les modules mod_setenvif et/ou mod_rewrite. Par exemple, si vous voulez enregistrer les requ�tes pour toutes les images GIF sur votre serveur dans un fichier journal s�par�, et pas dans votre journal principal, vous pouvez utiliser :

SetEnvIf Request_URI \.gif$ gif-image
CustomLog gif-requests.log common env=gif-image
CustomLog nongif-requests.log common env=!gif-image
    

Ou, pour reproduire le comportement de l'ancienne directive RefererIgnore, vous pouvez utiliser :

SetEnvIf Referer example\.com localreferer
CustomLog referer.log referer env=!localreferer
    

LogFormat Directive

Cette directive permet de sp�cifier le format du fichier journal des acc�s.

La directive LogFormat se pr�sente sous deux formes. Sous la premi�re forme, qui ne poss�de qu'un seul argument, la directive d�finit le format qui sera utilis� dans les journaux sp�cifi�s par les directives TransferLog ult�rieures. L'argument unique peut contenir un format explicite comme d�crit dans la section formats de journaux personnalis�s ci-dessus. Il peut aussi contenir un alias faisant r�f�rence � un format de journal pr�d�fini par une directive LogFormat comme d�crit plus loin.

Sous sa seconde forme, la directive LogFormat associe un format explicite � un alias. Cet alias peut ensuite s'utiliser dans les directives LogFormat ou CustomLog ult�rieures, ce qui �vite d'avoir � r�p�ter l'ensemble de la cha�ne de format. Une directive LogFormat qui d�finit un alias ne fait rien d'autre -- c'est � dire qu'elle ne fait que d�finir l'alias, elle n'applique pas le format et n'en fait pas le format par d�faut. Par cons�quent, elle n'affecte pas les directives TransferLog ult�rieures. En outre, la directive LogFormat ne peut pas utiliser un alias pour en d�finir un autre. Notez que l'alias ne doit pas contenir de caract�re pourcent (%).

      LogFormat "%v %h %l %u %t \"%r\" %>s %b" serveur_virtuel_commun
      

TransferLog Directive

Cette directive poss�de exactement les m�mes arguments et produit les m�mes effets que la directive CustomLog, � l'exception qu'elle ne permet pas de sp�cifier un format de journal explicite ou la journalisation conditionnelle des requ�tes. En l'occurrence, le format de journal est d�termin� par la derni�re d�finition d'une directive LogFormat qui ne d�finit pas d'alias. Si aucun format particulier n'a �t� sp�cifi�, c'est le Common Log Format qui sera utilis�.

LogFormat "%h %l %u %t \"%r\" %>s %b \"%{Referer}i\" \"%{User-agent}i\""
TransferLog logs/access_log