Serveur Apache HTTP Version 2.4
Serveur Apache HTTP Version 2.4
| Description: | Journalisation supplémentaire à des fins de débogage |
|---|---|
| Statut: | Expérimental |
| Identificateur de Module: | log_debug_module |
| Fichier Source: | mod_log_debug.c |
| Compatibilité: | Disponible depuis la version 2.3.14 d'Apache |
<Location "/foo/"> LogMessage "/foo/ has been requested" </Location>
<Location "/foo/">
LogMessage "subrequest to /foo/" hook=type_checker expr=%{IS_SUBREQ}
</Location>
Le branchement (hook) par défaut log_transaction n'est pas
exécuté pour les sous-requêtes ; nous devons donc en utiliser un
autre.
LogMessage "IPv6 timeout from %{REMOTE_ADDR}" "expr=-T %{IPV6} && %{REQUEST_STATUS} = 408"
Notez l'emplacement des guillemets pour l'argument
expr=.
<Location "/">
LogMessage "%{reqenv:X-Foo}" hook=all
</Location>
En association avec les repères de temps en microsecondes du journal des erreurs,
hook=all permet aussi de déterminer la durée d'exécution des
différentes phases du traitement de la requête.
| Description: | Enregistre des messages personnalisés dans le journal des erreurs |
|---|---|
| Syntaxe: | LogMessage message
[hook=hook] [expr=expression]
|
| Défaut: | Non défini |
| Contexte: | répertoire |
| Statut: | Expérimental |
| Module: | mod_log_debug |
Cette directive permet d'enregistrer un message personnalisé dans le journal des erreurs. Ce message peut utiliser des variables et des fonctions dans la syntaxe ap_expr. D'éventuelles références à des en-têtes HTTP dans l'expression rationnelle n'entraîneront pas l'ajout des noms d'en-tête correspondants à l'en-tête Vary. Les messages sont enregistrés au loglevel info.
Le branchement (hook) précise la phase du traitement de la requête avant laquelle le message sera enregistré. Les branchements suivants sont supportés :
| Nom |
|---|
translate_name |
type_checker |
quick_handler |
map_to_storage |
check_access |
check_access_ex |
insert_filter |
check_authn |
check_authz |
fixups |
handler |
log_transaction |
Le branchement par défaut est log_transaction. La
valeur spéciale all est également supportée ; dans ce cas,
le message sera enregistré à chaque phase. Tous les branchements ne
sont pas exécutés pour chaque requête.
L'expression optionnelle permet de restreindre l'enregistrement du message en fonction d'une certaine condition. La syntaxe de l'expression est décrite dans la documentation ap_expr. D'éventuelles références à des en-têtes HTTP dans l'expression rationnelle n'entraîneront pas l'ajout des noms d'en-tête correspondants à l'en-tête Vary.