[APACHE DOCUMENTATION]

Apache HTTP Server Version 1.3

Module mod_log_common

Ce module est implémenté dans le fichier mod_log_common.c, et est compilé par défaut. Il permet la trace des requêtes adressées au serveur sous le format Common Logfile Format. Ce module a été remplacé par le module mod_log_config dans la version 1.2 d'Apache.

Format du fichier de trace

Les fichiers de format "Common Log Format" (CLF) contiennent des lignes d'enregistrement, à raison d'une ligne par requête. Une ligne est composée de plusieurs champs séparés par des espaces :
hôte identité utilisateur_authentifié date requête etat volume
Lorsqu'un token n'a pas de valeur particulière, alors il est réduit à un tiret (-). La signification et les valeurs typiques de cs tokens sont les suivantes :
hôte
Le nom de domaine entièrement qualifié du client, ou son adresse IP si le nom de domaine n'est pas disponible.
identité
Si l'option IdentityCheck est activée et la machine cliente exécute identd, alors ce champ indique l'information d'identification donnée par le client.
utilisateur_authentifié
Si la requête visait un document protégé par mot de passe, alors ce champ contient le nom d'utilisateur utilisé lors de l'authentification.
date
La date et l'heure de la requête, dans le format suivant :
date = [jour/mois/an:heure:minute:seconde zone]
jour = 2*digit
mois = 3*lettre
an = 4*digit
heure = 2*digit
minute = 2*digit
seconde = 2*digit
zone = (`+' | `-') 4*digit
requête
La chaîne de requête émise par le client, entre guillemets (").
état
Le code de réponse donné par le serveur pour cette requête.
volume
Le nombre d'octets de l'objet renvoyé au client, hormis toute en-tête.

Directives

Directive : TransferLog

Syntaxe : TransferLog fichier-tube
Défaut : TransferLog logs/transfer_log
Contexte : configuration serveur, hôtes virtuels
Statut : Base
Module : mod_log_common

La directive TransferLog définit le nom du fichier dans lequel le serveur enregistrera la trace des requêtes reçues. Fichier-tube est soit :

Un nom de fichier
Le nom d'un firchier relativement à la racine ServerRoot.
'|' suivi d'une commande
Un programme qui recevra les informations de l'agent sur son entrée standard. Notez qu'un nouveau programme ne sera pas démarré pour un VirtualHost qui hérite du TransferLog du serveur principal.
Sécurité : si vous utilisez un programme, alors celui-ci sera exécuté sous le même utilisateur que celui qui a démarré httpd. Ce dernier peut être root si le serveur a été démarré sous root ; assurez-vous que ce programm est sûr.

Sécurité : Vois la page notes sur la sécurité pour plus de détails sur les risques de sécurité encourus lorsque un utilisateur autre que celui sous lequel tourne le serveur dispose de droits d'écriture sur le répertoire dans lequel sont inscrits les fichiers de trace.

Apache HTTP Server Version 1.3

Index Home