Mercurial > hg > nginx-site
diff xml/ru/docs/ngx_core_module.xml @ 1175:a05d9fa73ce2
Documented the syslog support in "error_log" and "access_log".
author | Yaroslav Zhuravlev <yar@nginx.com> |
---|---|
date | Wed, 30 Apr 2014 19:39:37 +0400 |
parents | 6d9d4bb571a9 |
children | aab8a1667171 |
line wrap: on
line diff
--- 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="8"> + rev="9"> <section id="example" name="Пример конфигурации"> @@ -144,7 +144,8 @@ events { <directive name="error_log"> <syntax> -<value>файл</value> | <literal>stderr</literal> +<value>файл</value> | <literal>stderr</literal> | +<literal>syslog:</literal><literal>server</literal>=<value>адрес</value>[,<value>параметр</value>=<value>значение</value>] [<literal>debug</literal> | <literal>info</literal> | <literal>notice</literal> | @@ -170,6 +171,8 @@ events { Если имя файла не абсолютное, к нему добавляется в начало путь префикса. --> Специальное значение <literal>stderr</literal> выбирает стандартный файл ошибок. +Запись в syslog настраивается указанием префикса +“<literal>syslog:</literal>”. </para> <para> @@ -188,6 +191,68 @@ 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 доступна как часть +<commercial_version>коммерческой подписки</commercial_version>. +</note> +</para> + </directive>