-<?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ée et en sortie pour
-chaque requê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ç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
+ <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é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>
+ 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>
d'Apache</a></seealso>
<section id="formats">
-<title>Formats de journaux personnalisés</title>
+<title>Formats de journaux personnalisés</title>
- <p>Ce module introduit deux 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>
+ <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îne de Format</th>
+ <tr><th>Chaîne de Format</th>
<th>Description</th></tr>
<tr><td><code>%I</code></td>
- <td>Octets reçus, en-têtes et corps de requête inclus ; ne peut
- pas ê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és, en-têtes inclus ; ne peut
- pas ê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 é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.</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énéral, cette fonctionnalité s'utilise comme suit :</p>
+ <p>En général, cette fonctionnalité s'utilise comme suit :</p>
<dl>
- <dt>Format de journal d'entrées/sorties combiné :</dt>
+ <dt>Format de journal d'entrées/sorties combiné :</dt>
<dd><code>"%h %l %u %t \"%r\" %>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>