Mercurial > hg > nginx-site
diff xml/ru/docs/http/ngx_http_log_module.xml @ 224:7f36795d99a2
Updated ngx_http_log_module documentation including translation into English.
author | Ruslan Ermilov <ru@nginx.com> |
---|---|
date | Tue, 06 Dec 2011 07:25:25 +0000 |
parents | bfe3eff81d04 |
children | 945d7299c26c |
line wrap: on
line diff
--- a/xml/ru/docs/http/ngx_http_log_module.xml Tue Dec 06 07:19:07 2011 +0000 +++ b/xml/ru/docs/http/ngx_http_log_module.xml Tue Dec 06 07:25:25 2011 +0000 @@ -2,47 +2,57 @@ <!DOCTYPE module SYSTEM "../../../../dtd/module.dtd"> -<module name="Директивы модуля ngx_http_log_module" +<module name="Модуль ngx_http_log_module" link="/ru/docs/http/ngx_http_log_module.html" lang="ru"> <section id="summary"> <para> -Модуль ngx_http_log_module записывает логи запросов в указанном формате. +Модуль <code>ngx_http_log_module</code> записывает логи запросов +в указанном формате. </para> </section> -<section name="Пример конфигурации" id="example"> +<section id="example" name="Пример конфигурации"> <para> <example> - log_format gzip '$remote_addr - $remote_user [$time_local] ' - '"$request" $status $bytes_sent ' - '"$http_referer" "$http_user_agent" "$gzip_ratio"'; + log_format gzip '$remote_addr - $remote_user [$time_local] ' + '"$request" $status $bytes_sent ' + '"$http_referer" "$http_user_agent" "$gzip_ratio"'; - access_log /spool/logs/nginx-access.log gzip buffer=32k; + access_log /spool/logs/nginx-access.log gzip buffer=32k; </example> </para> </section> -<section name="Директивы" id="directives"> +<section id="directives" name="Директивы"> <directive name="access_log"> -<syntax><value>путь [формат [buffer=размер]]|off</value> -</syntax> +<syntax> + <argument>путь</argument> + [<argument>формат</argument> + [<parameter>buffer</parameter>=<argument>размер</argument>]]</syntax> +<syntax><value>off</value></syntax> <default>log/access.log combined</default> -<context>http, server, location, if в location, limit_except</context> +<context>http</context> +<context>server</context> +<context>location</context> +<context>if в location</context> +<context>limit_except</context> <para> -Директива access_log задаёт путь, формат и размер буфера для буферизированной -записи в лог. На одном уровне может использоваться несколько логов. -Параметр "off" отменяет все директивы access_log для текущего уровня. -Если формат не указан, то используется предопределённый формат "combined". +Задаёт путь, формат и размер буфера для буферизованной записи в лог. +На одном уровне может использоваться несколько логов. +Специальное значение <value>off</value> отменяет все директивы +<code>access_log</code> для текущего уровня. +Если формат не указан, то используется предопределённый формат +“<code>combined</code>”. </para> <para> @@ -56,7 +66,8 @@ <list type="bullet"> <listitem> -пользователь, с правами которого работают рабочие процессы, должен +<link doc="../ngx_core_module.xml" id="user">пользователь</link>, +с правами которого работают рабочие процессы, должен иметь права на создание файлов в каталоге с такими логами; </listitem> @@ -66,22 +77,23 @@ <listitem> файл открывается для каждой записи в лог и сразу же после записи закрывается. -Но дескрипторы часто используемых файлов могут храниться в -<link id="open_log_file_cache"/>. -При вращении логов нужно иметь в виду, что в течение времени, заданного -параметром valid директивы <link id="open_log_file_cache"/>, +Следует однако иметь в виду, что поскольку дескрипторы часто используемых файлов +могут храниться в <link id="open_log_file_cache">кэше</link>, +то при вращении логов в течение времени, заданного параметром +<parameter>valid</parameter> директивы <link id="open_log_file_cache"/>, запись может продолжаться в старый файл. </listitem> <listitem> -при каждой записи в лог проверяется существование каталога root'а для -запроса — если этот каталог не существует, то лог не создаётся. +при каждой записи в лог проверяется существование +<link doc="ngx_http_core_module.xml" id="root">корневого каталога</link> +для запроса — если этот каталог не существует, то лог не создаётся. Поэтому <link doc="ngx_http_core_module.xml" id="root"/> -и access_log нужно описывать на одном уровне: +и <code>access_log</code> нужно описывать на одном уровне: <example> server { - root /spool/vhost/data/$host; - access_log /spool/vhost/logs/$host; + root /spool/vhost/data/$host; + access_log /spool/vhost/logs/$host; ... </example> </listitem> @@ -93,71 +105,91 @@ <directive name="log_format"> -<syntax><value>название строка [строка ...]</value> +<syntax> +<argument>название строка ...</argument> </syntax> -<default>combined "..." </default> +<default>combined "..."</default> <context>http</context> <para> -Директива log_format описывает формат лога. +Задаёт формат лога. </para> <para> Кроме общих переменных в формате можно использовать переменные, существующие только на момент записи в лог: -<list type="bullet"> +<list type="tag"> -<listitem> -$body_bytes_sent, число байт, переданное клиенту за вычетом заголовка ответа, -переменная совместима с параметром %B модуля Apache mod_log_config; -</listitem> +<tag-name><var>$body_bytes_sent</var></tag-name> +<tag-desc> +число байт, переданных клиенту, за вычетом заголовка ответа; +переменная совместима с параметром “<code>%B</code>” модуля Apache +<code>mod_log_config</code> +</tag-desc> -<listitem> -$bytes_sent, число байт, переданное клиенту; -</listitem> +<tag-name><var>$bytes_sent</var></tag-name> +<tag-desc> +число байт, переданных клиенту +</tag-desc> -<listitem> -$connection, номер соединения; -</listitem> +<tag-name><var>$connection</var></tag-name> +<tag-desc> +порядковый номер соединения +</tag-desc> -<listitem> -$msec, время в секундах с точностью до миллисекунд на момент записи в лог; -</listitem> +<tag-name><var>$msec</var></tag-name> +<tag-desc> +время в секундах с точностью до миллисекунд на момент записи в лог +</tag-desc> -<listitem> -$pipe, "p" если запрос был pipelined; -</listitem> +<tag-name><var>$pipe</var></tag-name> +<tag-desc> +“<code>p</code>” если запрос был pipelined, иначе “<code>.</code>” +</tag-desc> -<listitem> -$request_length, длина тела запроса; -</listitem> +<tag-name><var>$request_length</var></tag-name> +<tag-desc> +длина запроса (включая строку запроса, заголовок и тело запроса) +</tag-desc> -<listitem> -$request_time, время обработки запроса в секундах с точностью до миллисекунд; -</listitem> +<tag-name><var>$request_time</var></tag-name> +<tag-desc> +время обработки запроса в секундах с точностью до миллисекунд; +время, прошедшее с момента чтения первых байт от клиента до +момента отправки последних байт клиенту и записи в лог +</tag-desc> -<listitem> -$status, статус ответа; -</listitem> +<tag-name><var>$status</var></tag-name> +<tag-desc> +статус ответа +</tag-desc> -<listitem> -$time_local, локальное время в common log format. -</listitem> +<tag-name><var>$time_iso8601</var></tag-name> +<tag-desc> +локальное время в формате по стандарту ISO 8601 +</tag-desc> + +<tag-name><var>$time_local</var></tag-name> +<tag-desc> +локальное время в Common Log Format +</tag-desc> </list> </para> <para> -Строки заголовка, переданные клиенту, начинаются с префикса "sent_http_", -например, $sent_http_content_range. +Строки заголовка, переданные клиенту, начинаются с префикса +“<code>sent_http_</code>”, например, +<var>$sent_http_content_range</var>. </para> <para> -В конфигурации всегда существует предопределённый формат "combined": +В конфигурации всегда существует предопределённый формат +“<code>combined</code>”: <example> - log_format combined '$remote_addr - $remote_user [$time_local] ' - '"$request" $status $body_bytes_sent ' - '"$http_referer" "$http_user_agent"'; + log_format combined '$remote_addr - $remote_user [$time_local] ' + '"$request" $status $body_bytes_sent ' + '"$http_referer" "$http_user_agent"'; </example> </para> @@ -165,49 +197,56 @@ <directive name="open_log_file_cache"> -<syntax><value>max=N [inactive=время]|off</value> -</syntax> +<syntax> +<parameter>max</parameter>=<argument>N</argument> +[<parameter>inactive</parameter>=<argument>время</argument>] +[<parameter>min_uses</parameter>=<argument>N</argument>] +[<parameter>valid</parameter>=<argument>время</argument>]</syntax> +<syntax><value>off</value></syntax> <default>off</default> -<context>http, server, location</context> - -<para> -Директива задаёт кэш, в котором хранятся дескрипторы файлов часто используемых -логов, имена которых заданы переменными. -</para> +<context>http</context> +<context>server</context> +<context>location</context> <para> +Задаёт кэш, в котором хранятся дескрипторы файлов часто используемых +логов, имена которых заданы с использованием переменных. Параметры директивы: -<list type="bullet"> +<list type="tag"> -<listitem> -max — задаёт маскимальное число дескрипторов в кэше; -при переполнении кэша наиболее давно не используемые дескрипторы закрываются -(LRU); -</listitem> +<tag-name><parameter>max</parameter></tag-name> +<tag-desc> +задаёт максимальное число дескрипторов в кэше; +при переполнении кэша наиболее давно не используемые (LRU) +дескрипторы закрываются +</tag-desc> -<listitem> -inactive — задаёт время, после которого дескриптор кэша закрывается, +<tag-name><parameter>inactive</parameter></tag-name> +<tag-desc> +задаёт время, после которого закэшированный дескриптор закрывается, если к нему не было обращений в течение этого времени; -по умолчанию 10 секунд; -</listitem> +по умолчанию 10 секунд +</tag-desc> -<listitem> -min_uses — задаёт минимальное число использований файла в течение -времени, заданного параметром inactive в директиве -<link id="open_log_file_cache"/>, после которого дескриптор файла -будет оставаться окрытым в кэше; -по умолчанию 1 использование; -</listitem> +<tag-name><parameter>min_uses</parameter></tag-name> +<tag-desc> +задаёт минимальное число использований файла в течение +времени, заданного параметром <parameter>inactive</parameter>, +после которого дескриптор файла будет оставаться открытым в кэше; +по умолчанию 1 +</tag-desc> -<listitem> -valid — задаёт, через какое время нужно проверять, что файл ещё +<tag-name><parameter>valid</parameter></tag-name> +<tag-desc> +задаёт, через какое время нужно проверять, что файл ещё существует под тем же именем; -по умолчанию 60 секунд; -</listitem> +по умолчанию 60 секунд +</tag-desc> -<listitem> -off — запрещает кэш. -</listitem> +<tag-name><value>off</value></tag-name> +<tag-desc> +запрещает кэш +</tag-desc> </list> </para> @@ -215,7 +254,7 @@ <para> Пример использования: <example> -open_log_file_cache max=1000 inactive=20s valid=1m min_uses=2; +open_log_file_cache max=1000 inactive=20s valid=1m min_uses=2; </example> </para>