Модуль Apache mod_log_debug
| Описание: | Дополнительный настраиваемый журнал отладки |
|---|---|
| Статус: | Экспериментальный |
| Идентификатор модуля: | log_debug_module |
| Файл исходного кода: | mod_log_debug.c |
| Совместимость: | Доступен в Apache 2.3.14 и более поздних версиях |
Примеры
- Сообщение журнала после обработки запроса к /foo/*:
<Location "/foo/"> LogMessage "/foo/ has been requested" </Location>
- Сообщение журнала, если запрос к /foo/* обрабатывается в подзапросе:
<Location "/foo/"> LogMessage "subrequest to /foo/" hook=type_checker "expr=-T %{IS_SUBREQ}" </Location>По умолчанию обработчик log_transaction не выполняется для подзапросов, поэтому необходимо использовать другой обработчик. - Сообщение журнала, если клиент IPv6 вызывает таймаут запроса:
LogMessage "IPv6 timeout from %{REMOTE_ADDR}" "expr=-T %{IPV6} && %{REQUEST_STATUS} = 408"Обратите внимание на размещение двойных кавычек для аргументаexpr=. - Вывести значение переменной окружения запроса "X-Foo" на каждой стадии запроса:
<Location "/"> LogMessage "%{reqenv:X-Foo}" hook=all </Location>Вместе с отметками времени в микросекундах в журнале ошибок,hook=allтакже позволяет определить время, затраченное на различные части обработки запроса.
Директива LogMessage
| Описание: | Запись пользовательского сообщения в журнал ошибок |
|---|---|
| Синтаксис: | LogMessage message [hook=hook] [expr=expression] |
| Значение по умолчанию: | Unset |
| Контекст: | каталог |
| Статус: | Экспериментальный |
| Модуль: | mod_log_debug |
Данная директива вызывает запись пользовательского сообщения в журнал ошибок. Сообщение может использовать переменные и функции из синтаксиса ap_expr. Ссылки на HTTP-заголовки не приведут к добавлению имен заголовков в заголовок Vary. Сообщения записываются на уровне журнала info.
Обработчик указывает, перед какой фазой обработки запроса будет записано сообщение. Поддерживаются следующие обработчики:
| Имя |
|---|
pre_translate_name |
translate_name |
type_checker |
quick_handler |
map_to_storage |
check_access |
check_access_ex |
insert_filter |
check_authn |
check_authz |
fixups |
handler |
log_transaction |
Значение по умолчанию — log_transaction. Также поддерживается специальное значение all, вызывающее запись сообщения на каждой фазе. Не все обработчики выполняются для каждого запроса.
Необязательное выражение позволяет ограничить сообщение, если выполняется условие. Подробное описание синтаксиса выражения приведено в документации ap_expr. Ссылки на HTTP-заголовки не приведут к добавлению имен заголовков в заголовок Vary.
© 2018 The Apache Software Foundation
Licensed under the Apache License, Version 2.0.
https://httpd.apache.org/docs/2.4/en/mod/mod_log_debug.html