Mercurial > hg > nginx-site

changeset 1285:4e89518a5999

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Moved syslog configuration details into the separate documents.
author Ruslan Ermilov <ru@nginx.com>
date Mon, 08 Sep 2014 17:21:16 +0400
parents d3548b46b87f
children c102344a0fa0
files dtd/content.dtd xml/en/GNUmakefile xml/en/docs/http/ngx_http_log_module.xml xml/en/docs/index.xml xml/en/docs/ngx_core_module.xml xml/en/docs/syslog.xml xml/en/index.xml xml/ru/GNUmakefile xml/ru/docs/http/ngx_http_log_module.xml xml/ru/docs/index.xml xml/ru/docs/ngx_core_module.xml xml/ru/docs/syslog.xml xml/ru/index.xml
diffstat 13 files changed, 238 insertions(+), 291 deletions(-) [+]
line wrap: on
line diff
--- a/dtd/content.dtd
+++ b/dtd/content.dtd
@@ -12,7 +12,7 @@
 
 <!ELEMENT  para         (#PCDATA | link | links | varlinks | br | list | note |
                          i | b | nobr | table | literal | command |
-                         path | header | value | programlisting |
+                         path | example | header | value | programlisting |
                          initial |
                          mainline_version | stable_version | commercial_version |
                          registered | c-func | http-status)* >
