Serveur HTTP Apache Version 2.4

Apache > Serveur HTTP > Documentation > Version 2.4 > Modules

# Module Apache mod_logio

Description: | Journalisation des octets en entrée et en sortie pour chaque requête
Statut: | Extension
Identificateur de Module: | logio_module
Fichier Source: | mod_logio.c

### Sommaire

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.

Pour fonctionner, ce module requiert le chargement du module `mod_log_config`.

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.

### Sujets

- Formats de journaux personnalisés

### Directives

### Traitement des bugs

- Journal des modifications de httpd
- Problèmes connus
- Signaler un bug

### Voir aussi

- `mod_log_config`
- Les fichiers journaux d'Apache

## Formats de journaux personnalisés

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 "`%`" dans la chaîne de format, qui seront remplacées comme suit dans le fichier journal :

Chaîne de Format | Description
--- | ---
`%I` | Octets reçus, en-têtes et corps de requête inclus ; ne peut pas être nul.
`%O` | Octets envoyés, en-têtes inclus. Peut être égal à zéro dans de rares cas ; par exemple lorsqu’une requête est interrompue avant l’envoi de la réponse.
`%S` | 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. Disponible depuis la version 2.4.7 du serveur HTTP Apache.
`%^FB` | 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 `LogIOTrackTTFB` a été définie à ON. Disponible à partir de la version 2.4.13 du serveur HTTP Apache

En général, cette fonctionnalité s'utilise comme suit :

Format de journal d'entrées/sorties combiné :
  `"%h %l %u %t \"%r\" %>s %b \"%{Referer}i\" \"%{User-agent}i\" %I %O"`

## Directive LogIOTrackTTFB

Description: | Permet d'enregistrer le délai avant le premier octet (time to first byte - TTFB)
Syntaxe: | `LogIOTrackTTFB ON|OFF`
Défaut: | `LogIOTrackTTFB OFF`
Contexte: | configuration globale, serveur virtuel, répertoire, .htaccess
Surcharges autorisées: | All
Statut: | Extension
Module: | mod_logio
Compatibilité: | Disponible à partir de la version 2.4.13 du serveur HTTP Apache

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 `%^FB`.