Модуль Apache mod_log_config

Директива BufferedLogs

BufferedLogs On|Off

BufferedLogs Off

Директива BufferedLogs заставляет mod_log_config хранить несколько записей журнала в памяти и записывать их на диск вместе, а не после каждого запроса. В некоторых системах это может повысить эффективность доступа к диску и, следовательно, производительность. Её можно задать только один раз для всего сервера; настроить её для отдельного виртуального хоста нельзя.

Директива CustomLog

CustomLog file|pipe format|nickname [env=[!]environment-variable| expr=expression]

Директива CustomLog используется для регистрации запросов к серверу. Задаётся формат журнала; при необходимости регистрацию можно выполнять условно, используя переменные среды и характеристики запроса.

Первый аргумент, задающий расположение для записи журналов, может принимать значения одного из двух типов:

file

Имя файла относительно ServerRoot.

pipe

Символ канала "|", за которым следует путь к программе, получающей данные журнала через стандартный ввод. Дополнительные сведения см. в примечаниях о журналах, передаваемых через канал.

Безопасность:

Если используется программа, она будет запущена от имени пользователя, запустившего httpd. Если сервер запущен от имени root, программа будет запущена от имени root; убедитесь, что она безопасна.

Примечание

При указании пути к файлу на платформах, отличных от Unix, используйте только прямые косые черты, даже если платформа допускает обратные косые черты. В целом рекомендуется всегда использовать прямые косые черты во всех файлах конфигурации.

Второй аргумент задаёт содержимое файла журнала. В качестве него можно указать псевдоним, определённый предыдущей директивой LogFormat, или явную строку формата, описанную в разделе форматы журналов.

Например, следующие два набора директив имеют совершенно одинаковый эффект:

# CustomLog with format nickname
LogFormat "%h %l %u %t \"%r\" %>s %b" common
CustomLog "logs/access_log" common

# CustomLog with explicit format string
CustomLog "logs/access_log" "%h %l %u %t \"%r\" %>s %b"

Третий аргумент является необязательным и определяет, следует ли регистрировать конкретный запрос. Условием может быть наличие или отсутствие (в случае предложения 'env=!name') определённой переменной в среде сервера. Кроме того, условие можно задать как произвольное логическое выражение. Если условие не выполнено, запрос регистрироваться не будет. Ссылки на заголовки HTTP в выражении не приведут к добавлению имён заголовков в заголовок Vary.

Переменные среды можно устанавливать отдельно для каждого запроса с помощью модулей mod_setenvif и/или mod_rewrite. Например, если нужно записывать запросы ко всем GIF-изображениям на сервере в отдельный файл журнала, но не в основной журнал, можно использовать:

SetEnvIf Request_URI \.gif$ gif-image
CustomLog "gif-requests.log" common env=gif-image
CustomLog "nongif-requests.log" common env=!gif-image

Или, чтобы воспроизвести поведение старой директивы RefererIgnore, можно использовать следующее:

SetEnvIf Referer example\.com localreferer
CustomLog "referer.log" referer env=!localreferer

Директива GlobalLog

GlobalLogfile|pipe format|nickname [env=[!]environment-variable| expr=expression]

Директива GlobalLog определяет журнал, общий для конфигурации основного сервера и всех заданных виртуальных хостов.

Директива GlobalLog идентична директиве CustomLog, за исключением следующих отличий:

• GlobalLog недопустима в контексте виртуального хоста.
• GlobalLog используется виртуальными хостами, которые определяют собственную CustomLog, в отличие от глобально заданной CustomLog.

Директива LogFormat

LogFormat format|nickname [nickname]

LogFormat "%h %l %u %t \"%r\" %>s %b"

Эта директива задаёт формат файла журнала доступа.

Директива LogFormat может использоваться в одной из двух форм. В первой форме, когда указан только один аргумент, эта директива задаёт формат журнала, который будет использоваться в последующих директивах TransferLog. Единственный аргумент может задавать явный формат, как описано выше в разделе пользовательские форматы журналов. Также можно указать псевдоним, ссылающийся на формат журнала, определённый предыдущей директивой LogFormat, как описано ниже.

Вторая форма директивы LogFormat связывает явный формат с псевдонимом. Затем этот псевдоним можно использовать в последующих директивах LogFormat или CustomLog вместо повторения всей строки формата. Директива LogFormat, задающая псевдоним, не делает ничего другого — она только задаёт псевдоним, но не применяет формат и не делает его форматом по умолчанию. Поэтому она не влияет на последующие директивы TransferLog. Кроме того, директива LogFormat не может использовать один псевдоним для определения другого. Обратите внимание: псевдоним не должен содержать знаков процента (%).

LogFormat "%v %h %l %u %t \"%r\" %>s %b" vhost_common

Директива TransferLog

TransferLog file|pipe

Эта директива имеет те же аргументы и действует так же, как директива CustomLog, за исключением того, что она не позволяет явно задавать формат журнала или условно регистрировать запросы. Вместо этого формат журнала определяется последней указанной директивой LogFormat, которая не задаёт псевдоним. Если другой формат не задан, используется общий формат журнала.

LogFormat "%h %l %u %t \"%r\" %>s %b \"%{Referer}i\" \"%{User-agent}i\""
TransferLog logs/access_log