Mercurial > hg > nginx-site

changeset 1176:4eea26b34ea5

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
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 e33858baaecd
files xml/ru/docs/http/ngx_http_log_module.xml
diffstat 1 files changed, 23 insertions(+), 4 deletions(-) [+]
line wrap: on
line diff
--- a/xml/ru/docs/http/ngx_http_log_module.xml
+++ b/xml/ru/docs/http/ngx_http_log_module.xml
@@ -10,7 +10,7 @@
 <module name="Модуль ngx_http_log_module"
         link="/ru/docs/http/ngx_http_log_module.html"
         lang="ru"
-        rev="11">
+        rev="12">
 
 <section id="summary">
 
@@ -52,16 +52,19 @@ access_log /spool/logs/nginx-access.log 
     <value>путь</value>
     [<value>формат</value>
     [<literal>buffer</literal>=<value>размер</value>
-    [<literal>flush</literal>=<value>время</value>]]]</syntax>
+    [<literal>flush</literal>=<value>время</value>]]
+    [<literal>if</literal>=<value>условие</value>]]</syntax>
 <syntax>
     <value>путь</value>
     <value>формат</value>
     <literal>gzip[=<value>степень</value>]</literal>
     [<literal>buffer</literal>=<value>размер</value>]
-    [<literal>flush</literal>=<value>время</value>]</syntax>
+    [<literal>flush</literal>=<value>время</value>]
+    [<literal>if</literal>=<value>условие</value>]</syntax>
 <syntax>
     <literal>syslog:</literal><literal>server</literal>=<value>адрес</value>[,<value>параметр</value>=<value>значение</value>]
-    [<value>формат</value>]</syntax>
+    [<value>формат</value>
+    [<literal>if</literal>=<value>условие</value>]]</syntax>
 <syntax><literal>off</literal></syntax>
 <default>logs/access.log combined</default>
 <context>http</context>
@@ -177,6 +180,22 @@ server {
 </para>
 
 <para>
+Параметр <literal>if</literal> (1.7.0) включает условную запись в лог.
+Запрос не будет записываться в лог, если результатом вычисления
+<value>условия</value> является “0” или пустая строка.
+В следующем примере запросы с кодами ответа 2xx и 3xx
+не будут записываться в лог:
+<example>
+map $status $loggable {
+    ~^[23]  0;
+    default 1;
+}
+
+access_log /path/to/access.log combined if=$loggable;
+</example>
+</para>
+
+<para>
 Запись в syslog настраивается при помощи следующих параметров:
 <list type="tag">