Описание значений элементов log - журнала

Журнал ошибок управляется директивами ErrorLog и LogLevel модуля Core. Кроме сообщений сервера сюда направляется вывод на stderr скриптов CGI.

Журнал доступа управляется модулем LoadModule log_config_module modules/mod_log_config.so, который позволяет задать имя файла и формат вывода. Данный журнал содержит записи о всех (если не отфильтровано директивой CustomLog) запросах к серверу.

Фрагмент конфигурационного файла httpd.conf веб сервера Apache

Каждый виртуальный сервер может вести произвольное число журналов в различных форматах.

Каждый запрос к серверу порождает строку в журнале, состоящую из элементов (token), разделенных пробелами. Пустой элемент записывается как символ '-'. Если элемент содержит пробелы, то он должен заключаться в кавычки (это надо самому предусмотреть при описании формата).

Фрагмент записей лог-журнала веб сервера Apache

При описании формата используются литеральные символы, которые копируются в журнал (можно использовать '\n' и т.п.; кавычки и обратная косая должны быть прикрыты символом '\') и директивы, которые начинаются с символа '%' и завершаются однобуквенным именем директивы. Между ними может стоять условие в виде списка кодов завершения HTTP через запятую (м.б. предваренных восклицательным знаком для операции отрицания) - если условие не выполняется, то вместо элемента записывается минус. Модификаторы перед буквой директивы позволяют определить (в случае внутреннего перенаправления) атрибут исходного ('<') или результирующего ('>') запроса будет использоваться при создании строки журнала.

Директива в описании формата замещается соответствующим значением:

• %% - '%'

• %a - адрес удаленного хоста

• %A - локальный адрес

• %B - количество посланных байт, кроме HTTP-заголовка

• %b - количество посланных байт, кроме HTTP-заголовка (вместо 0 пишется '-')

• %{имя-куки}C - значение куки

• %D - микросекунд потрачено на обработку запроса

• %{имя}e - значение переменной окружения

• %f - имя файла

• %h - имя удаленного хоста

• %H - протокол (HTTP)

• %{имя-заголовка}i - значение заголовка запроса; наиболее часто используются

• Referer - откуда была ссылка на документ

• User-agent - что сказал о себе броузер

• %I - количество полученных байт, включая заголовки (требуется logio)

• %l - имя удаленного пользователя (если задействован ident)

• %m - метод (GET, PUT и т . д .)

• %{имя-заметки}n - содержимое заметки с указанным именем, созданной другим модулем (например, %{forensic-id}n или %{cookie}n)

• %{имя-заголовка}o - значение заголовка ответа

• %O - количество посланных байт, включая заголовки (требуется logio)

• %p - канонический номер порта сервера

• %P - pid процесса, обслуживающего запрос

• %{tid}P - идентификатор потока, обслуживающего запрос

• %q - поисковая часть URI (после '?')

• %r - первая строка запроса

• %s - статус запроса (код возврата HTTP)

• %t - время в CLF- формате ([day2d/month3l/year4d:hour2l:minute2l:second2l zone], где zone в формате [+|-]hour2dmin2d)

• %{формат}t - время, формат описан в strftime(3)

• %T - секунд, прошедших до окончания обслуживания запроса

• %u - имя авторизованного пользователя (если статус не равен 401)

• %U - запрошенный URL без поисковой части

• %v - канонический ServerName

• %V - имя сервера в соответствии с значением UseCanonicalName

• %X - состояние соединения к моменту завершения ответа ('X' - преждевременный обрыв, '+' - можно использовать повторно, '-' - необходимо закрыть после завершения обработки запроса)

Данный фрагмент описание, документация и инструкции сервера apache взят с http://bog.pp.ru/