Mercurial > hg > nginx-site

comparison xml/ru/docs/http/ngx_http_log_module.xml @ 795:41363f013cc9

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Documented the recently added "gzip" and "flush" parameters of the "access_log" directive.
author Valentin Bartenev <vbart@nginx.com>
date Tue, 25 Dec 2012 15:23:24 +0000
parents 32b8498cfb40
children ddd22f571529
comparison
equal deleted inserted replaced
794:e77512b1ce11 795:41363f013cc9
8 <!DOCTYPE module SYSTEM "../../../../dtd/module.dtd"> 8 <!DOCTYPE module SYSTEM "../../../../dtd/module.dtd">
9 9
10 <module name="Модуль ngx_http_log_module" 10 <module name="Модуль ngx_http_log_module"
11 link="/ru/docs/http/ngx_http_log_module.html" 11 link="/ru/docs/http/ngx_http_log_module.html"
12 lang="ru" 12 lang="ru"
13 rev="6"> 13 rev="7">
14 14
15 <section id="summary"> 15 <section id="summary">
16 16
17 <para> 17 <para>
18 Модуль <literal>ngx_http_log_module</literal> записывает логи запросов 18 Модуль <literal>ngx_http_log_module</literal> записывает логи запросов
32 32
33 <section id="example" name="Пример конфигурации"> 33 <section id="example" name="Пример конфигурации">
34 34
35 <para> 35 <para>
36 <example> 36 <example>
37 log_format gzip '$remote_addr - $remote_user [$time_local] ' 37 log_format compression '$remote_addr - $remote_user [$time_local] '
38 '"$request" $status $bytes_sent ' 38 '"$request" $status $bytes_sent '
39 '"$http_referer" "$http_user_agent" "$gzip_ratio"'; 39 '"$http_referer" "$http_user_agent" "$gzip_ratio"';
40 40
41 access_log /spool/logs/nginx-access.log gzip buffer=32k; 41 access_log /spool/logs/nginx-access.log compression buffer=32k;
42 </example> 42 </example>
43 </para> 43 </para>
44 44
45 </section> 45 </section>
46 46
49 49
50 <directive name="access_log"> 50 <directive name="access_log">
51 <syntax> 51 <syntax>
52 <value>путь</value> 52 <value>путь</value>
53 [<value>формат</value> 53 [<value>формат</value>
54 [<literal>buffer</literal>=<value>размер</value>]]</syntax> 54 [<literal>buffer</literal>=<value>размер</value>
55 [<literal>flush</literal>=<value>время</value>]]]</syntax>
56 <syntax>
57 <value>путь</value>
58 <value>формат</value>
59 <literal>gzip[=<value>степень</value>]</literal>
60 [<literal>buffer</literal>=<value>размер</value>]
61 [<literal>flush</literal>=<value>время</value>]</syntax>
55 <syntax><literal>off</literal></syntax> 62 <syntax><literal>off</literal></syntax>
56 <default>logs/access.log combined</default> 63 <default>logs/access.log combined</default>
57 <context>http</context> 64 <context>http</context>
58 <context>server</context> 65 <context>server</context>
59 <context>location</context> 66 <context>location</context>
60 <context>if в location</context> 67 <context>if в location</context>
61 <context>limit_except</context> 68 <context>limit_except</context>
62 69
63 <para> 70 <para>
64 Задаёт путь, формат и размер буфера для буферизованной записи в лог. 71 Задаёт путь, формат и настройки буферизованной записи в лог.
65 На одном уровне может использоваться несколько логов. 72 На одном уровне может использоваться несколько логов.
66 Специальное значение <literal>off</literal> отменяет все директивы 73 Специальное значение <literal>off</literal> отменяет все директивы
67 <literal>access_log</literal> для текущего уровня. 74 <literal>access_log</literal> для текущего уровня.
68 Если формат не указан, то используется предопределённый формат 75 Если формат не указан, то используется предопределённый формат
69 “<literal>combined</literal>”. 76 “<literal>combined</literal>”.
70 </para> 77 </para>
71 78
72 <para> 79 <para>
80 Если задан размер буфера с помощью параметра <literal>buffer</literal> или
81 указан параметр <literal>gzip</literal> (1.3.10), то запись будет
82 буферизованной.
83 <note>
73 Размер буфера должен быть не больше размера атомарной записи в дисковый файл. 84 Размер буфера должен быть не больше размера атомарной записи в дисковый файл.
74 Для FreeBSD этот размер неограничен. 85 Для FreeBSD этот размер неограничен.
86 </note>
87 </para>
88
89 <para>
90 При включённой буферизации данные записываются в файл:
91 <list type="bullet">
92
93 <listitem>
94 если очередная строка лога не помещается в буфер;
95 </listitem>
96
97 <listitem>
98 если данные в буфере находятся дольше интервала времени, заданного
99 параметром <literal>flush</literal> (1.3.10);
100 </listitem>
101
102 <listitem>
103 при <link doc="../control.xml">переоткрытии</link> лог-файла или
104 завершении рабочего процесса.
105 </listitem>
106
107 </list>
108 </para>
109
110 <para>
111 Если задан параметр <literal>gzip</literal>, то буфер будет сжиматься перед
112 записью в файл.
113 Степень сжатия может быть задана в диапазоне от 1 (быстрее, но хуже сжатие)
114 до 9 (медленнее, но лучше сжатие).
115 По умолчанию используется буфер размером 64К байт и степень сжатия 1.
116 Данные сжимаются атомарными блоками, и в любой момент времени лог-файл может
117 быть распакован или прочитан с помощью утилиты “<literal>zcat</literal>”.
118 </para>
119
120 <para>
121 Пример:
122 <example>
123 access_log /path/to/log.gz combined gzip flush=5m;
124 </example>
125 </para>
126
127 <para>
128 <note>
129 Для поддержки gzip-сжатия логов nginx должен быть собран с библиотекой zlib.
130 </note>
75 </para> 131 </para>
76 132
77 <para> 133 <para>
78 В пути файла можно использовать переменные (0.7.6+), 134 В пути файла можно использовать переменные (0.7.6+),
79 но такие логи имеют некоторые ограничения: 135 но такие логи имеют некоторые ограничения: