Apache. Документация на русском


Директивы Apache
  1    2    3    4    5    6    7    8    9    10    11    12    13    14    15    16    17    18    19    20    21    22    23    24      25      26    27    28    29    30    31    32    33    34    35    36    37    38    39    40    41    42    43    44    45    46    47    48    49    50    51    52    53    54    55    56    57    58    59    60    61    62    63    64    65    66    67    68    69    70    71    72    73    74    75    76    77    78    79    80    81    82    83    84    85  
  86    87    88    89    90    91    92  
  93    94    95    96    97    98    99    100    101    102    103    104    105    106    107    108    109    110    111    112    113    114    115    116    117    118    119    120    121    122    123    124    125    126    127    128    129    130    131    132    133    134    135    136    137    138    139    140    141    142    143    144    145    146    147    148    149    150    151    152    153    154    155    156    157    158    159    160    161    162    163    164    165  
  166    167    168    169    170    171    172    173    174    175    176    177    178    179    180    181    182    183    184    185    186    187    188    189    190    191    192    193    194    195    196    197    198    199    200    201    202    203    204    205    206    207    208    209    210    211    212    213    214    215    216    217    218    219    220    221    222    223    224    225    226    227    228    229    230    231    232    233    234    235    236    237    238    239    240    241    242  

 <         > 
Список директив: Core  |  ModRewrite  |  Lua  |  Proxy  |  SSL

Директива ErrorLogFormat
  RU            EN  

Description:Format specification for error log entries
Syntax: ErrorLogFormat [connection|request] format
Context:server config, virtual host
Status:Core
Module:core

Описание: Спецификация формата записей журнала ошибок


ErrorLogFormat позволяет указать, какая дополнительная информация регистрируется в журнале ошибок в дополнение к фактическому сообщению журнала.

#Simple example
ErrorLogFormat "[%t] [%l] [pid %P] %F: %E: [client %a] %M"

Указание connection или request в качестве первого параметра позволяет указать дополнительные форматы, в результате чего дополнительная информация будет регистрироваться, когда первое сообщение регистрируется для определенного соединения или запроса, соответственно. Эта дополнительная информация регистрируется только один раз для каждого соединения/запроса. Если соединение или запрос обрабатываются без каких-либо сообщений в журнале, дополнительная информация также не регистрируется.

Может случиться так, что некоторые элементы строки формата не выводят результат. Например, заголовок Referer присутствует только в том случае, если сообщение журнала связано с запросом, и сообщение журнала появляется в то время, когда заголовок Referer уже был прочитан клиентом. Если вывод не производится, поведение по умолчанию заключается в удалении всего от предыдущего пробела до следующего пробела. Это означает, что строка журнала неявно разделена на поля при переходе от непробельного к пробельному. Если элемент строки формата не производит вывод, все поле опускается. Например, если удаленный адрес %a в формате журнала [%t] [%l] [%a] %M  недоступен, окружающие его скобки также не регистрируются. Символы пробела можно экранировать с помощью обратной косой черты, чтобы они не ограничивали поле. Комбинация '%' (процентное пространство) представляет собой разделитель полей нулевой ширины, который не производит никакого вывода.

Приведенное выше поведение можно изменить, добавив модификаторы к элементу строки формата. Модификатор - (минус) приводит к регистрации минуса, если соответствующий элемент не производит никакого вывода. В форматах «один раз за соединение/запрос» также можно использовать + модификатор (плюс). Если элемент с модификатором «плюс» не производит никакого вывода, вся строка опускается.

Число в качестве модификатора может использоваться для назначения уровня важности журнала элементу формата. Элемент будет зарегистрирован только в том случае, если серьезность сообщения журнала не выше указанного уровня серьезности журнала. Число может варьироваться от 1 (предупреждение), 4 (предупреждение) и 7 (отладка) до 15 (трассировка8).

Например, вот что произойдет, если вы добавите модификаторы в токен %{Referer}i , который регистрирует Referer заголовок запроса.

Модифицированный токенЗначение
%-{Referer}i Регистрирует a - , если Referer не установлен.
%+{Referer}i Пропускает всю строку, если Referer она не установлена.
%4{Referer}i Заносит в журнал Referer только в том случае, если серьезность сообщения в журнале выше 4.

Некоторые элементы строки формата принимают дополнительные параметры в фигурных скобках.

Строка формата Описание
%% Знак процента
%a IP-адрес клиента и порт запроса
%{c}a Базовый IP-адрес пира и порт соединения (см. модуль mod_remoteip )
%A Локальный IP-адрес и порт
%{name}e Имя переменной среды запроса
%E Код состояния ошибки APR/OS и строка
%F Имя исходного файла и номер строки журнала вызовов
%{name}i Имя заголовка запроса
%k Количество запросов проверки активности в этом соединении
%l Уровень логирования сообщения
%L Идентификатор журнала запроса
%{c}L Идентификатор журнала соединения
%{C}L Идентификатор журнала соединения, если он используется в области соединения, в противном случае — пустой.
%m Имя модуля, регистрирующего сообщение
%M Фактическое сообщение журнала
%{name}n Название заметки запроса
%P ID текущего процесса
%T Идентификатор потока текущего потока
%{g}T Уникальный системный идентификатор текущего потока (тот же идентификатор, который отображается, например top , в настоящее время только для Linux)
%t Текущее время
%{u}t Текущее время, включая микросекунды
%{cu}t Текущее время в компактном формате ISO 8601, включая микросекунды
%v Канонический ServerName для текущего сервера.
%V Имя сервера, обслуживающего запрос в соответствии с UseCanonicalName настройкой.
(обратная косая черта) Пространство, не разделяющее поля
(процентное пространство) Разделитель полей (без вывода)

Формат идентификатора журнала %L создает уникальный идентификатор для соединения или запроса. Это можно использовать для корреляции того, какие строки журнала принадлежат одному и тому же соединению или запросу, какой запрос происходит в каком соединении. %L Также доступна строка формата, позволяющая mod_log_config сопоставлять записи журнала доступа со строками журнала ошибок. Если mod_unique_id он загружен, его уникальный идентификатор будет использоваться в качестве идентификатора журнала для запросов.

#Example (default format for threaded MPMs)
ErrorLogFormat "[%{u}t] [%-m:%l] [pid %P:tid %T] %7F: %E: [client\ %a] %M% ,\ referer\ %{Referer}i"

Это приведет к сообщениям об ошибках, например:

[Thu May 12 08:28:57.652118 2011] [core:error] [pid 8777:tid 4326490112] [client ::1:58619] File does not exist: /usr/local/apache2/htdocs/favicon.ico

Обратите внимание, как обсуждалось выше, некоторые поля полностью опущены, поскольку они не определены.

#Example (similar to the 2.2.x format)
ErrorLogFormat "[%t] [%l] %7F: %E: [client\ %a] %M% ,\ referer\ %{Referer}i"
#Advanced example with request/connection log IDs
ErrorLogFormat "[%{uc}t] [%-m:%-l] [R:%L] [C:%{C}L] %7F: %E: %M"
ErrorLogFormat request "[%{uc}t] [R:%L] Request %k on C:%{c}L pid:%P tid:%T"
ErrorLogFormat request "[%{uc}t] [R:%L] UA:'%+{User-Agent}i'"
ErrorLogFormat request "[%{uc}t] [R:%L] Referer:'%+{Referer}i'"
ErrorLogFormat connection "[%{uc}t] [C:%{c}L] local\ %a remote\ %A"

Смотрите также

  • ErrorLog
  • LogLevel
  • Файлы журнала HTTP-сервера Apache
  RU            EN  


Рейтинг@Mail.ru