Module Apache mod_log_debug
| 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 |
Sujets
Directives
Traitement des bugs
Voir aussi
Exemples
-
Enregistre un message apr�s le traitement d'une requ�te pour
/foo/* :
<Location "/foo/"> ��LogMessage "/foo/ has been requested" </Location>
-
Enregistre un message si une requ�te pour /foo/* est trait�e
dans une sous-requ�te :
<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. -
Enregistre un message si un client IPv6 est � l'origine d'un
d�passement de d�lai pour une requ�te :
LogMessage "IPv6 timeout from %{REMOTE_ADDR}" "expr=-T %{IPV6} && %{REQUEST_STATUS} = 408"Notez l'emplacement des guillemets pour l'argumentexpr=. -
Enregistre la valeur de la variable d'environnement de requ�te
"X-Foo" � chaque �tape du traitement :
<Location "/"> ��LogMessage "%{reqenv:X-Foo}" hook=all </Location>En association avec les rep�res de temps en microsecondes du journal des erreurs,hook=allpermet aussi de d�terminer la dur�e d'ex�cution des diff�rentes phases du traitement de la requ�te.
Directive LogMessage
| 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.