logs.html.fr revision d229f940abfb2490dee17979e9a5ff31b7012eb5
c2756a68401102786be343712c0c35acbd73d28dLennart Poettering<?xml version="1.0" encoding="ISO-8859-1"?>
c2756a68401102786be343712c0c35acbd73d28dLennart Poettering<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
c2756a68401102786be343712c0c35acbd73d28dLennart Poettering<html xmlns="http://www.w3.org/1999/xhtml" lang="fr" xml:lang="fr"><head><!--
c2756a68401102786be343712c0c35acbd73d28dLennart Poettering XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
c2756a68401102786be343712c0c35acbd73d28dLennart Poettering This file is generated from xml source: DO NOT EDIT
c2756a68401102786be343712c0c35acbd73d28dLennart Poettering XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
c2756a68401102786be343712c0c35acbd73d28dLennart Poettering -->
c2756a68401102786be343712c0c35acbd73d28dLennart Poettering<title>Fichiers journaux - Serveur Apache HTTP</title>
c2756a68401102786be343712c0c35acbd73d28dLennart Poettering<link href="/style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet" />
c2756a68401102786be343712c0c35acbd73d28dLennart Poettering<link href="/style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size" />
c2756a68401102786be343712c0c35acbd73d28dLennart Poettering<link href="/style/css/manual-print.css" rel="stylesheet" media="print" type="text/css" /><link rel="stylesheet" type="text/css" href="/style/css/prettify.css" />
c2756a68401102786be343712c0c35acbd73d28dLennart Poettering<script src="/style/scripts/prettify.js" type="text/javascript">
c2756a68401102786be343712c0c35acbd73d28dLennart Poettering</script>
c2756a68401102786be343712c0c35acbd73d28dLennart Poettering
c2756a68401102786be343712c0c35acbd73d28dLennart Poettering<link href="/images/favicon.ico" rel="shortcut icon" /></head>
c2756a68401102786be343712c0c35acbd73d28dLennart Poettering<body id="manual-page"><div id="page-header">
c2756a68401102786be343712c0c35acbd73d28dLennart Poettering<p class="menu"><a href="/mod/">Modules</a> | <a href="/mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="/glossary.html">Glossaire</a> | <a href="/sitemap.html">Plan du site</a></p>
c2756a68401102786be343712c0c35acbd73d28dLennart Poettering<p class="apache">Serveur Apache HTTP Version 2.5</p>
c2756a68401102786be343712c0c35acbd73d28dLennart Poettering<img alt="" src="/images/feather.gif" /></div>
c2756a68401102786be343712c0c35acbd73d28dLennart Poettering<div class="up"><a href="./"><img title="&lt;-" alt="&lt;-" src="/images/left.gif" /></a></div>
c2756a68401102786be343712c0c35acbd73d28dLennart Poettering<div id="path">
c2756a68401102786be343712c0c35acbd73d28dLennart Poettering<a href="http://www.apache.org/">Apache</a> &gt; <a href="http://httpd.apache.org/">Serveur HTTP</a> &gt; <a href="http://httpd.apache.org/docs/">Documentation</a> &gt; <a href="./">Version 2.5</a></div><div id="page-content"><div id="preamble"><h1>Fichiers journaux</h1>
6c12b52e19640747e96f89d85422941a23dc6b29Lennart Poettering<div class="toplang">
c2756a68401102786be343712c0c35acbd73d28dLennart Poettering<p><span>Langues Disponibles: </span><a href="/en/logs.html" hreflang="en" rel="alternate" title="English">&nbsp;en&nbsp;</a> |
c2756a68401102786be343712c0c35acbd73d28dLennart Poettering<a href="/fr/logs.html" title="Fran�ais">&nbsp;fr&nbsp;</a> |
40ca29a1370379d43e44c0ed425eecc7218dcbcaLennart Poettering<a href="/ja/logs.html" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&nbsp;</a> |
c2756a68401102786be343712c0c35acbd73d28dLennart Poettering<a href="/ko/logs.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</a> |
6c12b52e19640747e96f89d85422941a23dc6b29Lennart Poettering<a href="/tr/logs.html" hreflang="tr" rel="alternate" title="T�rk�e">&nbsp;tr&nbsp;</a></p>
6c12b52e19640747e96f89d85422941a23dc6b29Lennart Poettering</div>
4bcc8c3cb57733de6eeb2528a194501fade11e6bZbigniew Jędrzejewski-Szmek<div class="outofdate">Cette traduction peut �tre p�rim�e. V�rifiez la version
c2756a68401102786be343712c0c35acbd73d28dLennart Poettering anglaise pour les changements r�cents.</div>
6c12b52e19640747e96f89d85422941a23dc6b29Lennart Poettering
6c12b52e19640747e96f89d85422941a23dc6b29Lennart Poettering <p>Pour v�ritablement g�rer un serveur web,
6577c7cea72f19185ad999c223bcf663c010dc6fLennart Poettering il est n�cessaire de disposer d'un
6c12b52e19640747e96f89d85422941a23dc6b29Lennart Poettering retour d'informations � propos de l'activit� et des performances du
9f2e86af0600e99cff00d1c92f9bb8d38f29896aLennart Poettering serveur, ainsi que de tout probl�me qui pourrait survenir. Le serveur HTTP
c221420be8744bb0f8b8a8145efc1f247f1aa801Lennart Poettering Apache propose des fonctionnalit�s de journalisation souples et tr�s
a6c0353b9268d5b780fb7ff05a10cb5031446e5dLennart Poettering compl�tes. Ce document d�crit comment configurer ces fonctionnalit�s de
c2756a68401102786be343712c0c35acbd73d28dLennart Poettering journalisation et interpr�ter le contenu des journaux.</p>
6c12b52e19640747e96f89d85422941a23dc6b29Lennart Poettering </div>
6c12b52e19640747e96f89d85422941a23dc6b29Lennart Poettering<div id="quickview"><ul id="toc"><li><img alt="" src="/images/down.gif" /> <a href="#overview">Vue d'ensemble</a></li>
c9d954b27ee125c3c90a6d2951c62eec4abb160bZbigniew Jędrzejewski-Szmek<li><img alt="" src="/images/down.gif" /> <a href="#security">Avertissement � propos de la s�curit�</a></li>
3803cde44c3d949765bdf0e8bce06886224d40b4Lennart Poettering<li><img alt="" src="/images/down.gif" /> <a href="#errorlog">Journal des erreurs</a></li>
6577c7cea72f19185ad999c223bcf663c010dc6fLennart Poettering<li><img alt="" src="/images/down.gif" /> <a href="#permodule">Journalisation par module</a></li>
6577c7cea72f19185ad999c223bcf663c010dc6fLennart Poettering<li><img alt="" src="/images/down.gif" /> <a href="#accesslog">Journal des acc�s</a></li>
6577c7cea72f19185ad999c223bcf663c010dc6fLennart Poettering<li><img alt="" src="/images/down.gif" /> <a href="#rotation">Rotation des journaux</a></li>
6577c7cea72f19185ad999c223bcf663c010dc6fLennart Poettering<li><img alt="" src="/images/down.gif" /> <a href="#piped">Journaux redirig�s</a></li>
6577c7cea72f19185ad999c223bcf663c010dc6fLennart Poettering<li><img alt="" src="/images/down.gif" /> <a href="#virtualhost">H�tes virtuels</a></li>
6577c7cea72f19185ad999c223bcf663c010dc6fLennart Poettering<li><img alt="" src="/images/down.gif" /> <a href="#other">Autres fichiers journaux</a></li>
6577c7cea72f19185ad999c223bcf663c010dc6fLennart Poettering</ul></div>
a6c0353b9268d5b780fb7ff05a10cb5031446e5dLennart Poettering<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
a6c0353b9268d5b780fb7ff05a10cb5031446e5dLennart Poettering<div class="section">
6c12b52e19640747e96f89d85422941a23dc6b29Lennart Poettering<h2><a name="overview" id="overview">Vue d'ensemble</a></h2>
6c12b52e19640747e96f89d85422941a23dc6b29Lennart Poettering
6c12b52e19640747e96f89d85422941a23dc6b29Lennart Poettering
6c12b52e19640747e96f89d85422941a23dc6b29Lennart Poettering <table class="related"><tr><th>Modules Apparent�s</th><th>Directives Apparent�es</th></tr><tr><td><ul><li><code class="module"><a href="/mod/mod_log_config.html">mod_log_config</a></code></li><li><code class="module"><a href="/mod/mod_log_forensic.html">mod_log_forensic</a></code></li><li><code class="module"><a href="/mod/mod_logio.html">mod_logio</a></code></li><li><code class="module"><a href="/mod/mod_cgi.html">mod_cgi</a></code></li></ul></td><td /></tr></table>
6c12b52e19640747e96f89d85422941a23dc6b29Lennart Poettering
6c12b52e19640747e96f89d85422941a23dc6b29Lennart Poettering <p>
6c12b52e19640747e96f89d85422941a23dc6b29Lennart Poettering Le serveur HTTP Apache fournit toute une vari�t� de m�canismes
6c12b52e19640747e96f89d85422941a23dc6b29Lennart Poettering diff�rents pour la journalisation de tout ce qui peut se passer au
6c12b52e19640747e96f89d85422941a23dc6b29Lennart Poettering sein de votre serveur, depuis la requ�te initiale, en passant par le
6c12b52e19640747e96f89d85422941a23dc6b29Lennart Poettering processus de mise en correspondance des URLs, et jusqu'� la fermeture
6c12b52e19640747e96f89d85422941a23dc6b29Lennart Poettering de la connexion, y compris toute erreur pouvant survenir au cours du
9f2e86af0600e99cff00d1c92f9bb8d38f29896aLennart Poettering traitement. De plus, certains modules tiers fournissent des
c221420be8744bb0f8b8a8145efc1f247f1aa801Lennart Poettering fonctionnalit�s de journalisation ou ins�rent des entr�es dans les
a6c0353b9268d5b780fb7ff05a10cb5031446e5dLennart Poettering fichiers journaux existants, et les applications comme les programmes
a6c0353b9268d5b780fb7ff05a10cb5031446e5dLennart Poettering CGI, les scripts PHP ou autres gestionnaires peuvent envoyer des
6c12b52e19640747e96f89d85422941a23dc6b29Lennart Poettering messages vers le journal des erreurs du serveur.
6c12b52e19640747e96f89d85422941a23dc6b29Lennart Poettering </p>
6c12b52e19640747e96f89d85422941a23dc6b29Lennart Poettering
6577c7cea72f19185ad999c223bcf663c010dc6fLennart Poettering <p>
6577c7cea72f19185ad999c223bcf663c010dc6fLennart Poettering Ce document d�crit le fonctionnement des modules de journalisation
6577c7cea72f19185ad999c223bcf663c010dc6fLennart Poettering fournis en standard avec le serveur httpd.
6577c7cea72f19185ad999c223bcf663c010dc6fLennart Poettering </p>
6577c7cea72f19185ad999c223bcf663c010dc6fLennart Poettering
6577c7cea72f19185ad999c223bcf663c010dc6fLennart Poettering </div><div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
6577c7cea72f19185ad999c223bcf663c010dc6fLennart Poettering<div class="section">
a6c0353b9268d5b780fb7ff05a10cb5031446e5dLennart Poettering<h2><a name="security" id="security">Avertissement � propos de la s�curit�</a></h2>
a6c0353b9268d5b780fb7ff05a10cb5031446e5dLennart Poettering
6577c7cea72f19185ad999c223bcf663c010dc6fLennart Poettering
6c12b52e19640747e96f89d85422941a23dc6b29Lennart Poettering <p>Tout utilisateur qui a les droits en �criture sur le r�pertoire dans
6c12b52e19640747e96f89d85422941a23dc6b29Lennart Poettering lequel Apache httpd �crit ses journaux pourra quasi
6c12b52e19640747e96f89d85422941a23dc6b29Lennart Poettering certainement avoir acc�s � l'uid sous lequel le serveur est d�marr�, en
6c12b52e19640747e96f89d85422941a23dc6b29Lennart Poettering l'occurrence habituellement root. N'accordez <em>PAS</em> aux utilisateurs
6c12b52e19640747e96f89d85422941a23dc6b29Lennart Poettering l'acc�s en �criture au r�pertoire dans lequel les journaux sont stock�s
6c12b52e19640747e96f89d85422941a23dc6b29Lennart Poettering sans savoir exactement quelles en seraient les cons�quences ; voir le
6c12b52e19640747e96f89d85422941a23dc6b29Lennart Poettering document <a href="misc/security_tips.html">conseils sur la s�curit�</a>
6577c7cea72f19185ad999c223bcf663c010dc6fLennart Poettering pour plus de d�tails.</p>
6c12b52e19640747e96f89d85422941a23dc6b29Lennart Poettering
6c12b52e19640747e96f89d85422941a23dc6b29Lennart Poettering <p>En outre, les journaux peuvent contenir des informations fournies
6c12b52e19640747e96f89d85422941a23dc6b29Lennart Poettering directement par un client, sans caract�res d'�chappement. Des clients mal
6c12b52e19640747e96f89d85422941a23dc6b29Lennart Poettering intentionn�s peuvent donc ins�rer des caract�res de contr�le dans les
6c12b52e19640747e96f89d85422941a23dc6b29Lennart Poettering journaux, et il convient par cons�quent d'�tre tr�s prudent lors de la
6c12b52e19640747e96f89d85422941a23dc6b29Lennart Poettering manipulation des journaux bruts.</p>
6c12b52e19640747e96f89d85422941a23dc6b29Lennart Poettering </div><div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
6c12b52e19640747e96f89d85422941a23dc6b29Lennart Poettering<div class="section">
6c12b52e19640747e96f89d85422941a23dc6b29Lennart Poettering<h2><a name="errorlog" id="errorlog">Journal des erreurs</a></h2>
6c12b52e19640747e96f89d85422941a23dc6b29Lennart Poettering
6c12b52e19640747e96f89d85422941a23dc6b29Lennart Poettering
6c12b52e19640747e96f89d85422941a23dc6b29Lennart Poettering <table class="related"><tr><th>Modules Apparent�s</th><th>Directives Apparent�es</th></tr><tr><td><ul><li><code class="module"><a href="/mod/core.html">core</a></code></li></ul></td><td><ul><li><code class="directive"><a href="/mod/core.html#errorlog">ErrorLog</a></code></li><li><code class="directive"><a href="/mod/core.html#loglevel">LogLevel</a></code></li></ul></td></tr></table>
6c12b52e19640747e96f89d85422941a23dc6b29Lennart Poettering
6c12b52e19640747e96f89d85422941a23dc6b29Lennart Poettering <p>Le journal des erreurs du serveur, dont le nom et la localisation sont
6c12b52e19640747e96f89d85422941a23dc6b29Lennart Poettering d�finis par la directive <code class="directive"><a href="/mod/core.html#errorlog">ErrorLog</a></code>,
6c12b52e19640747e96f89d85422941a23dc6b29Lennart Poettering est le journal le plus important. C'est dans celui-ci
6c12b52e19640747e96f89d85422941a23dc6b29Lennart Poettering que le d�mon Apache httpd va envoyer les informations de diagnostic et
6c12b52e19640747e96f89d85422941a23dc6b29Lennart Poettering enregistrer toutes les erreurs qui surviennent lors du traitement des
6c12b52e19640747e96f89d85422941a23dc6b29Lennart Poettering requ�tes. Lorsqu'un probl�me survient au d�marrage du serveur ou pendant
6c12b52e19640747e96f89d85422941a23dc6b29Lennart Poettering son fonctionnement, la premi�re chose � faire est de regarder dans ce
6c12b52e19640747e96f89d85422941a23dc6b29Lennart Poettering journal, car il vous renseignera souvent sur le probl�me rencontr� et
6c12b52e19640747e96f89d85422941a23dc6b29Lennart Poettering la mani�re d'y rem�dier.</p>
6c12b52e19640747e96f89d85422941a23dc6b29Lennart Poettering
6c12b52e19640747e96f89d85422941a23dc6b29Lennart Poettering <p>Le journal des erreurs est habituellement enregistr� dans un fichier
9f2e86af0600e99cff00d1c92f9bb8d38f29896aLennart Poettering (en g�n�ral <code>error_log</code> sur les syst�mes de type Unix et
9f2e86af0600e99cff00d1c92f9bb8d38f29896aLennart Poettering <code>error.log</code> sur Windows et OS/2). Sur les syst�mes de type Unix,
9f2e86af0600e99cff00d1c92f9bb8d38f29896aLennart Poettering le serveur peut aussi enregistrer ses erreurs dans
9f2e86af0600e99cff00d1c92f9bb8d38f29896aLennart Poettering <code>syslog</code> ou les
c221420be8744bb0f8b8a8145efc1f247f1aa801Lennart Poettering <a href="#piped">rediriger vers un programme</a> par l'interm�diaire d'un
c221420be8744bb0f8b8a8145efc1f247f1aa801Lennart Poettering tube de communication (pipe).</p>
c221420be8744bb0f8b8a8145efc1f247f1aa801Lennart Poettering
c221420be8744bb0f8b8a8145efc1f247f1aa801Lennart Poettering <p>Le format par d�faut du journal des erreurs est descriptif et de forme
a6c0353b9268d5b780fb7ff05a10cb5031446e5dLennart Poettering relativement libre. Certaines informations apparaissent cependant dans la
a6c0353b9268d5b780fb7ff05a10cb5031446e5dLennart Poettering plupart des entr�es du journal. Voici un message typique
a6c0353b9268d5b780fb7ff05a10cb5031446e5dLennart Poettering � titre d'exemple : </p>
a6c0353b9268d5b780fb7ff05a10cb5031446e5dLennart Poettering
6577c7cea72f19185ad999c223bcf663c010dc6fLennart Poettering <div class="example"><p><code>
6577c7cea72f19185ad999c223bcf663c010dc6fLennart Poettering [Wed Oct 11 14:32:52 2000] [error] [client 127.0.0.1]
6577c7cea72f19185ad999c223bcf663c010dc6fLennart Poettering client denied by server configuration:
6577c7cea72f19185ad999c223bcf663c010dc6fLennart Poettering /export/home/live/ap/htdocs/test
6c12b52e19640747e96f89d85422941a23dc6b29Lennart Poettering </code></p></div>
6c12b52e19640747e96f89d85422941a23dc6b29Lennart Poettering
6c12b52e19640747e96f89d85422941a23dc6b29Lennart Poettering <p>Le premier champ de l'entr�e du journal est la date et l'heure du
6c12b52e19640747e96f89d85422941a23dc6b29Lennart Poettering message. Le second champ indique la s�v�rit� de l'erreur rapport�e. La
6c12b52e19640747e96f89d85422941a23dc6b29Lennart Poettering directive <code class="directive"><a href="/mod/core.html#loglevel">LogLevel</a></code> permet de
6c12b52e19640747e96f89d85422941a23dc6b29Lennart Poettering restreindre le type des erreurs qui doivent �tre enregistr�es
6c12b52e19640747e96f89d85422941a23dc6b29Lennart Poettering dans le journal des erreurs en d�finissant leur niveau de s�v�rit�. Le
6c12b52e19640747e96f89d85422941a23dc6b29Lennart Poettering troisi�me champ contient l'adresse IP du client qui a g�n�r� l'erreur.
6c12b52e19640747e96f89d85422941a23dc6b29Lennart Poettering Vient ensuite le message proprement dit, qui indique dans ce cas que le
6c12b52e19640747e96f89d85422941a23dc6b29Lennart Poettering serveur a �t� configur� pour interdire l'acc�s au client. Le serveur
6c12b52e19640747e96f89d85422941a23dc6b29Lennart Poettering indique le chemin syst�me du document requis (et non
6c12b52e19640747e96f89d85422941a23dc6b29Lennart Poettering son chemin web).</p>
6c12b52e19640747e96f89d85422941a23dc6b29Lennart Poettering
6c12b52e19640747e96f89d85422941a23dc6b29Lennart Poettering <p>Une grande vari�t� de messages diff�rents peuvent appara�tre dans le
6c12b52e19640747e96f89d85422941a23dc6b29Lennart Poettering journal des erreurs. La plupart d'entre eux sont similaires � l'exemple
6c12b52e19640747e96f89d85422941a23dc6b29Lennart Poettering ci-dessus. Le journal des erreurs peut aussi contenir des informations de
6c12b52e19640747e96f89d85422941a23dc6b29Lennart Poettering d�bogage en provenance de scripts CGI. Toute information qu'un script CGI
6c12b52e19640747e96f89d85422941a23dc6b29Lennart Poettering �crit sur la sortie d'erreurs standard <code>stderr</code> sera recopi�e
6c12b52e19640747e96f89d85422941a23dc6b29Lennart Poettering telle quelle dans le journal des erreurs.</p>
c2756a68401102786be343712c0c35acbd73d28dLennart Poettering
c2756a68401102786be343712c0c35acbd73d28dLennart Poettering <p>La directive <code class="directive"><a href="/mod/core.html#errorlogformat">ErrorLogFormat</a></code>
6c12b52e19640747e96f89d85422941a23dc6b29Lennart Poettering vous permet de personnaliser le format du journal des erreurs, et de
6c12b52e19640747e96f89d85422941a23dc6b29Lennart Poettering d�finir les informations � journaliser. Si
c2756a68401102786be343712c0c35acbd73d28dLennart Poettering <code class="module"><a href="/mod/mod_unique_id.html">mod_unique_id</a></code> est pr�sent, vous pouvez utiliser le
c2756a68401102786be343712c0c35acbd73d28dLennart Poettering drapeau <code>%L</code> � la fois dans le journal des erreurs et
c2756a68401102786be343712c0c35acbd73d28dLennart Poettering dans le
c2756a68401102786be343712c0c35acbd73d28dLennart Poettering journal des acc�s, ce qui aura pour effet de g�n�rer un identifiant
c2756a68401102786be343712c0c35acbd73d28dLennart Poettering d'entr�e qui vous permettra de corr�ler les entr�es du journal des
c2756a68401102786be343712c0c35acbd73d28dLennart Poettering erreurs avec celles du journal des acc�s.</p>
c2756a68401102786be343712c0c35acbd73d28dLennart Poettering
c2756a68401102786be343712c0c35acbd73d28dLennart Poettering <p>Pendant la phase de test, il est souvent utile de visualiser en continu
c2756a68401102786be343712c0c35acbd73d28dLennart Poettering le journal des erreurs afin de d�tecter tout probl�me �ventuel. Sur les
c2756a68401102786be343712c0c35acbd73d28dLennart Poettering syst�mes de type Unix, ceci s'effectue � l'aide de la commande :</p>
c2756a68401102786be343712c0c35acbd73d28dLennart Poettering
c2756a68401102786be343712c0c35acbd73d28dLennart Poettering <div class="example"><p><code>
c2756a68401102786be343712c0c35acbd73d28dLennart Poettering tail -f error_log
c2756a68401102786be343712c0c35acbd73d28dLennart Poettering </code></p></div>
c2756a68401102786be343712c0c35acbd73d28dLennart Poettering </div><div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
c2756a68401102786be343712c0c35acbd73d28dLennart Poettering<div class="section">
c2756a68401102786be343712c0c35acbd73d28dLennart Poettering<h2><a name="permodule" id="permodule">Journalisation par module</a></h2>
9f2e86af0600e99cff00d1c92f9bb8d38f29896aLennart Poettering
c2756a68401102786be343712c0c35acbd73d28dLennart Poettering
c2756a68401102786be343712c0c35acbd73d28dLennart Poettering <p>La directive <code class="directive"><a href="/mod/core.html#loglevel">LogLevel</a></code> permet
c2756a68401102786be343712c0c35acbd73d28dLennart Poettering de sp�cifier un niveau de s�v�rit� de journalisation pour chaque
c221420be8744bb0f8b8a8145efc1f247f1aa801Lennart Poettering module. Vous pouvez ainsi r�soudre un probl�me propre � un module particulier
c221420be8744bb0f8b8a8145efc1f247f1aa801Lennart Poettering en augmentant son volume de journalisation sans augmenter ce volume
c221420be8744bb0f8b8a8145efc1f247f1aa801Lennart Poettering pour les autres modules. Ceci est particuli�rement utile lorsque
c221420be8744bb0f8b8a8145efc1f247f1aa801Lennart Poettering vous voulez obtenir des d�tails sur le fonctionnement de modules
c221420be8744bb0f8b8a8145efc1f247f1aa801Lennart Poettering comme <code class="module"><a href="/mod/mod_proxy.html">mod_proxy</a></code> ou <code class="module"><a href="/mod/mod_rewrite.html">mod_rewrite</a></code>.</p>
c221420be8744bb0f8b8a8145efc1f247f1aa801Lennart Poettering
c221420be8744bb0f8b8a8145efc1f247f1aa801Lennart Poettering <p>Pour ce faire, vous devez sp�cifier le nom du module dans votre
c221420be8744bb0f8b8a8145efc1f247f1aa801Lennart Poettering directive <code class="directive">LogLevel</code> :</p>
c221420be8744bb0f8b8a8145efc1f247f1aa801Lennart Poettering
c221420be8744bb0f8b8a8145efc1f247f1aa801Lennart Poettering <div class="example"><p><code>
c221420be8744bb0f8b8a8145efc1f247f1aa801Lennart Poettering LogLevel info rewrite:trace5
c221420be8744bb0f8b8a8145efc1f247f1aa801Lennart Poettering </code></p></div>
a6c0353b9268d5b780fb7ff05a10cb5031446e5dLennart Poettering
a6c0353b9268d5b780fb7ff05a10cb5031446e5dLennart Poettering <p>Dans cet exemple, le niveau de journalisation g�n�ral est d�fini
a6c0353b9268d5b780fb7ff05a10cb5031446e5dLennart Poettering � info, et � <code>trace5</code> pour <code class="module"><a href="/mod/mod_rewrite.html">mod_rewrite</a></code>.</p>
a6c0353b9268d5b780fb7ff05a10cb5031446e5dLennart Poettering
6c12b52e19640747e96f89d85422941a23dc6b29Lennart Poettering <div class="note">Cette directive remplace les directives de journalisation par
6c12b52e19640747e96f89d85422941a23dc6b29Lennart Poettering module des versions pr�c�dentes du serveur, comme
6c12b52e19640747e96f89d85422941a23dc6b29Lennart Poettering <code>RewriteLog</code>.</div>
6c12b52e19640747e96f89d85422941a23dc6b29Lennart Poettering </div><div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
6c12b52e19640747e96f89d85422941a23dc6b29Lennart Poettering<div class="section">
6c12b52e19640747e96f89d85422941a23dc6b29Lennart Poettering<h2><a name="accesslog" id="accesslog">Journal des acc�s</a></h2>
6c12b52e19640747e96f89d85422941a23dc6b29Lennart Poettering
6c12b52e19640747e96f89d85422941a23dc6b29Lennart Poettering
6c12b52e19640747e96f89d85422941a23dc6b29Lennart Poettering <table class="related"><tr><th>Modules Apparent�s</th><th>Directives Apparent�es</th></tr><tr><td><ul><li><code class="module"><a href="/mod/mod_log_config.html">mod_log_config</a></code></li><li><code class="module"><a href="/mod/mod_setenvif.html">mod_setenvif</a></code></li></ul></td><td><ul><li><code class="directive"><a href="/mod/mod_log_config.html#customlog">CustomLog</a></code></li><li><code class="directive"><a href="/mod/mod_log_config.html#logformat">LogFormat</a></code></li><li><code class="directive"><a href="/mod/mod_setenvif.html#setenvif">SetEnvIf</a></code></li></ul></td></tr></table>
6c12b52e19640747e96f89d85422941a23dc6b29Lennart Poettering
6c12b52e19640747e96f89d85422941a23dc6b29Lennart Poettering <p>Le journal des acc�s au serveur
6c12b52e19640747e96f89d85422941a23dc6b29Lennart Poettering enregistre toutes les requ�tes que traite
6c12b52e19640747e96f89d85422941a23dc6b29Lennart Poettering ce dernier. La localisation et le contenu du journal des acc�s sont d�finis
6c12b52e19640747e96f89d85422941a23dc6b29Lennart Poettering par la directive <code class="directive"><a href="/mod/mod_log_config.html#customlog">CustomLog</a></code>.
6c12b52e19640747e96f89d85422941a23dc6b29Lennart Poettering La directive <code class="directive"><a href="/mod/mod_log_config.html#logformat">LogFormat</a></code>
6c12b52e19640747e96f89d85422941a23dc6b29Lennart Poettering permet de simplifier la s�lection du contenu du journal. Cette section
6c12b52e19640747e96f89d85422941a23dc6b29Lennart Poettering d�crit comment configurer le serveur pour l'enregistrement des informations
6c12b52e19640747e96f89d85422941a23dc6b29Lennart Poettering dans le journal des acc�s.</p>
6c12b52e19640747e96f89d85422941a23dc6b29Lennart Poettering
6c12b52e19640747e96f89d85422941a23dc6b29Lennart Poettering <p>Bien �videmment, le stockage d'informations dans le journal des acc�s
6c12b52e19640747e96f89d85422941a23dc6b29Lennart Poettering n'est que le point de d�part de la gestion de la journalisation. L'�tape
6c12b52e19640747e96f89d85422941a23dc6b29Lennart Poettering suivante consiste � analyser ces informations de fa�on � pouvoir en
6c12b52e19640747e96f89d85422941a23dc6b29Lennart Poettering extraire des statistiques utiles. L'analyse de journaux en g�n�ral est en
6c12b52e19640747e96f89d85422941a23dc6b29Lennart Poettering dehors du sujet de ce document et ne fait pas vraiment partie int�grante
6c12b52e19640747e96f89d85422941a23dc6b29Lennart Poettering du travail du serveur web lui-m�me. Pour plus d'informations � propos de ce
6c12b52e19640747e96f89d85422941a23dc6b29Lennart Poettering sujet et des applications d�di�es � l'analyse de journaux, vous pouvez vous
6c12b52e19640747e96f89d85422941a23dc6b29Lennart Poettering r�f�rer � <a href="http://dmoz.org/Computers/Software/Internet/ Site_Management/Log_analysis/">Open Directory</a> ou
6c12b52e19640747e96f89d85422941a23dc6b29Lennart Poettering <a href="http://dir.yahoo.com/Computers_and_Internet/Software/ Internet/World_Wide_Web/Servers/Log_Analysis_Tools/">Yahoo</a>.</p>
6c12b52e19640747e96f89d85422941a23dc6b29Lennart Poettering
6c12b52e19640747e96f89d85422941a23dc6b29Lennart Poettering <p>Diff�rentes versions du d�mon Apache httpd utilisaient d'autres modules
6c12b52e19640747e96f89d85422941a23dc6b29Lennart Poettering et directives pour contr�ler la journalisation des acc�s, � l'instar de
6c12b52e19640747e96f89d85422941a23dc6b29Lennart Poettering mod_log_referer, mod_log_agent, et de la directive
6c12b52e19640747e96f89d85422941a23dc6b29Lennart Poettering <code>TransferLog</code>. La directive
6c12b52e19640747e96f89d85422941a23dc6b29Lennart Poettering <code class="directive"><a href="/mod/mod_log_config.html#customlog">CustomLog</a></code> rassemble
6c12b52e19640747e96f89d85422941a23dc6b29Lennart Poettering d�sormais les fonctionnalit�s de toutes les anciennes directives.</p>
6c12b52e19640747e96f89d85422941a23dc6b29Lennart Poettering
6c12b52e19640747e96f89d85422941a23dc6b29Lennart Poettering <p>Le format du journal des acc�s est hautement configurable. Il est
6577c7cea72f19185ad999c223bcf663c010dc6fLennart Poettering d�fini � l'aide d'une cha�ne de format qui ressemble sensiblement � la
6577c7cea72f19185ad999c223bcf663c010dc6fLennart Poettering cha�ne de format de style langage C de printf(1). Vous trouverez quelques
6577c7cea72f19185ad999c223bcf663c010dc6fLennart Poettering exemples dans les sections suivantes. Pour une liste exhaustive de ce que
6577c7cea72f19185ad999c223bcf663c010dc6fLennart Poettering peut contenir une cha�ne de format, vous pouvez vous r�f�rer au chapitre
9f2e86af0600e99cff00d1c92f9bb8d38f29896aLennart Poettering <a href="mod/mod_log_config.html#formats">cha�nes de format</a> de la
9f2e86af0600e99cff00d1c92f9bb8d38f29896aLennart Poettering documentation du module <code class="module"><a href="/mod/mod_log_config.html">mod_log_config</a></code>.</p>
9f2e86af0600e99cff00d1c92f9bb8d38f29896aLennart Poettering
9f2e86af0600e99cff00d1c92f9bb8d38f29896aLennart Poettering <h3><a name="common" id="common">Format habituel du journal</a></h3>
c2756a68401102786be343712c0c35acbd73d28dLennart Poettering
c2756a68401102786be343712c0c35acbd73d28dLennart Poettering
c2756a68401102786be343712c0c35acbd73d28dLennart Poettering <p>Voici une configuration typique pour le journal des acc�s :</p>
c2756a68401102786be343712c0c35acbd73d28dLennart Poettering
c2756a68401102786be343712c0c35acbd73d28dLennart Poettering <div class="example"><p><code>
c2756a68401102786be343712c0c35acbd73d28dLennart Poettering LogFormat "%h %l %u %t \"%r\" %&gt;s %b" common<br />
c2756a68401102786be343712c0c35acbd73d28dLennart Poettering CustomLog logs/access_log common
c2756a68401102786be343712c0c35acbd73d28dLennart Poettering </code></p></div>
c2756a68401102786be343712c0c35acbd73d28dLennart Poettering
c2756a68401102786be343712c0c35acbd73d28dLennart Poettering <p>Ici est d�finie l'<em>identit�</em> <code>common</code> qui est
c2756a68401102786be343712c0c35acbd73d28dLennart Poettering ensuite associ�e � une cha�ne de format de journalisation particuli�re.
c2756a68401102786be343712c0c35acbd73d28dLennart Poettering La cha�ne de format est constitu�e de directives d�butant par le
c2756a68401102786be343712c0c35acbd73d28dLennart Poettering caract�re %, chacune d'entre elles indiquant au serveur d'enregistrer
c2756a68401102786be343712c0c35acbd73d28dLennart Poettering un �l�ment particulier d'information. Des caract�res litt�raux peuvent
c2756a68401102786be343712c0c35acbd73d28dLennart Poettering aussi �tre ins�r�s dans la cha�ne de format ; il seront copi�s tels
c2756a68401102786be343712c0c35acbd73d28dLennart Poettering quels dans le flux de sortie destin� � la journalisation.
c2756a68401102786be343712c0c35acbd73d28dLennart Poettering Les guillemets (<code>"</code>) doivent �tre �chapp�es en les faisant
c2756a68401102786be343712c0c35acbd73d28dLennart Poettering pr�c�der d'un anti-slash (<code>\</code>) afin qu'elles ne soient pas
c2756a68401102786be343712c0c35acbd73d28dLennart Poettering interpr�t�es comme la fin de la cha�ne de format. La cha�ne de format
c2756a68401102786be343712c0c35acbd73d28dLennart Poettering peut aussi contenir les caract�res de contr�le sp�ciaux
c2756a68401102786be343712c0c35acbd73d28dLennart Poettering "<code>\n</code>" et "<code>\t</code>" pour ins�rer respectivement
c2756a68401102786be343712c0c35acbd73d28dLennart Poettering un passage � la ligne et une tabulation.</p>
c2756a68401102786be343712c0c35acbd73d28dLennart Poettering
c2756a68401102786be343712c0c35acbd73d28dLennart Poettering <p>La directive <code class="directive"><a href="/mod/mod_log_config.html#customlog">CustomLog</a></code>
c2756a68401102786be343712c0c35acbd73d28dLennart Poettering d�finit un nouveau fichier journal en l'associant � l'identit�
c2756a68401102786be343712c0c35acbd73d28dLennart Poettering pr�c�demment d�finie. Le chemin du nom de fichier associ� au journal
c2756a68401102786be343712c0c35acbd73d28dLennart Poettering des acc�s est relatif au chemin d�fini par la directive
c2756a68401102786be343712c0c35acbd73d28dLennart Poettering <code class="directive"><a href="/mod/core.html#serverroot">ServerRoot</a></code>, sauf s'il
c2756a68401102786be343712c0c35acbd73d28dLennart Poettering d�bute par un slash.</p>
c2756a68401102786be343712c0c35acbd73d28dLennart Poettering
c2756a68401102786be343712c0c35acbd73d28dLennart Poettering <p>La configuration ci-dessus va enregistrer les entr�es de
c2756a68401102786be343712c0c35acbd73d28dLennart Poettering journalisation selon un format connu sous le nom de
c2756a68401102786be343712c0c35acbd73d28dLennart Poettering Common Log Format (CLF) pour "Format de journalisation standard".
c2756a68401102786be343712c0c35acbd73d28dLennart Poettering Ce format standard peut �tre produit par de nombreux serveurs web
c2756a68401102786be343712c0c35acbd73d28dLennart Poettering diff�rents et lu par de nombreux programmes d'analyse de journaux.
c2756a68401102786be343712c0c35acbd73d28dLennart Poettering Les entr�es de fichier journal g�n�r�es selon le format CLF
c2756a68401102786be343712c0c35acbd73d28dLennart Poettering ressemblent � ceci :</p>
c2756a68401102786be343712c0c35acbd73d28dLennart Poettering
c2756a68401102786be343712c0c35acbd73d28dLennart Poettering <div class="example"><p><code>
c2756a68401102786be343712c0c35acbd73d28dLennart Poettering 127.0.0.1 - frank [10/Oct/2000:13:55:36 -0700] "GET
c2756a68401102786be343712c0c35acbd73d28dLennart Poettering /apache_pb.gif HTTP/1.0" 200 2326
c2756a68401102786be343712c0c35acbd73d28dLennart Poettering </code></p></div>
c2756a68401102786be343712c0c35acbd73d28dLennart Poettering
c2756a68401102786be343712c0c35acbd73d28dLennart Poettering <p>Chaque partie de cette entr�e de journal est d�crite
c2756a68401102786be343712c0c35acbd73d28dLennart Poettering dans ce qui suit.</p>
c2756a68401102786be343712c0c35acbd73d28dLennart Poettering
c2756a68401102786be343712c0c35acbd73d28dLennart Poettering <dl>
c2756a68401102786be343712c0c35acbd73d28dLennart Poettering <dt><code>127.0.0.1</code> (<code>%h</code>)</dt>
c2756a68401102786be343712c0c35acbd73d28dLennart Poettering
c2756a68401102786be343712c0c35acbd73d28dLennart Poettering <dd>Il s'agit de l'adresse IP du client (l'h�te distant) qui a envoy�
9f2e86af0600e99cff00d1c92f9bb8d38f29896aLennart Poettering la requ�te au serveur. Si la directive
9f2e86af0600e99cff00d1c92f9bb8d38f29896aLennart Poettering <code class="directive"><a href="/mod/core.html#hostnamelookups">HostnameLookups</a></code> est positionn�e �
9f2e86af0600e99cff00d1c92f9bb8d38f29896aLennart Poettering <code>On</code>, le serveur va essayer de d�terminer le nom de l'h�te
9f2e86af0600e99cff00d1c92f9bb8d38f29896aLennart Poettering et de l'enregistrer � la place de l'adresse IP. Cette configuration
6c12b52e19640747e96f89d85422941a23dc6b29Lennart Poettering n'est cependant pas recommand�e car elle peut ralentir le serveur de
6c12b52e19640747e96f89d85422941a23dc6b29Lennart Poettering mani�re significative. Il est par cons�quent pr�f�rable d'utiliser un
6c12b52e19640747e96f89d85422941a23dc6b29Lennart Poettering processeur d'analyse de journaux a posteriori
6c12b52e19640747e96f89d85422941a23dc6b29Lennart Poettering tel que <code class="program"><a href="/programs/logresolve.html">logresolve</a></code>
6c12b52e19640747e96f89d85422941a23dc6b29Lennart Poettering pour d�terminer les noms d'h�te. L'adresse IP indiqu�e ici n'est pas
6c12b52e19640747e96f89d85422941a23dc6b29Lennart Poettering n�cessairement l'adresse IP de la machine devant laquelle se trouve
6c12b52e19640747e96f89d85422941a23dc6b29Lennart Poettering l'utilisateur. Si un serveur mandataire s'intercale entre le serveur
6c12b52e19640747e96f89d85422941a23dc6b29Lennart Poettering et l'utilisateur, l'adresse indiqu�e sera celle du mandataire et non
6c12b52e19640747e96f89d85422941a23dc6b29Lennart Poettering celle de la machine � l'origine de la requ�te.</dd>
6c12b52e19640747e96f89d85422941a23dc6b29Lennart Poettering
6c12b52e19640747e96f89d85422941a23dc6b29Lennart Poettering <dt><code>-</code> (<code>%l</code>)</dt>
6c12b52e19640747e96f89d85422941a23dc6b29Lennart Poettering
6c12b52e19640747e96f89d85422941a23dc6b29Lennart Poettering <dd>Le "trait d'union" indique que la portion d'information
6c12b52e19640747e96f89d85422941a23dc6b29Lennart Poettering correspondante n'est pas disponible. Dans le cas pr�sent, l'information
6c12b52e19640747e96f89d85422941a23dc6b29Lennart Poettering non disponible est l'identit� (RFC 1413) du client telle que d�termin�e
6c12b52e19640747e96f89d85422941a23dc6b29Lennart Poettering par <code>identd</code> sur la machine cliente. Cette information est
6c12b52e19640747e96f89d85422941a23dc6b29Lennart Poettering tr�s peu fiable et ne devrait jamais �tre utilis�e, sauf dans le cas
6c12b52e19640747e96f89d85422941a23dc6b29Lennart Poettering de r�seaux internes �troitement contr�l�s. Le d�mon httpd ne cherchera
6c12b52e19640747e96f89d85422941a23dc6b29Lennart Poettering d'ailleurs � obtenir cette information que si la directive
6c12b52e19640747e96f89d85422941a23dc6b29Lennart Poettering <code class="directive"><a href="/mod/mod_ident.html#identitycheck">IdentityCheck</a></code> est positionn�e
c2756a68401102786be343712c0c35acbd73d28dLennart Poettering � <code>On</code>.</dd>
c2756a68401102786be343712c0c35acbd73d28dLennart Poettering
c2756a68401102786be343712c0c35acbd73d28dLennart Poettering <dt><code>frank</code> (<code>%u</code>)</dt>
9f2e86af0600e99cff00d1c92f9bb8d38f29896aLennart Poettering
6c12b52e19640747e96f89d85422941a23dc6b29Lennart Poettering <dd>Il s'agit de l'identifiant utilisateur de la personne qui a
6c12b52e19640747e96f89d85422941a23dc6b29Lennart Poettering demand� le document, issu d'une authentification HTTP.
6c12b52e19640747e96f89d85422941a23dc6b29Lennart Poettering Ce m�me identifiant est en g�n�ral fourni aux scripts CGI par
6c12b52e19640747e96f89d85422941a23dc6b29Lennart Poettering l'interm�diaire de la valeur de la variable d'environnement
c2756a68401102786be343712c0c35acbd73d28dLennart Poettering <code>REMOTE_USER</code>. Si le statut de la requ�te (voir plus loin)
c2756a68401102786be343712c0c35acbd73d28dLennart Poettering est 401, cette identifiant n'est pas fiable car l'utilisateur n'est
c2756a68401102786be343712c0c35acbd73d28dLennart Poettering pas encore authentifi�. Si le document n'est pas prot�g� par
6c12b52e19640747e96f89d85422941a23dc6b29Lennart Poettering mot de passe, cette partie d'information sera repr�sent�e par
6c12b52e19640747e96f89d85422941a23dc6b29Lennart Poettering "<code>-</code>", comme la partie pr�c�dente.</dd>
6c12b52e19640747e96f89d85422941a23dc6b29Lennart Poettering
c2756a68401102786be343712c0c35acbd73d28dLennart Poettering <dt><code>[10/Oct/2000:13:55:36 -0700]</code>
c2756a68401102786be343712c0c35acbd73d28dLennart Poettering (<code>%t</code>)</dt>
c2756a68401102786be343712c0c35acbd73d28dLennart Poettering
c2756a68401102786be343712c0c35acbd73d28dLennart Poettering <dd>
c2756a68401102786be343712c0c35acbd73d28dLennart Poettering L'heure � laquelle la requ�te a �t� re�ue.
c9d954b27ee125c3c90a6d2951c62eec4abb160bZbigniew Jędrzejewski-Szmek Le format est le suivant :
c2756a68401102786be343712c0c35acbd73d28dLennart Poettering
c2756a68401102786be343712c0c35acbd73d28dLennart Poettering <p class="indent">
c2756a68401102786be343712c0c35acbd73d28dLennart Poettering <code>[jour/mois/ann�e:heure:minutes:secondes zone]<br />
c2756a68401102786be343712c0c35acbd73d28dLennart Poettering jour = 2*chiffre<br />
c2756a68401102786be343712c0c35acbd73d28dLennart Poettering mois = 3*lettre<br />
6c12b52e19640747e96f89d85422941a23dc6b29Lennart Poettering ann�e = 4*chiffre<br />
6c12b52e19640747e96f89d85422941a23dc6b29Lennart Poettering heure = 2*chiffre<br />
c2756a68401102786be343712c0c35acbd73d28dLennart Poettering minutes = 2*chiffre<br />
c2756a68401102786be343712c0c35acbd73d28dLennart Poettering secondes = 2*chiffre<br />
c9d954b27ee125c3c90a6d2951c62eec4abb160bZbigniew Jędrzejewski-Szmek zone = (`+' | `-') 4*chiffre</code>
c9d954b27ee125c3c90a6d2951c62eec4abb160bZbigniew Jędrzejewski-Szmek </p>Il est possible de modifier le format d'affichage de l'heure
c9d954b27ee125c3c90a6d2951c62eec4abb160bZbigniew Jędrzejewski-Szmek en sp�cifiant <code>%{format}t</code> dans la cha�ne de format du
c9d954b27ee125c3c90a6d2951c62eec4abb160bZbigniew Jędrzejewski-Szmek journal, o� <code>format</code> est une cha�ne de format
c9d954b27ee125c3c90a6d2951c62eec4abb160bZbigniew Jędrzejewski-Szmek de la forme de celle de la fonction <code>strftime(3)</code>
c9d954b27ee125c3c90a6d2951c62eec4abb160bZbigniew Jędrzejewski-Szmek de la biblioth�que C standard, ou choisie parmi les
c9d954b27ee125c3c90a6d2951c62eec4abb160bZbigniew Jędrzejewski-Szmek formats sp�ciaux support�s. Pour plus de d�tails,
9f2e86af0600e99cff00d1c92f9bb8d38f29896aLennart Poettering reportez-vous aux. <a href="mod/mod_log_config.html#formats">cha�nes de format</a>
9f2e86af0600e99cff00d1c92f9bb8d38f29896aLennart Poettering de <code class="module"><a href="/mod/mod_log_config.html">mod_log_config</a></code>.
9f2e86af0600e99cff00d1c92f9bb8d38f29896aLennart Poettering </dd>
9f2e86af0600e99cff00d1c92f9bb8d38f29896aLennart Poettering
9f2e86af0600e99cff00d1c92f9bb8d38f29896aLennart Poettering <dt><code>"GET /apache_pb.gif HTTP/1.0"</code>
9f2e86af0600e99cff00d1c92f9bb8d38f29896aLennart Poettering (<code>\"%r\"</code>)</dt>
9f2e86af0600e99cff00d1c92f9bb8d38f29896aLennart Poettering
9f2e86af0600e99cff00d1c92f9bb8d38f29896aLennart Poettering <dd>La ligne de la requ�te du client est plac�e entre guillemets.
9f2e86af0600e99cff00d1c92f9bb8d38f29896aLennart Poettering Elle contient de nombreuses informations utiles. Tout d'abord, la
9f2e86af0600e99cff00d1c92f9bb8d38f29896aLennart Poettering m�thode utilis�e par le client est <code>GET</code>. Ensuite, le
6c12b52e19640747e96f89d85422941a23dc6b29Lennart Poettering client a demand� la ressource <code>/apache_pb.gif</code>, et enfin,
6c12b52e19640747e96f89d85422941a23dc6b29Lennart Poettering le client a utilis� le protocole <code>HTTP/1.0</code>. Il est aussi
6c12b52e19640747e96f89d85422941a23dc6b29Lennart Poettering possible d'enregistrer s�par�ment une ou plusieurs parties de la
6c12b52e19640747e96f89d85422941a23dc6b29Lennart Poettering requ�te. Par exemple, la cha�ne de format "<code>%m %U %q %H</code>"
c2756a68401102786be343712c0c35acbd73d28dLennart Poettering va enregistrer la m�thode, le chemin, la cha�ne de la requ�te et le
6c12b52e19640747e96f89d85422941a23dc6b29Lennart Poettering protocole, ce qui donnera le m�me r�sultat que
c2756a68401102786be343712c0c35acbd73d28dLennart Poettering "<code>%r</code>".</dd>
c2756a68401102786be343712c0c35acbd73d28dLennart Poettering
c2756a68401102786be343712c0c35acbd73d28dLennart Poettering <dt><code>200</code> (<code>%&gt;s</code>)</dt>
6c12b52e19640747e96f89d85422941a23dc6b29Lennart Poettering
6c12b52e19640747e96f89d85422941a23dc6b29Lennart Poettering <dd>C'est le code de statut que le serveur retourne au client. Cette
6c12b52e19640747e96f89d85422941a23dc6b29Lennart Poettering information est tr�s importante car elle indique si la requ�te a fait
6c12b52e19640747e96f89d85422941a23dc6b29Lennart Poettering l'objet d'une r�ponse positive (codes commen�ant par 2), une
c2756a68401102786be343712c0c35acbd73d28dLennart Poettering redirection (codes commen�ant par 3), une erreur due au client (codes
9f2e86af0600e99cff00d1c92f9bb8d38f29896aLennart Poettering commen�ant par 4), ou une erreur due au serveur (codes commen�ant
c2756a68401102786be343712c0c35acbd73d28dLennart Poettering par 5). Vous trouverez la liste compl�te des codes de statut possibles
c2756a68401102786be343712c0c35acbd73d28dLennart Poettering dans la <a href="http://www.w3.org/Protocols/rfc2616/ rfc2616.txt">specification HTTP</a> (RFC2616 section 10).</dd>
c2756a68401102786be343712c0c35acbd73d28dLennart Poettering
c2756a68401102786be343712c0c35acbd73d28dLennart Poettering <dt><code>2326</code> (<code>%b</code>)</dt>
c2756a68401102786be343712c0c35acbd73d28dLennart Poettering
c2756a68401102786be343712c0c35acbd73d28dLennart Poettering <dd>La derni�re partie indique la taille de l'objet retourn� au client,
c2756a68401102786be343712c0c35acbd73d28dLennart Poettering en-t�tes non compris. Si aucun contenu n'a �t� retourn� au client, cette
partie contiendra "<code>-</code>". Pour indiquer l'absence de contenu
par "<code>0</code>", utilisez <code>%B</code> au lieu de
<code>%b</code>.</dd>
</dl>
<h3><a name="combined" id="combined">Combined Log Format (Format de journalisation combin�)</a></h3>
<p>Une autre cha�ne de format couramment utilis�e est le
"Combined Log Format" (Format de journalisation combin�). Il s'utilise
comme suit :</p>
<div class="example"><p><code>
LogFormat "%h %l %u %t \"%r\" %&gt;s %b \"%{Referer}i\"
\"%{User-agent}i\"" combined<br />
CustomLog log/access_log combined
</code></p></div>
<p>Ce format est identique au Common Log Format, avec deux champs
suppl�mentaires. Chacun de ces deux champs utilise la directive
commen�ant par le caract�re "%" <code>%{<em>header</em>}i</code>,
o� <em>header</em> peut �tre n'importe quel en-t�te de requ�te HTTP.
Avec ce format, le journal des acc�s se pr�sentera comme suit :</p>
<div class="example"><p><code>
127.0.0.1 - frank [10/Oct/2000:13:55:36 -0700] "GET
/apache_pb.gif HTTP/1.0" 200 2326
"http://www.example.com/start.html" "Mozilla/4.08 [en]
(Win98; I ;Nav)"
</code></p></div>
<p>Les champs suppl�mentaires sont :</p>
<dl>
<dt><code>"http://www.example.com/start.html"</code>
(<code>\"%{Referer}i\"</code>)</dt>
<dd>L'en-t�te "Referer" (sic) de la requ�te HTTP. Il indique le site
depuis lequel le client pr�tend avoir lanc� sa requ�te. (Ce doit �tre
la page qui contient un lien vers <code>/apache_pb.gif</code> ou
inclut ce dernier fichier).</dd>
<dt><code>"Mozilla/4.08 [en] (Win98; I ;Nav)"</code>
(<code>\"%{User-agent}i\"</code>)</dt>
<dd>L'en-t�te User-Agent de la requ�te HTTP. C'est une information
d'identification que le navigateur du client envoie � propos
de lui-m�me.</dd>
</dl>
<h3><a name="multiple" id="multiple">Journaux d'acc�s multiples</a></h3>
<p>Plusieurs journaux d'acc�s peuvent �tre cr��s en sp�cifiant tout
simplement plusieurs directives
<code class="directive"><a href="/mod/mod_log_config.html#customlog">CustomLog</a></code> dans le
fichier de configuration. Par exemple, les directives suivantes vont
cr�er trois journaux d'acc�s. Le premier contiendra les informations
de base CLF, le second les informations du Referer, et le troisi�me
les informations sur le navigateur. Les deux derni�res directives
<code class="directive"><a href="/mod/mod_log_config.html#customlog">CustomLog</a></code> montrent
comment simuler les effets des directives <code>ReferLog</code> et
<code>AgentLog</code>.</p>
<div class="example"><p><code>
LogFormat "%h %l %u %t \"%r\" %&gt;s %b" common<br />
CustomLog logs/access_log common<br />
CustomLog logs/referer_log "%{Referer}i -&gt; %U"<br />
CustomLog logs/agent_log "%{User-agent}i"
</code></p></div>
<p>Cet exemple montre aussi qu'il n'est pas obligatoire d'associer
une cha�ne de format � un alias au moyen de la directive
<code class="directive"><a href="/mod/mod_log_config.html#logformat">LogFormat</a></code>. Elle peut
�tre d�finie directement dans la ligne de la directive
<code class="directive"><a href="/mod/mod_log_config.html#customlog">CustomLog</a></code>.</p>
<h3><a name="conditional" id="conditional">Journalisation conditionnelle</a></h3>
<p>Il est parfois souhaitable d'exclure certaines entr�es des journaux
d'acc�s en fonction des caract�ristiques de la requ�te du client. On
peut ais�ment accomplir ceci � l'aide des
<a href="env.html">variables d'environnement</a>. Tout d'abord, une
variable d'environnement doit �tre d�finie pour indiquer que la
requ�te remplit certaines conditions. Pour ceci, on utilise en g�n�ral
la directive <code class="directive"><a href="/mod/mod_setenvif.html#setenvif">SetEnvIf</a></code>,
puis la clause <code>env=</code> de la directive
<code class="directive"><a href="/mod/mod_log_config.html#customlog">CustomLog</a></code> pour inclure
ou exclure les requ�tes pour lesquelles
la variable d'environnement est d�finie.
Quelques exemples :</p>
<div class="example"><p><code>
# Marque les requ�tes en provenance de l'interface loop-back<br />
SetEnvIf Remote_Addr "127\.0\.0\.1" dontlog<br />
# Marque les requ�tes pour le fichier robots.txt<br />
SetEnvIf Request_URI "^/robots\.txt$" dontlog<br />
# Journalise toutes les autres requ�tes<br />
CustomLog logs/access_log common env=!dontlog
</code></p></div>
<p>Autre exemple, imaginons l'enregistrement des requ�tes en provenance
d'utilisateurs de langue anglaise dans un journal, et celles des autres
utilisateurs dans un autre journal.</p>
<div class="example"><p><code>
SetEnvIf Accept-Language "en" english<br />
CustomLog logs/english_log common env=english<br />
CustomLog logs/non_english_log common env=!english
</code></p></div>
<p>Dans le contexte d'une mise en cache, il peut �tre
int�ressant de conna�tre l'efficacit� du cache. Pour y parvenir,
on pourrait utiliser cette m�thode simple :</p>
<div class="example"><p><code>
SetEnv CACHE_MISS 1<br />
LogFormat "%h %l %u %t "%r " %&gt;s %b %{CACHE_MISS}e" common-cache<br />
CustomLog logs/access_log common-cache
</code></p></div>
<p><code class="module"><a href="/mod/mod_cache.html">mod_cache</a></code> va s'ex�cuter avant
<code class="module"><a href="/mod/mod_env.html">mod_env</a></code>, et si son action est couronn�e de
succ�s, il d�livrera le contenu sans faire appel � ce dernier. Si
l'URL se trouve dans le cache, la valeur journalis�e sera alors
<code>-</code>, tandis que dans le cas contraire elle sera
<code>1</code>.</p>
<p>En plus de la syntaxe <code>env=</code>, la directive <code class="directive"><a href="/mod/mod_log_config.html#logformat">LogFormat</a></code> supporte les
valeurs de journalisation conditionnelles bas�es sur le code de la
r�ponse HTTP :</p>
<div class="example"><p><code>
LogFormat "%400,501{User-agent}i" browserlog<br />
LogFormat "%!200,304,302{Referer}i" refererlog
</code></p></div>
<p>Dans le premier exemple, le <code>User-agent</code> sera
enregistr� si le code d'�tat HTTP est 400 ou 501. Dans le cas
contraire, c'est un caract�re "-" qui sera enregistr� � la place.
Dans le second exemple, le <code>Referer</code> sera enregistr� si
le code d'�tat HTTP n'est <strong>pas</strong> 200, 204, ou 302
(remarquez le caract�re "!" avant les codes d'�tat).</p>
<p>Bien que nous venions de montrer que la journalisation conditionnelle
est souple et tr�s puissante, cette m�thode de contr�le du contenu des
journaux n'est pas la seule. Les fichiers journaux sont plus utiles
quand ils contiennent un enregistrement complet de l'activit� du serveur,
et il est souvent plus ais� de simplement traiter � posteriori les fichiers
journaux pour supprimer les requ�tes que vous ne voulez pas y voir
appara�tre.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
<div class="section">
<h2><a name="rotation" id="rotation">Rotation des journaux</a></h2>
<p>M�me dans le cas d'un serveur mod�r�ment sollicit�, la quantit�
d'informations stock�es dans les fichiers journaux est tr�s importante.
Le fichier journal des acc�s grossit en g�n�ral d'1 Mo ou plus toutes
les 10000 requ�tes. Il est par cons�quent n�cessaire d'effectuer
p�riodiquement la rotation des journaux en d�pla�ant ou supprimant les
fichiers correspondants. On ne peut pas le faire pendant que le serveur
est en cours d'ex�cution, car Apache httpd va continuer � �crire dans l'ancien
fichier journal aussi longtemps qu'il le maintiendra ouvert.
C'est pourquoi le serveur doit �tre
<a href="stopping.html">red�marr�</a> apr�s le d�placement ou la
suppression des fichiers journaux de fa�on � ce qu'il en ouvre
de nouveaux.</p>
<p>Avec un red�marrage <em>graceful</em>, on peut faire en sorte que le
serveur ouvre de nouveaux fichiers journaux sans perdre de connexions
existantes ou en cours avec les clients. Cependant, pour que ceci soit
possible, le serveur doit continuer � �crire dans les anciens fichiers
journaux pendant qu'il termine le traitement des requ�tes en cours.
Il est donc n�cessaire d'attendre un certain temps apr�s le r�d�marrage
avant d'effectuer tout traitement sur les fichiers journaux. Voici un
sc�nario typique dans lequel on effectue une simple rotation des
journaux en compressant les anciens fichiers correspondants afin
de gagner de l'espace disque :</p>
<div class="example"><p><code>
mv access_log access_log.old<br />
mv error_log error_log.old<br />
apachectl graceful<br />
sleep 600<br />
gzip access_log.old error_log.old
</code></p></div>
<p>La section suivante pr�sente une autre m�thode de rotation des journaux
qui consiste � utiliser les
<a href="#piped">journaux redirig�s</a>.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
<div class="section">
<h2><a name="piped" id="piped">Journaux redirig�s</a></h2>
<p>Nous avons vu que le d�mon httpd �crivait les informations de
journalisation des erreurs et des acc�s dans un fichier journal ;
il peut aussi
rediriger ces informations vers un autre processus par l'interm�diaire d'un
tube de communication (pipe). Cette fonctionnalit� am�liore
consid�rablement la souplesse de la journalisation, sans ajouter de code
au serveur principal. Pour rediriger les informations de journalisation
vers un tube de communication, remplacez simplement le nom de fichier
journal par
le caract�re pipe "<code>|</code>", suivi du nom de l'ex�cutable qui va
recueillir les entr�es de journal sur son entr�e
standard. Le serveur va
lancer le processus de redirection des journaux au moment du d�marrage du
serveur, et le relancera s'il cesse de fonctionner
pendant l'ex�cution du serveur.
(Nous d�nommons cette technique "journalisation
redirig�e fiable" gr�ce � cette derni�re fonctionnalit�.)</p>
<p>Les processus de journalisation redirig�e sont lanc�s par le processus
httpd parent, et h�ritent de l'UID de ce dernier. Cela signifie que les
programmes de journalisation dirig�e s'ex�cutent g�n�ralement en tant que
root. Il est donc tr�s important que ces programmes soient simples et
s�curis�s.</p>
<p>Un des grands avantages de la journalisation redirig�e est la possibilit�
d'effectuer la rotation des journaux sans avoir � red�marrer le serveur. Pour
accomplir cette t�che, le serveur HTTP Apache fournit un programme simple
appel� <code class="program"><a href="/programs/rotatelogs.html">rotatelogs</a></code>. Par exemple, pour une rotation des
journaux toutes les 24 heures, ajoutez ces lignes :</p>
<div class="example"><p><code>
CustomLog "|/usr/local/apache/bin/rotatelogs
/var/log/access_log 86400" common
</code></p></div>
<p>Notez que l'ensemble de la commande qui sera appel�e par le tube de
communication a �t� plac�e entre guillemets. Bien que cet exemple
concerne le journal des acc�s, la m�me technique peut �tre utilis�e
pour le journal des erreurs.</p>
<p>Il existe un autre programme de rotation des journaux similaire mais
beaucoup plus souple : il s'agit de "cronolog", non fourni par Apache,
mais disponible <a href="http://www.cronolog.org/">ici</a>.</p>
<p>Comme la journalisation conditionnelle, la journalisation redirig�e est
un outil tr�s puissant, mais si elle existe, il est pr�f�rable d'utiliser
une solution plus simple comme le traitement � posteriori hors ligne.</p>
<p>Par d�faut, le processus de redirection du journal est lanc� sans
invoquer un shell. Pour invoquer un shell, utilisez "<code>|$</code>"
au lieu de "<code>|</code>" (en g�n�ral avec <code>/bin/sh -c</code>)
:</p>
<div class="example"><p><code>
# Invocation de "rotatelogs" en utilisant un shell<br />
CustomLog "|$/usr/local/apache/bin/rotatelogs
/var/log/access_log 86400" common
</code></p></div>
<p>Il s'agissait du comportement par d�faut sous Apache 2.2. Selon
les sp�cificit�s du shell, ceci peut g�n�rer un processus shell
suppl�mentaire pour toute la dur�e du programme de redirection du
journal, et induire des probl�mes de gestion de signaux au cours du
red�marrage. La notation "<code>||</code>" est aussi support�e pour
des raisons de compatibilit� avec Apache 2.2 et est �quivalente �
"<code>|</code>".</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
<div class="section">
<h2><a name="virtualhost" id="virtualhost">H�tes virtuels</a></h2>
<p>Lorsqu'un serveur poss�de plusieurs <a href="vhosts/">h�tes virtuels</a>, il existe de nombreuses solutions pour g�rer
les fichiers journaux. Par exemple, on peut utiliser les journaux comme
s'il s'agissait d'un serveur avec un seul h�te. Il suffit pour cela de
placer les directives de journalisation en dehors des sections
<code class="directive"><a href="/mod/core.html#virtualhost">&lt;VirtualHost&gt;</a></code> au niveau
du serveur principal, ce qui a pour effet de journaliser toutes les
requ�tes dans le m�me journal des acc�s et des erreurs. Cette technique
est cependant inappropri�e pour recueillir des statistiques sur chaque
h�te virtuel individuellement.</p>
<p>Si des directives <code class="directive"><a href="/mod/mod_log_config.html#customlog">CustomLog</a></code> ou
<code class="directive"><a href="/mod/core.html#errorlog">ErrorLog</a></code> sont plac�es dans une section
<code class="directive"><a href="/mod/core.html#virtualhost">&lt;VirtualHost&gt;</a></code>, toutes les
requ�tes ou erreurs pour cet h�te virtuel ne seront enregistr�es que dans
le fichier sp�cifi�. Tout h�te virtuel qui ne poss�de pas de directives de
journalisation verra ses requ�tes enregistr�es dans le journal du serveur
principal. Cette technique est appropri�e pour un petit nombre d'h�tes
virtuels, mais si ce nombre est important, elle peut devenir compliqu�e �
g�rer. En outre, des probl�mes de <a href="vhosts/fd-limits.html">nombre de descripteurs
de fichiers insuffisant</a> peuvent rapidement appara�tre.</p>
<p>Il existe un tr�s bon compromis pour le journal des acc�s. En int�grant
les informations � propos de l'h�te virtuel � la cha�ne de format du
journal, il est possible de journaliser tous les h�tes dans le m�me
journal, puis de s�parer ult�rieurement le journal en plusieurs journaux
individuels. Consid�rons par exemple les directives suivantes :</p>
<div class="example"><p><code>
LogFormat "%v %l %u %t \"%r\" %&gt;s %b"
comonvhost<br />
CustomLog logs/access_log comonvhost
</code></p></div>
<p>Le champ <code>%v</code> sert � enregistrer le nom de l'h�te virtuel qui
traite la requ�te. Un programme tel que <a href="programs/other.html">split-logfile</a> peut ensuite �tre utilis�
pour g�n�rer "� froid" autant de journaux que d'h�tes virtuels.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
<div class="section">
<h2><a name="other" id="other">Autres fichiers journaux</a></h2>
<table class="related"><tr><th>Modules Apparent�s</th><th>Directives Apparent�es</th></tr><tr><td><ul><li><code class="module"><a href="/mod/mod_logio.html">mod_logio</a></code></li><li><code class="module"><a href="/mod/mod_log_config.html">mod_log_config</a></code></li><li><code class="module"><a href="/mod/mod_log_forensic.html">mod_log_forensic</a></code></li><li><code class="module"><a href="/mod/mod_cgi.html">mod_cgi</a></code></li></ul></td><td><ul><li><code class="directive"><a href="/mod/mod_log_config.html#logformat">LogFormat</a></code></li><li><code class="directive"><a href="/mod/mod_log_config.html#bufferedlogs">BufferedLogs</a></code></li><li><code class="directive"><a href="/mod/mod_log_forensic.html#forensiclog">ForensicLog</a></code></li><li><code class="directive"><a href="/mod/mpm_common.html#pidfile">PidFile</a></code></li><li><code class="directive"><a href="/mod/mod_cgi.html#scriptlog">ScriptLog</a></code></li><li><code class="directive"><a href="/mod/mod_cgi.html#scriptlogbuffer">ScriptLogBuffer</a></code></li><li><code class="directive"><a href="/mod/mod_cgi.html#scriptloglength">ScriptLogLength</a></code></li></ul></td></tr></table>
<h3>Enregistrement du nombre r�el d'octets envoy�s et re�us</h3>
<p>Le module <code class="module"><a href="/mod/mod_logio.html">mod_logio</a></code> fournit deux champs
<code class="directive"><a href="/mod/mod_log_config.html#logformat">LogFormat</a></code> suppl�mentaires
(%I et %O) qui permettent d'enregistrer le nombre r�el d'octets re�us et
envoy�s sur le r�seau.</p>
<h3>Journalisation de style investigation judiciaire (forensic logging)</h3>
<p>Le module <code class="module"><a href="/mod/mod_log_forensic.html">mod_log_forensic</a></code> permet la journalisation
� des fins d'investigation judiciaire des requ�tes des clients. La
journalisation est effectu�e avant et apr�s le traitement de la requ�te,
qui fait donc l'objet de deux entr�es dans le journal. Le g�n�rateur de
journaux d'investigation est tr�s strict et ne permet aucune
personnalisation. C'est un inestimable outil de d�bogage et de s�curit�.</p>
<h3><a name="pidfile" id="pidfile">Fichier PID</a></h3>
<p>Au d�marrage, le d�mon httpd Apache enregistre l'identifiant du
processus httpd parent dans le fichier <code>logs/httpd.pid</code>.
Le nom de ce fichier peut �tre modifi� � l'aide de la directive
<code class="directive"><a href="/mod/mpm_common.html#pidfile">PidFile</a></code>. Cet identifiant
permet � l'administrateur de red�marrer et arr�ter le d�mon en
envoyant des signaux au processus parent ; sous Windows, vous devez
utiliser l'option de ligne de commande -k. Pour plus de d�tails,
consulter la page <a href="stopping.html">Arr�t et red�marrage</a>.</p>
<h3><a name="scriptlog" id="scriptlog">Journal des scripts</a></h3>
<p>Afin de faciliter le d�bogage, la directive
<code class="directive"><a href="/mod/mod_cgi.html#scriptlog">ScriptLog</a></code> vous permet
d'enregistrer les entr�es et sorties des scripts CGI. Elle ne doit �tre
utilis�e que pendant la phase de test, et en aucun cas sur un
serveur en production. Vous trouverez plus d'informations dans la
documentation du module <a href="mod/mod_cgi.html">mod_cgi</a>.</p>
</div></div>
<div class="bottomlang">
<p><span>Langues Disponibles: </span><a href="/en/logs.html" hreflang="en" rel="alternate" title="English">&nbsp;en&nbsp;</a> |
<a href="/fr/logs.html" title="Fran�ais">&nbsp;fr&nbsp;</a> |
<a href="/ja/logs.html" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&nbsp;</a> |
<a href="/ko/logs.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</a> |
<a href="/tr/logs.html" hreflang="tr" rel="alternate" title="T�rk�e">&nbsp;tr&nbsp;</a></p>
</div><div id="footer">
<p class="apache">Copyright 2012 The Apache Software Foundation.<br />Autoris� sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
<p class="menu"><a href="/mod/">Modules</a> | <a href="/mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="/glossary.html">Glossaire</a> | <a href="/sitemap.html">Plan du site</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== undefined) {
prettyPrint();
}
//--><!]]></script>
</body></html>