]> granicus.if.org Git - apache/blobdiff - docs/manual/mod/mod_logio.xml.fr
XML update.
[apache] / docs / manual / mod / mod_logio.xml.fr
index 5a948848660de589a9b717aa3f005b91a790bbc2..161943de84fb56a0cc36348af6a47e7a04a058d2 100644 (file)
@@ -1,7 +1,7 @@
-<?xml version="1.0"?>
+<?xml version="1.0" encoding="UTF-8"?>
 <!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd">
 <?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?>
-<!-- English Revision: 1523269:1587098 (outdated) -->
+<!-- English Revision: 1816356 -->
 <!-- French translation : Lucien GENTIS -->
 <!-- Reviewed by : Vincent Deffontaines -->
 
 <modulesynopsis metafile="mod_logio.xml.meta">
 
 <name>mod_logio</name>
-<description>Journalisation des octets en entr&eacute;e et en sortie pour
-chaque requ&ecirc;te</description>
+<description>Journalisation des octets en entrée et en sortie pour
+chaque requête</description>
 <status>Extension</status>
 <sourcefile>mod_logio.c</sourcefile>
 <identifier>logio_module</identifier>
 
 <summary>
 
-    <p>Ce module permet d'enregistrer le nombre d'octets re&ccedil;us et
-    envoy&eacute;s pour chaque requ&ecirc;te. Ce nombre refl&egrave;te le nombre r&eacute;el
-    d'octets transmis sur le r&eacute;seau, et prend en compte les en-t&ecirc;tes et
-    corps des requ&ecirc;tes et des r&eacute;ponses. Le d&eacute;compte est effectu&eacute; avant
-    SSL/TLS en entr&eacute;e et apr&egrave;s SSL/TLS en sortie, si bien que le
-    r&eacute;sultat refl&egrave;tera toute modification introduite par le
+    <p>Ce module permet d'enregistrer le nombre d'octets reçus et
+    envoyés pour chaque requête. Ce nombre reflète le nombre réel
+    d'octets transmis sur le réseau, et prend en compte les en-têtes et
+    corps des requêtes et des réponses. Le décompte est effectué avant
+    SSL/TLS en entrée et après SSL/TLS en sortie, si bien que le
+    résultat reflètera toute modification introduite par le
     chiffrement.</p>
 
     <p>Pour fonctionner, ce module requiert le chargement du module
     <module>mod_log_config</module>.</p>
 
     <note>Lorsqu'on utilise les connexions persistantes avec SSL, le
-    suppl&eacute;ment de trafic induit par la n&eacute;gociation SSL est enregistr&eacute;
-    dans le d&eacute;compte des octets transmis dans le cadre de la premi&egrave;re
-    requ&ecirc;te de la connexion. Lors d'une ren&eacute;gociation SSL au niveau d'un
-    r&eacute;pertoire, le d&eacute;compte d'octets est associ&eacute; &agrave; la
-    requ&ecirc;te qui a d&eacute;clench&eacute; la ren&eacute;gociation.</note>
+    supplément de trafic induit par la négociation SSL est enregistré
+    dans le décompte des octets transmis dans le cadre de la première
+    requête de la connexion. Lors d'une renégociation SSL au niveau d'un
+    répertoire, le décompte d'octets est associé à la
+    requête qui a déclenché la renégociation.</note>
 
 </summary>
 
@@ -58,38 +58,67 @@ chaque requ&ecirc;te</description>
 d'Apache</a></seealso>
 
 <section id="formats">
-<title>Formats de journaux personnalis&eacute;s</title>
+<title>Formats de journaux personnalisés</title>
 
-    <p>Ce module introduit deux nouvelles directives de journalisation.
-    Les caract&eacute;ristiques de la requ&ecirc;te en elle-m&ecirc;me sont journalis&eacute;es en
-    ins&eacute;rant des directives "<code>%</code>" dans la cha&icirc;ne de format,
-    qui seront remplac&eacute;es comme suit dans le fichier journal :</p>
+    <p>Ce module introduit trois nouvelles directives de journalisation.
+    Les caractéristiques de la requête en elle-même sont journalisées en
+    insérant des directives "<code>%</code>" dans la chaîne de format,
+    qui seront remplacées comme suit dans le fichier journal :</p>
 
     <table border="1" style="zebra">
-    <tr><th>Cha&icirc;ne&nbsp;de&nbsp;Format</th>
+    <tr><th>Chaîne&nbsp;de&nbsp;Format</th>
         <th>Description</th></tr>
 
     <tr><td><code>%I</code></td>
-        <td>Octets re&ccedil;us, en-t&ecirc;tes et corps de requ&ecirc;te inclus ; ne peut
-       pas &ecirc;tre nul.</td></tr>
+        <td>Octets reçus, en-têtes et corps de requête inclus ; ne peut
+       pas être nul.</td></tr>
 
     <tr><td><code>%O</code></td>
-        <td>Octets envoy&eacute;s, en-t&ecirc;tes inclus ; ne peut
-       pas &ecirc;tre nul.</td></tr>
+        <td>Octets envoyés, en-têtes inclus ; ne peut
+       pas être nul.</td></tr>
 
     <tr><td><code>%S</code></td>
-       <td>Nombre d'octets transmis (en &eacute;mission et r&eacute;ception), y
-       compris corps et en-t&ecirc;tes de requ&ecirc;te. Ce nombre ne peut pas &ecirc;tre
-       nul, et il correspond &agrave; la combinaison des formats %I et %O.</td></tr>
+       <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.<br />
+       Disponible depuis la version 2.4.7 du serveur HTTP Apache.</td></tr>
+
+    <tr><td><code>%^FB</code></td>
+        <td>Délai en microsecondes entre l'arrivée de la requête et
+       l'écriture du premier octet des en-têtes de la réponse.
+       Disponible uniquement si la directive
+       <directive>LogIOTrackTTFB</directive> a été définie à ON.<br />
+       Disponible à partir de la version 2.4.13 du serveur HTTP Apache
+        </td></tr>     
     </table>
 
-    <p>En g&eacute;n&eacute;ral, cette fonctionnalit&eacute; s'utilise comme suit :</p>
+    <p>En général, cette fonctionnalité s'utilise comme suit :</p>
 
     <dl>
-      <dt>Format de journal d'entr&eacute;es/sorties combin&eacute; :</dt>
+      <dt>Format de journal d'entrées/sorties combiné :</dt>
       <dd><code>"%h %l %u %t \"%r\" %&gt;s %b \"%{Referer}i\"
       \"%{User-agent}i\" %I %O"</code></dd>
     </dl>
 </section>
 
+<directivesynopsis>
+<name>LogIOTrackTTFB</name>
+<description>Permet d'enregistrer le délai avant le premier octet (time
+to first byte - TTFB)</description>
+<syntax>LogIOTrackTTFB ON|OFF</syntax>
+<default>LogIOTrackTTFB OFF</default>
+<contextlist><context>server config</context><context>virtual host</context>
+<context>directory</context><context>.htaccess</context></contextlist>
+<override>All</override>
+<compatibility>Disponible à partir de la version 2.4.13 du serveur HTTP
+Apache</compatibility>
+
+<usage>
+    <p>Cette directive permet de définir si ce module mesure le délai
+    entre la lecture de la requête et l'écriture du premier octet des
+    en-têtes de la réponse. La valeur obtenue peut être enregistrée dans
+    le journal via le format <code>%^FB</code>.</p>
+</usage>
+</directivesynopsis>
+
 </modulesynopsis>