comparison xml/ru/docs/http/ngx_http_log_module.xml @ 1176:4eea26b34ea5

Documented the "if" parameter of the "access_log" directive.
author Yaroslav Zhuravlev <yar@nginx.com>
date Wed, 30 Apr 2014 19:48:40 +0400
parents a05d9fa73ce2
children aab8a1667171
comparison
equal deleted inserted replaced
1175:a05d9fa73ce2 1176:4eea26b34ea5
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="11"> 13 rev="12">
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> записывает логи запросов
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> 54 [<literal>buffer</literal>=<value>размер</value>
55 [<literal>flush</literal>=<value>время</value>]]]</syntax> 55 [<literal>flush</literal>=<value>время</value>]]
56 [<literal>if</literal>=<value>условие</value>]]</syntax>
56 <syntax> 57 <syntax>
57 <value>путь</value> 58 <value>путь</value>
58 <value>формат</value> 59 <value>формат</value>
59 <literal>gzip[=<value>степень</value>]</literal> 60 <literal>gzip[=<value>степень</value>]</literal>
60 [<literal>buffer</literal>=<value>размер</value>] 61 [<literal>buffer</literal>=<value>размер</value>]
61 [<literal>flush</literal>=<value>время</value>]</syntax> 62 [<literal>flush</literal>=<value>время</value>]
63 [<literal>if</literal>=<value>условие</value>]</syntax>
62 <syntax> 64 <syntax>
63 <literal>syslog:</literal><literal>server</literal>=<value>адрес</value>[,<value>параметр</value>=<value>значение</value>] 65 <literal>syslog:</literal><literal>server</literal>=<value>адрес</value>[,<value>параметр</value>=<value>значение</value>]
64 [<value>формат</value>]</syntax> 66 [<value>формат</value>
67 [<literal>if</literal>=<value>условие</value>]]</syntax>
65 <syntax><literal>off</literal></syntax> 68 <syntax><literal>off</literal></syntax>
66 <default>logs/access.log combined</default> 69 <default>logs/access.log combined</default>
67 <context>http</context> 70 <context>http</context>
68 <context>server</context> 71 <context>server</context>
69 <context>location</context> 72 <context>location</context>
172 ... 175 ...
173 </example> 176 </example>
174 </listitem> 177 </listitem>
175 178
176 </list> 179 </list>
180 </para>
181
182 <para>
183 Параметр <literal>if</literal> (1.7.0) включает условную запись в лог.
184 Запрос не будет записываться в лог, если результатом вычисления
185 <value>условия</value> является “0” или пустая строка.
186 В следующем примере запросы с кодами ответа 2xx и 3xx
187 не будут записываться в лог:
188 <example>
189 map $status $loggable {
190 ~^[23] 0;
191 default 1;
192 }
193
194 access_log /path/to/access.log combined if=$loggable;
195 </example>
177 </para> 196 </para>
178 197
179 <para> 198 <para>
180 Запись в syslog настраивается при помощи следующих параметров: 199 Запись в syslog настраивается при помощи следующих параметров:
181 <list type="tag"> 200 <list type="tag">