summaryrefslogtreecommitdiff
path: root/docs/manual/mod/mod_log_config.html.fr
diff options
context:
space:
mode:
authorArno Töll <arno@debian.org>2013-12-23 23:50:09 -1100
committerArno Töll <arno@debian.org>2013-12-23 23:50:09 -1100
commit86d5cc79d9d6750da8771fdb0c9ab22c19b8ad45 (patch)
tree5037da70bf37c0ee93f0ea09f054bdfb278befe0 /docs/manual/mod/mod_log_config.html.fr
parent4a336a5b117419c33c29eadd6409c69df78cd586 (diff)
downloadapache2-86d5cc79d9d6750da8771fdb0c9ab22c19b8ad45.tar.gz
Imported Upstream version 2.4.7upstream/2.4.7
Diffstat (limited to 'docs/manual/mod/mod_log_config.html.fr')
-rw-r--r--docs/manual/mod/mod_log_config.html.fr104
1 files changed, 49 insertions, 55 deletions
diff --git a/docs/manual/mod/mod_log_config.html.fr b/docs/manual/mod/mod_log_config.html.fr
index 79f631ed..8cdde924 100644
--- a/docs/manual/mod/mod_log_config.html.fr
+++ b/docs/manual/mod/mod_log_config.html.fr
@@ -42,7 +42,7 @@ serveur</td></tr>
personnalisable, et peuvent être enregistrés directement dans un
fichier, ou redirigés vers un programme externe. La journalisation
conditionnelle est supportée, si bien que des requêtes individuelles
- peuvent être incluses ou exclues des journaux en fonction de leurs
+ peuvent être incluses ou exclues des journaux en fonction de leur
caractéristiques.</p>
<p>Ce module fournit trois directives : <code class="directive"><a href="#transferlog">TransferLog</a></code> crée un fichier
@@ -79,7 +79,7 @@ d'Apache</a></li>
requêtes dans le fichier journal. Elle peut contenir des caractères
littéraux qui seront reproduits dans le fichier journal, et les
caractères de contrôle de style C "\n" et "\t" représentant
- respectivement un saut à la ligne et une tabulation. Les guillemets
+ respectivement une nouvelle ligne et une tabulation. Les guillemets
et les anti-slashes littéraux doivent être échappés à l'aide
d'anti-slashes.</p>
@@ -93,9 +93,10 @@ d'Apache</a></li>
<tr><td><code>%%</code></td>
<td>Le signe "pourcentage"</td></tr>
<tr class="odd"><td><code>%a</code></td>
- <td>Le port et l'adresse IP distants</td></tr>
+ <td>L'adresse IP distante (voir le module
+ <code class="module"><a href="../mod/mod_remoteip.html">mod_remoteip</a></code>).</td></tr>
<tr><td><code>%{c}a</code></td>
- <td>Port et adresse IP distants sous-jacents de la connexion (voir le module
+ <td>Adresse IP distante de la connexion(voir le module
<code class="module"><a href="../mod/mod_remoteip.html">mod_remoteip</a></code>)</td></tr>
<tr class="odd"><td><code>%A</code></td>
<td>L'adresse IP locale</td></tr>
@@ -104,8 +105,8 @@ d'Apache</a></li>
HTTP.</td></tr>
<tr class="odd"><td><code>%b</code></td>
<td>La taille de la réponse en octets, en excluant les en-têtes
- HTTP. Au format <code>"Common Log Format" (CLF)</code> , c'est à dire
- un '<code>-</code>' à la place d'un 0 lorsqu'aucun octet n'est renvoyé.</td></tr>
+ HTTP. Au format CLF , c'est à dire un '<code>-</code>' à la
+ place d'un 0 lorsqu'aucun octet n'est renvoyé.</td></tr>
<tr><td><code>%{<var>NOMVAR</var>}C</code></td>
<td>Le contenu du cookie <var>NOMVAR</var> dans la requête
envoyée au serveur. Seuls les cookies version 0 sont pleinement
@@ -119,10 +120,10 @@ d'Apache</a></li>
<tr class="odd"><td><code>%f</code></td>
<td>Nom de fichier</td></tr>
<tr><td><code>%h</code></td>
- <td>Nom de l'hôte distant. Contiendra son adresse IP si la directive
+ <td>Serveur distant. Contiendra l'adresse IP si la directive
<code class="directive"><a href="../mod/core.html#hostnamelookups">HostnameLookups</a></code> est définie
à <code>Off</code>, ce qui est sa valeur par défaut. Si cette
- adresse IP n'est enregistrée que pour certains hôtes, vous
+ adresse IP n'est enregistrée que pour certains serveurs, vous
avez probablement défini des directives de contrôle d'accès qui
mentionnent ces derniers par leurs noms. Voir la <a href="mod_authz_host.html#reqhost">documentation de Require
host</a>.</td></tr>
@@ -131,10 +132,10 @@ d'Apache</a></li>
<tr><td><code>%{<var>NOMVAR</var>}i</code></td>
<td>Le contenu des lignes d'en-tête
<code><var>NOMVAR</var>:</code> dans la requête envoyée au
- serveur. Ces en-têtes peuvent avoir été modifiés par d'autres
- modules (par exemple <code class="module"><a href="../mod/mod_headers.html">mod_headers</a></code>). Si vous
- êtes intéressé par ce qu'était l'en-tête de la requête avant
- d'être modifié par la plupart des modules, utilisez
+ serveur. Ces en-têtes sont ajoutés par d'autres modules (par
+ exemple <code class="module"><a href="../mod/mod_headers.html">mod_headers</a></code>). Si vous êtes intéressé
+ par ce qu'était l'en-tête de la requête avant d'être modifié
+ par la plupart des modules, utilisez
<code class="module"><a href="../mod/mod_setenvif.html">mod_setenvif</a></code> pour copier l'en-tête dans une
variable d'environnement interne et journaliser sa valeur via
le champ <code>%{<var>VARNAME</var>}e</code> décrit plus haut.
@@ -142,7 +143,7 @@ d'Apache</a></li>
</td></tr>
<tr class="odd"><td><code>%k</code></td>
<td>Nombre de requêtes persistantes en cours pour cette
- connexion. Intéressant si la directive <code class="directive"><a href="../mod/core.html#keepalive">KeepAlive</a></code> est utilisée ; par exemple,
+ connexion. Interessant si la directive <code class="directive"><a href="../mod/core.html#keepalive">KeepAlive</a></code> est utilisée ; par exemple,
'1' signifie la première requête après la requête initiale, '2'
la seconde, etc... ; autrement, il s'agit toujours de 0
(indiquant la requête initiale).</td></tr>
@@ -192,18 +193,18 @@ d'Apache</a></li>
du statut de la requête *originale* --- <code>%&gt;s</code> pour
la dernière.</td></tr>
<tr class="odd"><td><code>%t</code></td>
- <td>Date à laquelle la requête a été reçue (au format [18/Sep/2011:19:18:28 -0400])
- Le dernier nombre indique le décalage horaire par rapport à l'heure GMT.</td></tr>
+ <td>Date à laquelle la requête a été reçue (au format anglais
+ standard)</td></tr>
<tr><td><code>%{<var>format</var>}t</code></td>
<td>La date, sous la forme spécifiée par format, qui devrait
- être au format étendu <code>strftime(3)</code> (possiblement
+ être au format étendu <code>strftime(3)</code> (éventuellement
localisé). Si le format commence par <code>begin:</code> (valeur
par défaut), la date est extraite au début du traitement de la
requête ; s'il commence par <code>end:</code>, la date
correspond au moment où l'entrée du journal est inscrite, par
conséquent vers la fin du traitement de la requête. Hormis les
formats supportés par <code>strftime(3)</code>, les formats
- suivants sont également disponibles :
+ suivants sont aussi disponibles :
<table>
<tr><td><code>sec</code></td><td>nombre de secondes depuis Epoch</td></tr>
<tr><td><code>msec</code></td><td>nombre de millisecondes depuis Epoch</td></tr>
@@ -213,26 +214,25 @@ d'Apache</a></li>
</table>
Ces symboles ne peuvent pas être combinés entre eux ou avec un
formatage <code>strftime(3)</code> dans la même chaîne de
- format. Vous pouvez en revanche utiliser plusieurs symboles
+ format. Par contre, vous pouvez utiliser plusieurs symboles
<code>%{<var>format</var>}t</code>.</td></tr>
<tr class="odd"><td><code>%T</code></td>
<td>Le temps mis pour servir la requête, en secondes.</td></tr>
<tr><td><code>%u</code></td>
- <td>Le nom d'utilisateur distant, si la requête a fait l'objet d'une
- authentification par le client (ce champ peut être considéré comme
- erroné ou sans intérêt si le statut de retour (<code>%s</code>) est
- 401).</td></tr>
+ <td>L'utilisateur distant (en provenance d'auth ; peut être faux
+ si le statut de retour (<code>%s</code>) est 401).</td></tr>
<tr class="odd"><td><code>%U</code></td>
<td>Le chemin de la requête, à l'exclusion de toute chaîne
- d'arguments ("<code>query string</code>").</td></tr>
+ d'arguments.</td></tr>
<tr><td><code>%v</code></td>
<td>Le nom canonique du serveur qui a servi la requête, défini
par la directive <code class="directive"><a href="../mod/core.html#servername">ServerName</a></code>.</td></tr>
<tr class="odd"><td><code>%V</code></td>
- <td>Le nom du serveur en tenant compte de la définition de la
+ <td>La nom du serveur en tenant compte de la définition de la
directive <code class="directive"><a href="../mod/core.html#usecanonicalname">UseCanonicalName</a></code>.</td></tr>
<tr><td><code>%X</code></td>
- <td>Statut de la connexion lorsque la réponse a été renvoyée :
+ <td>Statut de la connexion lorsque la réponse a été renvoyée
+ :
<table>
@@ -252,9 +252,15 @@ d'Apache</a></li>
en-têtes, ne peut être nul. Nécessite l'activation de
<code class="module"><a href="../mod/mod_logio.html">mod_logio</a></code>.</td></tr>
<tr><td><code>%O</code></td>
- <td>Le nombre d'octets envoyés, y compris les en-têtes, ne peut
+ <td>Nombre d'octets envoyés, y compris les en-têtes, ne peut
être nul. Nécessite l'activation de
<code class="module"><a href="../mod/mod_logio.html">mod_logio</a></code>.</td></tr>
+<tr class="odd"><td><code>%S</code></td>
+ <td>Nombre d'octets transmis (en émission et réception), y
+ compris corps et en-têtes de requête. Ce nombre ne peut pas être
+ nul, et il correspond à la combinaison des formats %I et %O.
+ <code class="module"><a href="../mod/mod_logio.html">mod_logio</a></code> doit être chargé pour pouvoir
+ utiliser ce format.</td></tr>
</table>
<h3><a name="modifiers" id="modifiers">Modificateurs</a></h3>
@@ -263,24 +269,14 @@ d'Apache</a></li>
éléments
en fonction du code de statut de la réponse, en insérant une liste
de codes de statut séparés par des virgules immédiatement après le
- caractère "%". La liste des codes de statut peut être précédée
- d'un "<code>!</code>" pour formuler une négation.</p>
-
- <table class="bordered"><tr class="header"><th>Chaîne de caractères de formatage</th>
- <th>Interprétation</th></tr>
-<tr>
- <td><code>%400,501{User-agent}i</code></td>
-
- <td>Enregistrera l'en-tête <code>User-agent</code> uniquementdans le
- cas d'une erreur 400 ou 501. Avec les autres codes de statut, c'est la
- chaîne littérale <code>"-"</code> qui sera enregistrée.
- </td></tr>
-<tr class="odd"><td><code>%!200,304,302{Referer}i</code></td>
- <td>
- Enregistrera l'en-tête <code>Referer</code> pour toutes les requêtes qui
- <em>ne</em> renvoient <em>aucun</em> des trois codes spécifiés.
- </td></tr>
-</table>
+ caractère "%". Par exemple, <code>"%400,501{User-agent}i"</code>
+ n'enregistrera l'en-tête <code>User-agent</code> que dans le cas
+ d'une erreur 400 ou 501. Avec les autres codes de statut, c'est la
+ chaîne littérale <code>"-"</code> qui sera enregistrée. La liste
+ de codes peut être précédée d'un "<code>!</code>" pour inverser la
+ condition : <code>"%!200,304,302{Referer}i"</code> enregistre
+ l'en-tête <code>Referer</code> pour toutes les requêtes qui
+ <em>ne</em> renvoient <em>pas</em> un des trois codes spécifiés.</p>
<p>Les modificateurs "&lt;" et "&gt;" peuvent être utilisés pour
les requêtes qui ont été redirigées en interne afin de choisir si
@@ -307,11 +303,11 @@ d'Apache</a></li>
<code>\</code> doivent être échappés par un anti-slash, et tous
les "blancs" doivent être écrits selon leur notation de style C
(<code>\n</code>, <code>\t</code>, etc...). Avant la version
- 2.0.46, aucun échappement n'était réalisé sur ces chaînes, et il
+ 2.0.46, aucun échappement n'était effectué sur ces chaînes, et il
fallait être très prudent lors de l'exploitation des journaux
bruts.</p>
- <p>À la différence de la version 1.3, dans httpd 2.0, les chaînes
+ <p>A la différence de la version 1.3, dans httpd 2.0, les chaînes
de format <code>%b</code> et <code>%B</code> ne représentent pas
le nombre d'octets envoyés au client, mais simplement la taille en
octets de la réponse HTTP (les deux étant différents, par exemple,
@@ -319,13 +315,11 @@ d'Apache</a></li>
<code>%O</code> fourni par <code class="module"><a href="../mod/mod_logio.html">mod_logio</a></code>,
enregistrera le nombre réel d'octets envoyés sur le réseau.</p>
- <div class="note">
<p>Note : <code class="module"><a href="../mod/mod_cache.html">mod_cache</a></code> est implémenté en tant que
gestionnaire basique et non en tant que gestionnaire standard.
C'est pourquoi la chaîne de format <code>%R</code> ne renverra pas
d'information à propos du gestionnaire lorsqu'une mise en cache de
contenu entre en jeu.</p>
- </div>
@@ -334,13 +328,13 @@ d'Apache</a></li>
<p>Quelques chaînes de format couramment utilisées :</p>
<dl>
- <dt>Format de journal courant (Common Log Format - CLF)</dt>
+ <dt>Format de journal courant (CLF)</dt>
<dd><code>"%h %l %u %t \"%r\" %&gt;s %b"</code></dd>
<dt>Format de journal courant avec un serveur virtuel</dt>
<dd><code>"%v %h %l %u %t \"%r\" %&gt;s %b"</code></dd>
- <dt>Format de journal NCSA étendu/combiné</dt>
+ <dt>Format de journal NCSA étandu/combiné</dt>
<dd><code>"%h %l %u %t \"%r\" %&gt;s %b \"%{Referer}i\"
\"%{User-agent}i\""</code></dd>
@@ -385,7 +379,7 @@ avant de les écrire sur disque</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_log_config</td></tr>
</table>
<p>Lorsque la directive <code class="directive">BufferedLogs</code> est à
- "on", <code class="module"><a href="../mod/mod_log_config.html">mod_log_config</a></code> conserve plusieurs entrées
+ "on", <code class="module"><a href="../mod/mod_log_config.html">mod_log_config</a></code> 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
@@ -394,7 +388,7 @@ avant de les écrire sur disque</td></tr>
définie au niveau d'un serveur virtuel.</p>
<div class="note">Cette directive doit être utilisée avec
- précaution car un crash peut provoquer la perte de données de
+ précautions car un crash peut provoquer la perte de données de
journalisation.</div>
</div>
@@ -411,11 +405,11 @@ expr=<var>expression</var>]</code></td></tr>
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_log_config</td></tr>
</table>
- <p>La directive <code class="directive">CustomLog</code> contrôle
+ <p>La directive <code class="directive">CustomLog</code> permet de contrôler
la journalisation des requêtes destinées au serveur. Un format de
- journalisation est spécifié, et la journalisation peut s'effectuer de
+ journal est spécifié, et la journalisation peut s'effectuer de
manière conditionnelle en fonction des caractéristiques de la
- requête au moyen de variables d'environnement.</p>
+ requête en utilisant des variables d'environnement.</p>
<p>Le premier argument, qui spécifie l'emplacement où les journaux
seront écrits, accepte deux types de valeurs :</p>