@@ -35,6 +35,7 @@
 <!ELEMENT  path         (#PCDATA | value |
                          mainline_version | stable_version | commercial_version)* >
 <!ELEMENT  literal      (#PCDATA | value)* >
+<!ELEMENT  example      (#PCDATA | value)* >
 <!ELEMENT  header       (#PCDATA) >
 <!ELEMENT  initial      (#PCDATA) >
 <!ELEMENT  value        (#PCDATA) >
@@ -54,9 +55,9 @@
 
 <!ELEMENT  nobr         (#PCDATA | b | command | i | literal | path)* >
 
-<!ELEMENT  list         (listitem+) >
+<!ELEMENT  list         (listitem+ | (tag-name | tag-desc)+) >
 <!ATTLIST  list
-           type         (bullet | enum) #REQUIRED
+           type         (bullet | enum | tag) #REQUIRED
            compact      (yes | no) "yes"
 >
 
@@ -68,6 +69,13 @@
            id           ID #IMPLIED
 >
 
+<!ELEMENT  tag-name     ANY >
+<!ATTLIST  tag-name
+           id           ID #IMPLIED
+>
+
+<!ELEMENT  tag-desc     ANY >
+
 <!ELEMENT  note         (#PCDATA | para | br | list | i | b | link |
                          nobr | table | literal | command | path |
                          header | programlisting | initial | paypal |
--- a/xml/en/GNUmakefile
+++ b/xml/en/GNUmakefile
@@ -6,6 +6,7 @@ DOCS =									\
 		syntax							\
 		control							\
 		hash							\
+		syslog							\
 		dirindex						\
 		varindex						\
 		http/request_processing					\
--- a/xml/en/docs/http/ngx_http_log_module.xml
+++ b/xml/en/docs/http/ngx_http_log_module.xml
@@ -10,7 +10,7 @@
 <module name="Module ngx_http_log_module"
         link="/en/docs/http/ngx_http_log_module.html"
         lang="en"
-        rev="13">
+        rev="14">
 
 <section id="summary">
 
@@ -75,7 +75,8 @@ access_log /spool/logs/nginx-access.log 
 <para>
 Sets the path, format, and configuration for a buffered log write.
 Several logs can be specified on the same level.
-Logging to syslog can be configured by specifying
+Logging to <link doc="../syslog.xml">syslog</link>
+can be configured by specifying
 the “<literal>syslog:</literal>” prefix in the first parameter.
 The special value <literal>off</literal> cancels all
 <literal>access_log</literal> directives on the current level.
@@ -197,79 +198,6 @@ access_log /path/to/access.log combined 
 </example>
 </para>
 
-<para>
-The following parameters configure logging to syslog:
-<list type="tag">
-
-<tag-name><literal>server=</literal><value>address</value></tag-name>
-<tag-desc>
-Defines the address of a syslog server.
-The address can be specified as a domain name, IP address, or
-a UNIX-domain socket path (specified after the “<literal>unix:</literal>”
-prefix).
-With a domain name or IP address, the port can be specified.
-If port is not specified, the port 514 is used.
-If a domain name resolves to several IP addresses, the first resolved
-address is used.
-</tag-desc>
-
-<tag-name><literal>facility=</literal><value>string</value></tag-name>
-<tag-desc>
-Sets facility of syslog messages, as defined in
-<link url="http://tools.ietf.org/html/rfc3164#section-4.1.1">RFC 3164</link>.
-Facility can be one of “<literal>kern</literal>”, “<literal>user</literal>”,
-“<literal>mail</literal>”, “<literal>daemon</literal>”,
-“<literal>auth</literal>”, “<literal>intern</literal>”,
-“<literal>lpr</literal>”, “<literal>news</literal>”, “<literal>uucp</literal>”,
-“<literal>clock</literal>”, “<literal>authpriv</literal>”,
-“<literal>ftp</literal>”, “<literal>ntp</literal>”, “<literal>audit</literal>”,
-“<literal>alert</literal>”, “<literal>cron</literal>”,
-“<literal>local0</literal>”..“<literal>local7</literal>”.
-Default is “<literal>local7</literal>”.
-</tag-desc>
-
-<tag-name><literal>severity=</literal><value>string</value></tag-name>
-<tag-desc>
-Sets severity of syslog messages, as defined in
-<link url="http://tools.ietf.org/html/rfc3164#section-4.1.1">RFC 3164</link>.
-Possible values are the same as for the second parameter (level) of the
-<link doc="../ngx_core_module.xml" id="error_log"/> directive.
-Default is “<literal>info</literal>”.
-</tag-desc>
-
-<tag-name><literal>tag=</literal><value>string</value></tag-name>
-<tag-desc>
-Sets the tag of syslog messages.
-Default is “<literal>nginx</literal>”.
-</tag-desc>
-
-<!--
-<tag-name><literal>bare=</literal><literal>on</literal> |
-<literal>off</literal></tag-name>
-<tag-desc>
-If enabled, messages are sent without syslog headers.
-Default is <literal>off</literal>.
-</tag-desc>
--->
-
-</list>
-Example syslog configuration:
-<example>
-access_log syslog:server=192.168.1.1;
-access_log syslog:server=unix:/var/log/nginx.sock;
-access_log syslog:server=[2001:db8::1]:12345,facility=local7,tag=nginx,severity=info combined;
-</example>
-</para>
-
-<para>
-<note>
-Logging to syslog is available since version 1.7.1.
-As part of our
-<commercial_version>commercial subscription</commercial_version>
-logging to syslog is available since version 1.5.3.
-</note>
-</para>
-
 </directive>
 
 
--- a/xml/en/docs/index.xml
+++ b/xml/en/docs/index.xml
@@ -8,7 +8,7 @@
 <article name="nginx documentation"
          link="/en/docs/"
          lang="en"
-         rev="14"
+         rev="15"
          toc="no">
 
 
@@ -46,6 +46,10 @@
 </listitem>
 
 <listitem>
+<link doc="syslog.xml"/>
+</listitem>
+
+<listitem>
 <link doc="syntax.xml"/>
 </listitem>
 
--- a/xml/en/docs/ngx_core_module.xml
+++ b/xml/en/docs/ngx_core_module.xml
@@ -10,7 +10,7 @@
 <module name="Core functionality"
         link="/en/docs/ngx_core_module.html"
         lang="en"
-        rev="10">
+        rev="11">
 
 <section id="example" name="Example Configuration">
 
@@ -171,7 +171,7 @@ The first parameter defines a file that 
 If filename is not absolute, it is prefixed with the prefix path.
 -->
 The special value <literal>stderr</literal> selects the standard error file.
-Logging to syslog can be configured by specifying
+Logging to <link doc="syslog.xml">syslog</link> can be configured by specifying
 the “<literal>syslog:</literal>” prefix.
 </para>
 
@@ -192,69 +192,6 @@ see “<link doc="debugging_log.xml"/>”.
 </note>
 </para>
 
-<para>
-The following parameters configure logging to syslog:
-<list type="tag">
-
-<tag-name><literal>server=</literal><value>address</value></tag-name>
-<tag-desc>
-Defines an address of a syslog server.
-An address can be specified as a domain name or IP address,
-and an optional port, or as a UNIX-domain socket path
-specified after the “<literal>unix:</literal>” prefix.
-If port is not specified, the port 514 is used.
-If a domain name resolves to several IP addresses, the first resolved
-address is used.
-</tag-desc>
-
-<tag-name><literal>facility=</literal><value>string</value></tag-name>
-<tag-desc>
-Sets facility of syslog messages, as defined in
-<link url="http://tools.ietf.org/html/rfc3164#section-4.1.1">RFC 3164</link>.
-Facility can be one of “<literal>kern</literal>”, “<literal>user</literal>”,
-“<literal>mail</literal>”, “<literal>daemon</literal>”,
-“<literal>auth</literal>”, “<literal>intern</literal>”,
-“<literal>lpr</literal>”, “<literal>news</literal>”, “<literal>uucp</literal>”,
-“<literal>clock</literal>”, “<literal>authpriv</literal>”,
-“<literal>ftp</literal>”, “<literal>ntp</literal>”, “<literal>audit</literal>”,
-“<literal>alert</literal>”, “<literal>cron</literal>”,
-“<literal>local0</literal>”..“<literal>local7</literal>”.
-Default is “<literal>local7</literal>”.
-</tag-desc>
-
-<tag-name><literal>tag=</literal><value>string</value></tag-name>
-<tag-desc>
-Sets tag of syslog messages.
-Default is “<literal>nginx</literal>”.
-</tag-desc>
-
-<!--
-<tag-name><literal>bare=</literal><literal>on</literal> |
-<literal>off</literal></tag-name>
-<tag-desc>
-If enabled, messages are sent without syslog headers.
-Default is <literal>off</literal>.
-</tag-desc>
--->
-
-</list>
-Example syslog configuration:
-<example>
-error_log syslog:server=192.168.1.1 debug;
-error_log syslog:server=unix:/var/log/nginx.sock;
-error_log syslog:server=[2001:db8::1]:12345,facility=local7,tag=nginx error;
-</example>
-</para>
-
-<para>
-<note>
-Logging to syslog is available since version 1.7.1.
-As part of our
-<commercial_version>commercial subscription</commercial_version>
-logging to syslog is available since version 1.5.3.
-</note>
-</para>
-
 </directive>
 
 
new file mode 100644
--- /dev/null
+++ b/xml/en/docs/syslog.xml
@@ -0,0 +1,99 @@
+<?xml version="1.0"?>
+
+<!--
+  Copyright (C) Nginx, Inc.
+  -->
+
+<!DOCTYPE article SYSTEM "../../../dtd/article.dtd">
+
+<article name="Logging to syslog"
+         link="/en/docs/syslog.html"
+         lang="en"
+         rev="1">
+
+<section>
+
+<para>
+The
+<link doc="ngx_core_module.xml" id="error_log"/>
+and
+<link doc="http/ngx_http_log_module.xml" id="access_log"/>
+directives support logging to syslog.
+The following parameters configure logging to syslog:
+<list type="tag">
+
+<tag-name><literal>server=</literal><value>address</value></tag-name>
+<tag-desc>
+Defines the address of a syslog server.
+The address can be specified as a domain name, IP address, or
+a UNIX-domain socket path (specified after the “<literal>unix:</literal>”
+prefix).
+With a domain name or IP address, the port can be specified.
+If port is not specified, the port 514 is used.
+If a domain name resolves to several IP addresses, the first resolved
+address is used.
+</tag-desc>
+
+<tag-name><literal>facility=</literal><value>string</value></tag-name>
+<tag-desc>
+Sets facility of syslog messages, as defined in
+<link url="http://tools.ietf.org/html/rfc3164#section-4.1.1">RFC 3164</link>.
+Facility can be one of “<literal>kern</literal>”, “<literal>user</literal>”,
+“<literal>mail</literal>”, “<literal>daemon</literal>”,
+“<literal>auth</literal>”, “<literal>intern</literal>”,
+“<literal>lpr</literal>”, “<literal>news</literal>”, “<literal>uucp</literal>”,
+“<literal>clock</literal>”, “<literal>authpriv</literal>”,
+“<literal>ftp</literal>”, “<literal>ntp</literal>”, “<literal>audit</literal>”,
+“<literal>alert</literal>”, “<literal>cron</literal>”,
+“<literal>local0</literal>”..“<literal>local7</literal>”.
+Default is “<literal>local7</literal>”.
+</tag-desc>
+
+<tag-name><literal>severity=</literal><value>string</value></tag-name>
+<tag-desc>
+Sets severity of syslog messages for
+<link doc="http/ngx_http_log_module.xml" id="access_log"/>,
+as defined in
+<link url="http://tools.ietf.org/html/rfc3164#section-4.1.1">RFC 3164</link>.
+Possible values are the same as for the second parameter (level) of the
+<link doc="ngx_core_module.xml" id="error_log"/> directive.
+Default is “<literal>info</literal>”.
+</tag-desc>
+
+<tag-name><literal>tag=</literal><value>string</value></tag-name>
+<tag-desc>
+Sets the tag of syslog messages.
+Default is “<literal>nginx</literal>”.
+</tag-desc>
+
+<!--
+<tag-name><literal>bare=</literal><literal>on</literal> |
+<literal>off</literal></tag-name>
+<tag-desc>
+If enabled, messages are sent without syslog headers.
+Default is <literal>off</literal>.
+</tag-desc>
+-->
+
+</list>
+Example syslog configuration:
+<example>
+error_log syslog:server=192.168.1.1 debug;
+
+access_log syslog:server=unix:/var/log/nginx.sock;
+access_log syslog:server=[2001:db8::1]:12345,facility=local7,tag=nginx,severity=info combined;
+</example>
+</para>
+
+<para>
+<note>
+Logging to syslog is available since version 1.7.1.
+As part of our
+<commercial_version>commercial subscription</commercial_version>
+logging to syslog is available since version 1.5.3.
+</note>
+</para>
+
+</section>
+
+</article>
--- a/xml/en/index.xml
+++ b/xml/en/index.xml
@@ -8,7 +8,7 @@
 <article name="nginx"
          link="/en/"
          lang="en"
-         rev="25">
+         rev="26">
 
 
 <section>
@@ -128,8 +128,9 @@ executable</link> without interruption o
 <link doc="docs/http/ngx_http_log_module.xml" id="log_format">Access
 log formats</link>,
 <link doc="docs/http/ngx_http_log_module.xml" id="access_log">buffered
-log writing</link>, and
-<link doc="docs/control.xml" id="logs">fast log rotation</link>;
+log writing</link>,
+<link doc="docs/control.xml" id="logs">fast log rotation</link>, and
+<link doc="docs/syslog.xml">syslog logging</link>;
 </listitem>
 
 <listitem>
--- a/xml/ru/GNUmakefile
+++ b/xml/ru/GNUmakefile
@@ -8,6 +8,7 @@ DOCS =									\
 		switches						\
 		control							\
 		hash							\
+		syslog							\
 		dirindex						\
 		varindex						\
 		http/request_processing					\
--- 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="13">
+        rev="14">
 
 <section id="summary">
 
@@ -76,7 +76,8 @@ access_log /spool/logs/nginx-access.log 
 <para>
 Задаёт путь, формат и настройки буферизованной записи в лог.
 На одном уровне может использоваться несколько логов.
-Запись в syslog настраивается указанием префикса
+Запись в <link doc="../syslog.xml">syslog</link>
+настраивается указанием префикса
 “<literal>syslog:</literal>” в первом параметре.
 Специальное значение <literal>off</literal> отменяет все директивы
 <literal>access_log</literal> для текущего уровня.
@@ -195,80 +196,6 @@ access_log /path/to/access.log combined 
 </example>
 </para>
 
-<para>
-Запись в syslog настраивается при помощи следующих параметров:
-<list type="tag">
-
-<tag-name><literal>server=</literal><value>адрес</value></tag-name>
-<tag-desc>
-Задаёт адрес сервера syslog.
-Адрес может быть указан в виде доменного имени, IP-адреса или
-в виде пути UNIX-сокета (указывается после префикса
-“<literal>unix:</literal>”).
-Вместе с именем или адресом может быть указан порт.
-Если порт не указан, используется порт 514.
-Если доменному имени соответствует несколько IP-адресов,
-используется только первый адрес.
-</tag-desc>
-
-<tag-name><literal>facility=</literal><value>строка</value></tag-name>
-<tag-desc>
-Задаёт категорию сообщений syslog в соответствии с
-<link url="http://tools.ietf.org/html/rfc3164#section-4.1.1">RFC 3164</link>.
-В качестве категории может быть указано одно из следующих значений:
-“<literal>kern</literal>”, “<literal>user</literal>”,
-“<literal>mail</literal>”, “<literal>daemon</literal>”,
-“<literal>auth</literal>”, “<literal>intern</literal>”,
-“<literal>lpr</literal>”, “<literal>news</literal>”, “<literal>uucp</literal>”,
-“<literal>clock</literal>”, “<literal>authpriv</literal>”,
-“<literal>ftp</literal>”, “<literal>ntp</literal>”, “<literal>audit</literal>”,
-“<literal>alert</literal>”, “<literal>cron</literal>”,
-“<literal>local0</literal>”..“<literal>local7</literal>”.
-По умолчанию используется “<literal>local7</literal>”.
-</tag-desc>
-
-<tag-name><literal>severity=</literal><value>строка</value></tag-name>
-<tag-desc>
-Задаёт важность сообщений syslog в соответствии с
-<link url="http://tools.ietf.org/html/rfc3164#section-4.1.1">RFC 3164</link>.
-Возможны те же самые значения, что и у второго параметра (уровень)
-директивы <link doc="../ngx_core_module.xml" id="error_log"/>.
-По умолчанию используется “<literal>info</literal>”.
-</tag-desc>
-
-<tag-name><literal>tag=</literal><value>строка</value></tag-name>
-<tag-desc>
-Задаёт метку сообщений syslog.
-По умолчанию используется “<literal>nginx</literal>”.
-</tag-desc>
-
-<!--
-<tag-name><literal>bare=</literal><literal>on</literal> |
-<literal>off</literal></tag-name>
-<tag-desc>
-Если включено, сообщения отправляются без заголовка syslog.
-По умолчанию выключено.
-</tag-desc>
--->
-
-</list>
-Пример конфигурации syslog:
-<example>
-access_log syslog:server=192.168.1.1;
-access_log syslog:server=unix:/var/log/nginx.sock;
-access_log syslog:server=[2001:db8::1]:12345,facility=local7,tag=nginx,severity=info combined;
-</example>
-</para>
-
-<para>
-<note>
-Запись в syslog доступна начиная с версии 1.7.1.
-Как часть
-<commercial_version>коммерческой подписки</commercial_version>
-запись в syslog доступна начиная с версии 1.5.3.
-</note>
-</para>
-
 </directive>
 
 
--- a/xml/ru/docs/index.xml
+++ b/xml/ru/docs/index.xml
@@ -46,6 +46,10 @@
 </listitem>
 
 <listitem>
+<link doc="syslog.xml"/>
+</listitem>
+
+<listitem>
 <link doc="example.xml"/>
 </listitem>
 
--- a/xml/ru/docs/ngx_core_module.xml
+++ b/xml/ru/docs/ngx_core_module.xml
@@ -10,7 +10,7 @@
 <module name="Основная функциональность"
         link="/ru/docs/ngx_core_module.html"
         lang="ru"
-        rev="10">
+        rev="11">
 
 <section id="example" name="Пример конфигурации">
 
@@ -171,7 +171,7 @@ events {
 Если имя файла не абсолютное, к нему добавляется в начало путь префикса.
 -->
 Специальное значение <literal>stderr</literal> выбирает стандартный файл ошибок.
-Запись в syslog настраивается указанием префикса
+Запись в <link doc="syslog.xml">syslog</link> настраивается указанием префикса
 “<literal>syslog:</literal>”.
 </para>
 
@@ -191,70 +191,6 @@ nginx с <literal>--with-debug</literal>,
 </note>
 </para>
 
-<para>
-Запись в syslog настраивается при помощи следующих параметров:
-<list type="tag">
-
-<tag-name><literal>server=</literal><value>адрес</value></tag-name>
-<tag-desc>
-Задаёт адрес сервера syslog.
-Адрес может быть указан в виде доменного имени или IP-адреса,
-и необязательного порта, или в виде пути UNIX-сокета, который
-указывается после префикса “<literal>unix:</literal>”.
-Если порт не указан, используется порт 514.
-Если доменному имени соответствует несколько IP-адресов,
-используется только первый адрес.
-</tag-desc>
-
-<tag-name><literal>facility=</literal><value>строка</value></tag-name>
-<tag-desc>
-Задаёт категорию сообщений syslog в соответствии с
-<link url="http://tools.ietf.org/html/rfc3164#section-4.1.1">RFC 3164</link>.
-В качестве категории может быть указано одно из следующих значений:
-“<literal>kern</literal>”, “<literal>user</literal>”,
-“<literal>mail</literal>”, “<literal>daemon</literal>”,
-“<literal>auth</literal>”, “<literal>intern</literal>”,
-“<literal>lpr</literal>”, “<literal>news</literal>”, “<literal>uucp</literal>”,
-“<literal>clock</literal>”, “<literal>authpriv</literal>”,
-“<literal>ftp</literal>”, “<literal>ntp</literal>”, “<literal>audit</literal>”,
-“<literal>alert</literal>”, “<literal>cron</literal>”,
-“<literal>local0</literal>”..“<literal>local7</literal>”.
-По умолчанию используется “<literal>local7</literal>”.
-</tag-desc>
-
-<tag-name><literal>tag=</literal><value>строка</value></tag-name>
-<tag-desc>
-Задаёт метку сообщений syslog.
-По умолчанию используется “<literal>nginx</literal>”.
-</tag-desc>
-
-<!--
-<tag-name><literal>bare=</literal><literal>on</literal> |
-<literal>off</literal></tag-name>
-<tag-desc>
-Если включено, сообщения отправляются без заголовка syslog.
-По умолчанию выключено.
-</tag-desc>
--->
-
-</list>
-Пример конфигурации syslog:
-<example>
-error_log syslog:server=192.168.1.1 debug;
-error_log syslog:server=unix:/var/log/nginx.sock;
-error_log syslog:server=[2001:db8::1]:12345,facility=local7,tag=nginx error;
-</example>
-</para>
-
-<para>
-<note>
-Запись в syslog доступна начиная с версии 1.7.1.
-Как часть
-<commercial_version>коммерческой подписки</commercial_version>
-запись в syslog доступна начиная с версии 1.5.3.
-</note>
-</para>
-
 </directive>
 
 
new file mode 100644
--- /dev/null
+++ b/xml/ru/docs/syslog.xml
@@ -0,0 +1,100 @@
+<?xml version="1.0"?>
+
+<!--
+  Copyright (C) Nginx, Inc.
+  -->
+
+<!DOCTYPE article SYSTEM "../../../dtd/article.dtd">
+
+<article name="Запись в syslog"
+         link="/ru/docs/syslog.html"
+         lang="ru"
+         rev="1">
+
+<section>
+
+<para>
+Директивы
+<link doc="ngx_core_module.xml" id="error_log"/>
+и
+<link doc="http/ngx_http_log_module.xml" id="access_log"/>
+поддерживают запись в syslog.
+Запись в syslog настраивается при помощи следующих параметров:
+<list type="tag">
+
+<tag-name><literal>server=</literal><value>адрес</value></tag-name>
+<tag-desc>
+Задаёт адрес сервера syslog.
+Адрес может быть указан в виде доменного имени, IP-адреса или
+в виде пути UNIX-сокета (указывается после префикса
+“<literal>unix:</literal>”).
+Вместе с именем или адресом может быть указан порт.
+Если порт не указан, используется порт 514.
+Если доменному имени соответствует несколько IP-адресов,
+используется только первый адрес.
+</tag-desc>
+
+<tag-name><literal>facility=</literal><value>строка</value></tag-name>
+<tag-desc>
+Задаёт категорию сообщений syslog в соответствии с
+<link url="http://tools.ietf.org/html/rfc3164#section-4.1.1">RFC 3164</link>.
+В качестве категории может быть указано одно из следующих значений:
+“<literal>kern</literal>”, “<literal>user</literal>”,
+“<literal>mail</literal>”, “<literal>daemon</literal>”,
+“<literal>auth</literal>”, “<literal>intern</literal>”,
+“<literal>lpr</literal>”, “<literal>news</literal>”, “<literal>uucp</literal>”,
+“<literal>clock</literal>”, “<literal>authpriv</literal>”,
+“<literal>ftp</literal>”, “<literal>ntp</literal>”, “<literal>audit</literal>”,
+“<literal>alert</literal>”, “<literal>cron</literal>”,
+“<literal>local0</literal>”..“<literal>local7</literal>”.
+По умолчанию используется “<literal>local7</literal>”.
+</tag-desc>
+
+<tag-name><literal>severity=</literal><value>строка</value></tag-name>
+<tag-desc>
+Задаёт важность сообщений syslog для
+<link doc="http/ngx_http_log_module.xml" id="access_log"/>
+в соответствии с
+<link url="http://tools.ietf.org/html/rfc3164#section-4.1.1">RFC 3164</link>.
+Возможны те же самые значения, что и у второго параметра (уровень)
+директивы <link doc="ngx_core_module.xml" id="error_log"/>.
+По умолчанию используется “<literal>info</literal>”.
+</tag-desc>
+
+<tag-name><literal>tag=</literal><value>строка</value></tag-name>
+<tag-desc>
+Задаёт метку сообщений syslog.
+По умолчанию используется “<literal>nginx</literal>”.
+</tag-desc>
+
+<!--
+<tag-name><literal>bare=</literal><literal>on</literal> |
+<literal>off</literal></tag-name>
+<tag-desc>
+Если включено, сообщения отправляются без заголовка syslog.
+По умолчанию выключено.
+</tag-desc>
+-->
+
+</list>
+Пример конфигурации syslog:
+<example>
+error_log syslog:server=192.168.1.1 debug;
+
+access_log syslog:server=unix:/var/log/nginx.sock;
+access_log syslog:server=[2001:db8::1]:12345,facility=local7,tag=nginx,severity=info combined;
+</example>
+</para>
+
+<para>
+<note>
+Запись в syslog доступна начиная с версии 1.7.1.
+Как часть
+<commercial_version>коммерческой подписки</commercial_version>
+запись в syslog доступна начиная с версии 1.5.3.
+</note>
+</para>
+
+</section>
+
+</article>
--- a/xml/ru/index.xml
+++ b/xml/ru/index.xml
@@ -8,7 +8,7 @@
 <article name="nginx"
          link="/ru/"
          lang="ru"
-         rev="25">
+         rev="26">
 
 
 <section>
@@ -131,7 +131,8 @@ chunked ответы,
 форматов логов</link>,
 <link doc="docs/http/ngx_http_log_module.xml" id="access_log">буферизованная
 запись в лог</link>,
-<link doc="docs/control.xml" id="logs">быстрая ротация логов</link>;
+<link doc="docs/control.xml" id="logs">быстрая ротация логов</link>,
+<link doc="docs/syslog.xml">запись в syslog</link>;
 </listitem>
 
 <listitem>