Mercurial > hg > nginx-site
diff xml/ru/docs/stream/ngx_stream_log_module.xml @ 1776:8d0372178e00
Documented the ngx_stream_log_module module.
author | Yaroslav Zhuravlev <yar@nginx.com> |
---|---|
date | Wed, 07 Sep 2016 19:42:32 +0300 |
parents | xml/ru/docs/http/ngx_http_log_module.xml@080b36ad8d76 |
children | 8b1ef02c8686 |
line wrap: on
line diff
copy from xml/ru/docs/http/ngx_http_log_module.xml copy to xml/ru/docs/stream/ngx_stream_log_module.xml --- a/xml/ru/docs/http/ngx_http_log_module.xml +++ b/xml/ru/docs/stream/ngx_stream_log_module.xml @@ -1,32 +1,23 @@ <?xml version="1.0"?> <!-- - Copyright (C) Igor Sysoev Copyright (C) Nginx, Inc. --> <!DOCTYPE module SYSTEM "../../../../dtd/module.dtd"> -<module name="Модуль ngx_http_log_module" - link="/ru/docs/http/ngx_http_log_module.html" +<module name="Модуль ngx_stream_log_module" + link="/ru/docs/stream/ngx_stream_log_module.html" lang="ru" - rev="15"> + rev="1"> <section id="summary"> <para> -Модуль <literal>ngx_http_log_module</literal> записывает логи запросов +Модуль <literal>ngx_stream_log_module</literal> записывает логи сессий в указанном формате. </para> -<para> -Логи записываются в контексте location’а, где заканчивается обработка. -Это может быть location, отличный от первоначального, если в процессе -обработки запроса происходит -<link doc="ngx_http_core_module.xml" id="internal">внутреннее -перенаправление</link>. -</para> - </section> @@ -34,11 +25,11 @@ <para> <example> -log_format compression '$remote_addr - $remote_user [$time_local] ' - '"$request" $status $bytes_sent ' - '"$http_referer" "$http_user_agent" "$gzip_ratio"'; +log_format basic '$remote_addr [$time_local] ' + '$protocol $status $bytes_sent $bytes_received ' + ' $session_time'; -access_log /spool/logs/nginx-access.log compression buffer=32k; +access_log /spool/logs/nginx-access.log basic buffer=32k; </example> </para> @@ -50,34 +41,30 @@ access_log /spool/logs/nginx-access.log <directive name="access_log"> <syntax> <value>путь</value> - [<value>формат</value> + <value>формат</value> [<literal>buffer</literal>=<value>размер</value>] [<literal>gzip[=<value>степень</value>]</literal>] [<literal>flush</literal>=<value>время</value>] - [<literal>if</literal>=<value>условие</value>]]</syntax> + [<literal>if</literal>=<value>условие</value>]</syntax> <syntax><literal>off</literal></syntax> -<default>logs/access.log combined</default> -<context>http</context> +<default>off</default> +<context>stream</context> <context>server</context> -<context>location</context> -<context>if в location</context> -<context>limit_except</context> <para> -Задаёт путь, формат и настройки буферизованной записи в лог. +Задаёт путь, <link id="log_format">формат</link> +и настройки буферизованной записи в лог. На одном уровне может использоваться несколько логов. Запись в <link doc="../syslog.xml">syslog</link> настраивается указанием префикса “<literal>syslog:</literal>” в первом параметре. Специальное значение <literal>off</literal> отменяет все директивы <literal>access_log</literal> для текущего уровня. -Если формат не указан, то используется предопределённый формат -“<literal>combined</literal>”. </para> <para> Если задан размер буфера с помощью параметра <literal>buffer</literal> или -указан параметр <literal>gzip</literal> (1.3.10, 1.2.7), то запись будет +указан параметр <literal>gzip</literal>, то запись будет буферизованной. <note> Размер буфера должен быть не больше размера атомарной записи в дисковый файл. @@ -95,7 +82,7 @@ access_log /spool/logs/nginx-access.log <listitem> если данные в буфере находятся дольше интервала времени, заданного -параметром <literal>flush</literal> (1.3.10, 1.2.7); +параметром <literal>flush</literal>; </listitem> <listitem> @@ -119,7 +106,7 @@ access_log /spool/logs/nginx-access.log <para> Пример: <example> -access_log /path/to/log.gz combined gzip flush=5m; +access_log /path/to/log.gz basic gzip flush=5m; </example> </para> @@ -130,7 +117,7 @@ access_log /path/to/log.gz combined gzip </para> <para> -В пути файла можно использовать переменные (0.7.6+), +В пути файла можно использовать переменные, но такие логи имеют некоторые ограничения: <list type="bullet"> @@ -153,37 +140,13 @@ access_log /path/to/log.gz combined gzip запись может продолжаться в старый файл. </listitem> -<listitem> -при каждой записи в лог проверяется существование -<link doc="ngx_http_core_module.xml" id="root">корневого каталога</link> -для запроса — если этот каталог не существует, то лог не создаётся. -Поэтому <link doc="ngx_http_core_module.xml" id="root"/> -и <literal>access_log</literal> нужно описывать на одном уровне: -<example> -server { - root /spool/vhost/data/$host; - access_log /spool/vhost/logs/$host; - ... -</example> -</listitem> - </list> </para> <para> -Параметр <literal>if</literal> (1.7.0) включает условную запись в лог. -Запрос не будет записываться в лог, если результатом вычисления +Параметр <literal>if</literal> включает условную запись в лог. +Сессия не будет записываться в лог, если результатом вычисления <value>условия</value> является “0” или пустая строка. -В следующем примере запросы с кодами ответа 2xx и 3xx -не будут записываться в лог: -<example> -map $status $loggable { - ~^[23] 0; - default 1; -} - -access_log /path/to/access.log combined if=$loggable; -</example> </para> </directive> @@ -193,114 +156,16 @@ access_log /path/to/access.log combined <syntax> <value>название</value> <value>строка</value> ...</syntax> -<default>combined "..."</default> -<context>http</context> - -<para> -Задаёт формат лога. -</para> +<default></default> +<context>stream</context> <para> -Кроме общих переменных в формате можно использовать переменные, -существующие только на момент записи в лог: -<list type="tag"> - -<tag-name id="var_bytes_sent"><var>$bytes_sent</var></tag-name> -<tag-desc> -число байт, переданное клиенту -</tag-desc> - -<tag-name id="var_connection"><var>$connection</var></tag-name> -<tag-desc> -порядковый номер соединения -</tag-desc> - -<tag-name id="var_connection_requests"><var>$connection_requests</var> -</tag-name> -<tag-desc> -текущее число запросов в соединении (1.1.18) -</tag-desc> - -<tag-name id="var_msec"><var>$msec</var></tag-name> -<tag-desc> -время в секундах с точностью до миллисекунд на момент записи в лог -</tag-desc> - -<tag-name id="var_pipe"><var>$pipe</var></tag-name> -<tag-desc> -“<literal>p</literal>” если запрос был pipelined, иначе “<literal>.</literal>” -</tag-desc> - -<tag-name id="var_request_length"><var>$request_length</var></tag-name> -<tag-desc> -длина запроса (включая строку запроса, заголовок и тело запроса) -</tag-desc> - -<tag-name id="var_request_time"><var>$request_time</var></tag-name> -<tag-desc> -время обработки запроса в секундах с точностью до миллисекунд; -время, прошедшее с момента чтения первых байт от клиента до -момента записи в лог после отправки последних байт клиенту -</tag-desc> - -<tag-name id="var_status"><var>$status</var></tag-name> -<tag-desc> -статус ответа -</tag-desc> - -<tag-name id="var_time_iso8601"><var>$time_iso8601</var></tag-name> -<tag-desc> -локальное время в формате по стандарту ISO 8601 -</tag-desc> - -<tag-name id="var_time_local"><var>$time_local</var></tag-name> -<tag-desc> -локальное время в Common Log Format -</tag-desc> - -</list> - -<note> -В современных версиях nginx переменные -<link doc="ngx_http_core_module.xml" id="var_status">$status</link> -(1.3.2, 1.2.2), -<link doc="ngx_http_core_module.xml" id="var_bytes_sent">$bytes_sent</link> -(1.3.8, 1.2.5), -<link doc="ngx_http_core_module.xml" id="var_connection">$connection</link> -(1.3.8, 1.2.5), -<link doc="ngx_http_core_module.xml" id="var_connection_requests">$connection_requests</link> -(1.3.8, 1.2.5), -<link doc="ngx_http_core_module.xml" id="var_msec">$msec</link> -(1.3.9, 1.2.6), -<link doc="ngx_http_core_module.xml" id="var_request_time">$request_time</link> -(1.3.9, 1.2.6), -<link doc="ngx_http_core_module.xml" id="var_pipe">$pipe</link> -(1.3.12, 1.2.7), -<link doc="ngx_http_core_module.xml" id="var_request_length">$request_length</link> -(1.3.12, 1.2.7), -<link doc="ngx_http_core_module.xml" id="var_time_iso8601">$time_iso8601</link> -(1.3.12, 1.2.7) -и -<link doc="ngx_http_core_module.xml" id="var_time_local">$time_local</link> -(1.3.12, 1.2.7) -также доступны как общие переменные. -</note> - -</para> - -<para> -Строки заголовка, переданные клиенту, начинаются с префикса -“<literal>sent_http_</literal>”, например, -<var>$sent_http_content_range</var>. -</para> - -<para> -В конфигурации всегда существует предопределённый формат -“<literal>combined</literal>”: +Задаёт формат лога, например: <example> -log_format combined '$remote_addr - $remote_user [$time_local] ' - '"$request" $status $body_bytes_sent ' - '"$http_referer" "$http_user_agent"'; +log_format proxy '$remote_addr [$time_local] ' + '$protocol $status $bytes_sent $bytes_received' + '$session_time "$upstream_addr"' + '"$upstream_bytes_sent" "$upstream_bytes_received" "$upstream_connection_time" '; </example> </para> @@ -316,9 +181,8 @@ log_format combined '$remote_addr - $rem [<literal>valid</literal>=<value>время</value>]</syntax> <syntax><literal>off</literal></syntax> <default>off</default> -<context>http</context> +<context>stream</context> <context>server</context> -<context>location</context> <para> Задаёт кэш, в котором хранятся дескрипторы файлов часто используемых