comparison 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
comparison
equal deleted inserted replaced
1284:d3548b46b87f 1285:4e89518a5999
1 <?xml version="1.0"?>
2
3 <!--
4 Copyright (C) Nginx, Inc.
5 -->
6
7 <!DOCTYPE article SYSTEM "../../../dtd/article.dtd">
8
9 <article name="Запись в syslog"
10 link="/ru/docs/syslog.html"
11 lang="ru"
12 rev="1">
13
14 <section>
15
16 <para>
17 Директивы
18 <link doc="ngx_core_module.xml" id="error_log"/>
19 и
20 <link doc="http/ngx_http_log_module.xml" id="access_log"/>
21 поддерживают запись в syslog.
22 Запись в syslog настраивается при помощи следующих параметров:
23 <list type="tag">
24
25 <tag-name><literal>server=</literal><value>адрес</value></tag-name>
26 <tag-desc>
27 Задаёт адрес сервера syslog.
28 Адрес может быть указан в виде доменного имени, IP-адреса или
29 в виде пути UNIX-сокета (указывается после префикса
30 “<literal>unix:</literal>”).
31 Вместе с именем или адресом может быть указан порт.
32 Если порт не указан, используется порт 514.
33 Если доменному имени соответствует несколько IP-адресов,
34 используется только первый адрес.
35 </tag-desc>
36
37 <tag-name><literal>facility=</literal><value>строка</value></tag-name>
38 <tag-desc>
39 Задаёт категорию сообщений syslog в соответствии с
40 <link url="http://tools.ietf.org/html/rfc3164#section-4.1.1">RFC 3164</link>.
41 В качестве категории может быть указано одно из следующих значений:
42 “<literal>kern</literal>”, “<literal>user</literal>”,
43 “<literal>mail</literal>”, “<literal>daemon</literal>”,
44 “<literal>auth</literal>”, “<literal>intern</literal>”,
45 “<literal>lpr</literal>”, “<literal>news</literal>”, “<literal>uucp</literal>”,
46 “<literal>clock</literal>”, “<literal>authpriv</literal>”,
47 “<literal>ftp</literal>”, “<literal>ntp</literal>”, “<literal>audit</literal>”,
48 “<literal>alert</literal>”, “<literal>cron</literal>”,
49 “<literal>local0</literal>”..“<literal>local7</literal>”.
50 По умолчанию используется “<literal>local7</literal>”.
51 </tag-desc>
52
53 <tag-name><literal>severity=</literal><value>строка</value></tag-name>
54 <tag-desc>
55 Задаёт важность сообщений syslog для
56 <link doc="http/ngx_http_log_module.xml" id="access_log"/>
57 в соответствии с
58 <link url="http://tools.ietf.org/html/rfc3164#section-4.1.1">RFC 3164</link>.
59 Возможны те же самые значения, что и у второго параметра (уровень)
60 директивы <link doc="ngx_core_module.xml" id="error_log"/>.
61 По умолчанию используется “<literal>info</literal>”.
62 </tag-desc>
63
64 <tag-name><literal>tag=</literal><value>строка</value></tag-name>
65 <tag-desc>
66 Задаёт метку сообщений syslog.
67 По умолчанию используется “<literal>nginx</literal>”.
68 </tag-desc>
69
70 <!--
71 <tag-name><literal>bare=</literal><literal>on</literal> |
72 <literal>off</literal></tag-name>
73 <tag-desc>
74 Если включено, сообщения отправляются без заголовка syslog.
75 По умолчанию выключено.
76 </tag-desc>
77 -->
78
79 </list>
80 Пример конфигурации syslog:
81 <example>
82 error_log syslog:server=192.168.1.1 debug;
83
84 access_log syslog:server=unix:/var/log/nginx.sock;
85 access_log syslog:server=[2001:db8::1]:12345,facility=local7,tag=nginx,severity=info combined;
86 </example>
87 </para>
88
89 <para>
90 <note>
91 Запись в syslog доступна начиная с версии 1.7.1.
92 Как часть
93 <commercial_version>коммерческой подписки</commercial_version>
94 запись в syslog доступна начиная с версии 1.5.3.
95 </note>
96 </para>
97
98 </section>
99
100 </article>