diff xml/ru/docs/syslog.xml @ 1285:4e89518a5999

Moved syslog configuration details into the separate documents.
author Ruslan Ermilov <ru@nginx.com>
date Mon, 08 Sep 2014 17:21:16 +0400
parents
children 564bfa1ef994
line wrap: on
line diff
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>