Spec-Zone.ru › Apache HTTP Server

Модуль Apache mod_log_debug

Описание: Дополнительный настраиваемый журнал отладки
Статус: Экспериментальный
Идентификатор модуля: log_debug_module
Файл исходного кода: mod_log_debug.c
Совместимость: Доступен в Apache 2.3.14 и более поздних версиях

Примеры

  1. Сообщение журнала после обработки запроса к /foo/*:
    <Location "/foo/">
      LogMessage "/foo/ has been requested"
    </Location>
  2. Сообщение журнала, если запрос к /foo/* обрабатывается в подзапросе:
    <Location "/foo/">
      LogMessage "subrequest to /foo/" hook=type_checker "expr=-T %{IS_SUBREQ}"
    </Location>
    По умолчанию обработчик log_transaction не выполняется для подзапросов, поэтому необходимо использовать другой обработчик.
  3. Сообщение журнала, если клиент IPv6 вызывает таймаут запроса:
    LogMessage "IPv6 timeout from %{REMOTE_ADDR}" "expr=-T %{IPV6} && %{REQUEST_STATUS} = 408"
    Обратите внимание на размещение двойных кавычек для аргумента expr=.
  4. Вывести значение переменной окружения запроса "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

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API