annotate xml/ru/docs/syslog.xml @ 1589:be92e50c52ac

Documented the "nohostname" syslog option.
author Vladimir Homutov <vl@nginx.com>
date Thu, 29 Oct 2015 16:19:42 +0300
parents 39744b9aba1b
children 54fa47139017
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
1285
4e89518a5999 Moved syslog configuration details into the separate documents.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1 <?xml version="1.0"?>
4e89518a5999 Moved syslog configuration details into the separate documents.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
2
4e89518a5999 Moved syslog configuration details into the separate documents.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
3 <!--
4e89518a5999 Moved syslog configuration details into the separate documents.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
4 Copyright (C) Nginx, Inc.
4e89518a5999 Moved syslog configuration details into the separate documents.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
5 -->
4e89518a5999 Moved syslog configuration details into the separate documents.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
6
4e89518a5999 Moved syslog configuration details into the separate documents.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
7 <!DOCTYPE article SYSTEM "../../../dtd/article.dtd">
4e89518a5999 Moved syslog configuration details into the separate documents.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
8
4e89518a5999 Moved syslog configuration details into the separate documents.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
9 <article name="Запись в syslog"
4e89518a5999 Moved syslog configuration details into the separate documents.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
10 link="/ru/docs/syslog.html"
4e89518a5999 Moved syslog configuration details into the separate documents.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
11 lang="ru"
1589
be92e50c52ac Documented the "nohostname" syslog option.
Vladimir Homutov <vl@nginx.com>
parents: 1574
diff changeset
12 rev="4">
1285
4e89518a5999 Moved syslog configuration details into the separate documents.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
13
4e89518a5999 Moved syslog configuration details into the separate documents.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
14 <section>
4e89518a5999 Moved syslog configuration details into the separate documents.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
15
4e89518a5999 Moved syslog configuration details into the separate documents.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
16 <para>
4e89518a5999 Moved syslog configuration details into the separate documents.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
17 Директивы
4e89518a5999 Moved syslog configuration details into the separate documents.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
18 <link doc="ngx_core_module.xml" id="error_log"/>
4e89518a5999 Moved syslog configuration details into the separate documents.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
19 и
4e89518a5999 Moved syslog configuration details into the separate documents.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
20 <link doc="http/ngx_http_log_module.xml" id="access_log"/>
4e89518a5999 Moved syslog configuration details into the separate documents.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
21 поддерживают запись в syslog.
4e89518a5999 Moved syslog configuration details into the separate documents.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
22 Запись в syslog настраивается при помощи следующих параметров:
4e89518a5999 Moved syslog configuration details into the separate documents.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
23 <list type="tag">
4e89518a5999 Moved syslog configuration details into the separate documents.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
24
4e89518a5999 Moved syslog configuration details into the separate documents.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
25 <tag-name><literal>server=</literal><value>адрес</value></tag-name>
4e89518a5999 Moved syslog configuration details into the separate documents.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
26 <tag-desc>
4e89518a5999 Moved syslog configuration details into the separate documents.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
27 Задаёт адрес сервера syslog.
4e89518a5999 Moved syslog configuration details into the separate documents.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
28 Адрес может быть указан в виде доменного имени, IP-адреса или
4e89518a5999 Moved syslog configuration details into the separate documents.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
29 в виде пути UNIX-сокета (указывается после префикса
4e89518a5999 Moved syslog configuration details into the separate documents.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
30 “<literal>unix:</literal>”).
1466
564bfa1ef994 Clarify that our syslog logging talks over UDP.
Ruslan Ermilov <ru@nginx.com>
parents: 1285
diff changeset
31 Вместе с именем или адресом может быть указан UDP-порт.
1285
4e89518a5999 Moved syslog configuration details into the separate documents.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
32 Если порт не указан, используется порт 514.
4e89518a5999 Moved syslog configuration details into the separate documents.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
33 Если доменному имени соответствует несколько IP-адресов,
4e89518a5999 Moved syslog configuration details into the separate documents.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
34 используется только первый адрес.
4e89518a5999 Moved syslog configuration details into the separate documents.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
35 </tag-desc>
4e89518a5999 Moved syslog configuration details into the separate documents.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
36
4e89518a5999 Moved syslog configuration details into the separate documents.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
37 <tag-name><literal>facility=</literal><value>строка</value></tag-name>
4e89518a5999 Moved syslog configuration details into the separate documents.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
38 <tag-desc>
4e89518a5999 Moved syslog configuration details into the separate documents.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
39 Задаёт категорию сообщений syslog в соответствии с
4e89518a5999 Moved syslog configuration details into the separate documents.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
40 <link url="http://tools.ietf.org/html/rfc3164#section-4.1.1">RFC 3164</link>.
4e89518a5999 Moved syslog configuration details into the separate documents.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
41 В качестве категории может быть указано одно из следующих значений:
4e89518a5999 Moved syslog configuration details into the separate documents.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
42 “<literal>kern</literal>”, “<literal>user</literal>”,
4e89518a5999 Moved syslog configuration details into the separate documents.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
43 “<literal>mail</literal>”, “<literal>daemon</literal>”,
4e89518a5999 Moved syslog configuration details into the separate documents.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
44 “<literal>auth</literal>”, “<literal>intern</literal>”,
4e89518a5999 Moved syslog configuration details into the separate documents.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
45 “<literal>lpr</literal>”, “<literal>news</literal>”, “<literal>uucp</literal>”,
4e89518a5999 Moved syslog configuration details into the separate documents.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
46 “<literal>clock</literal>”, “<literal>authpriv</literal>”,
4e89518a5999 Moved syslog configuration details into the separate documents.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
47 “<literal>ftp</literal>”, “<literal>ntp</literal>”, “<literal>audit</literal>”,
4e89518a5999 Moved syslog configuration details into the separate documents.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
48 “<literal>alert</literal>”, “<literal>cron</literal>”,
4e89518a5999 Moved syslog configuration details into the separate documents.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
49 “<literal>local0</literal>”..“<literal>local7</literal>”.
4e89518a5999 Moved syslog configuration details into the separate documents.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
50 По умолчанию используется “<literal>local7</literal>”.
4e89518a5999 Moved syslog configuration details into the separate documents.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
51 </tag-desc>
4e89518a5999 Moved syslog configuration details into the separate documents.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
52
4e89518a5999 Moved syslog configuration details into the separate documents.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
53 <tag-name><literal>severity=</literal><value>строка</value></tag-name>
4e89518a5999 Moved syslog configuration details into the separate documents.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
54 <tag-desc>
4e89518a5999 Moved syslog configuration details into the separate documents.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
55 Задаёт важность сообщений syslog для
4e89518a5999 Moved syslog configuration details into the separate documents.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
56 <link doc="http/ngx_http_log_module.xml" id="access_log"/>
4e89518a5999 Moved syslog configuration details into the separate documents.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
57 в соответствии с
4e89518a5999 Moved syslog configuration details into the separate documents.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
58 <link url="http://tools.ietf.org/html/rfc3164#section-4.1.1">RFC 3164</link>.
4e89518a5999 Moved syslog configuration details into the separate documents.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
59 Возможны те же самые значения, что и у второго параметра (уровень)
4e89518a5999 Moved syslog configuration details into the separate documents.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
60 директивы <link doc="ngx_core_module.xml" id="error_log"/>.
4e89518a5999 Moved syslog configuration details into the separate documents.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
61 По умолчанию используется “<literal>info</literal>”.
1574
Vladimir Homutov <vl@nginx.com>
parents: 1572
diff changeset
62 <note>
Vladimir Homutov <vl@nginx.com>
parents: 1572
diff changeset
63 Важность сообщений об ошибках определяется самим nginx, поэтому
1572
8df0327a1c87 The "severity" syslog parameter is not supported in "error_log".
Vladimir Homutov <vl@nginx.com>
parents: 1466
diff changeset
64 в директиве <literal>error_log</literal> параметр игнорируется.
8df0327a1c87 The "severity" syslog parameter is not supported in "error_log".
Vladimir Homutov <vl@nginx.com>
parents: 1466
diff changeset
65 </note>
1285
4e89518a5999 Moved syslog configuration details into the separate documents.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
66 </tag-desc>
4e89518a5999 Moved syslog configuration details into the separate documents.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
67
4e89518a5999 Moved syslog configuration details into the separate documents.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
68 <tag-name><literal>tag=</literal><value>строка</value></tag-name>
4e89518a5999 Moved syslog configuration details into the separate documents.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
69 <tag-desc>
4e89518a5999 Moved syslog configuration details into the separate documents.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
70 Задаёт метку сообщений syslog.
4e89518a5999 Moved syslog configuration details into the separate documents.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
71 По умолчанию используется “<literal>nginx</literal>”.
4e89518a5999 Moved syslog configuration details into the separate documents.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
72 </tag-desc>
4e89518a5999 Moved syslog configuration details into the separate documents.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
73
1589
be92e50c52ac Documented the "nohostname" syslog option.
Vladimir Homutov <vl@nginx.com>
parents: 1574
diff changeset
74 <tag-name><literal>nohostname</literal></tag-name>
be92e50c52ac Documented the "nohostname" syslog option.
Vladimir Homutov <vl@nginx.com>
parents: 1574
diff changeset
75 <tag-desc>
be92e50c52ac Documented the "nohostname" syslog option.
Vladimir Homutov <vl@nginx.com>
parents: 1574
diff changeset
76 Запрещает добавление поля “hostname” в заголовок сообщения syslog (1.9.7).
be92e50c52ac Documented the "nohostname" syslog option.
Vladimir Homutov <vl@nginx.com>
parents: 1574
diff changeset
77 </tag-desc>
be92e50c52ac Documented the "nohostname" syslog option.
Vladimir Homutov <vl@nginx.com>
parents: 1574
diff changeset
78
1285
4e89518a5999 Moved syslog configuration details into the separate documents.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
79 <!--
4e89518a5999 Moved syslog configuration details into the separate documents.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
80 <tag-name><literal>bare=</literal><literal>on</literal> |
4e89518a5999 Moved syslog configuration details into the separate documents.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
81 <literal>off</literal></tag-name>
4e89518a5999 Moved syslog configuration details into the separate documents.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
82 <tag-desc>
4e89518a5999 Moved syslog configuration details into the separate documents.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
83 Если включено, сообщения отправляются без заголовка syslog.
4e89518a5999 Moved syslog configuration details into the separate documents.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
84 По умолчанию выключено.
4e89518a5999 Moved syslog configuration details into the separate documents.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
85 </tag-desc>
4e89518a5999 Moved syslog configuration details into the separate documents.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
86 -->
4e89518a5999 Moved syslog configuration details into the separate documents.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
87
4e89518a5999 Moved syslog configuration details into the separate documents.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
88 </list>
4e89518a5999 Moved syslog configuration details into the separate documents.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
89 Пример конфигурации syslog:
4e89518a5999 Moved syslog configuration details into the separate documents.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
90 <example>
4e89518a5999 Moved syslog configuration details into the separate documents.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
91 error_log syslog:server=192.168.1.1 debug;
4e89518a5999 Moved syslog configuration details into the separate documents.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
92
1589
be92e50c52ac Documented the "nohostname" syslog option.
Vladimir Homutov <vl@nginx.com>
parents: 1574
diff changeset
93 access_log syslog:server=unix:/var/log/nginx.sock,nohostname;
1285
4e89518a5999 Moved syslog configuration details into the separate documents.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
94 access_log syslog:server=[2001:db8::1]:12345,facility=local7,tag=nginx,severity=info combined;
4e89518a5999 Moved syslog configuration details into the separate documents.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
95 </example>
4e89518a5999 Moved syslog configuration details into the separate documents.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
96 </para>
4e89518a5999 Moved syslog configuration details into the separate documents.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
97
4e89518a5999 Moved syslog configuration details into the separate documents.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
98 <para>
4e89518a5999 Moved syslog configuration details into the separate documents.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
99 <note>
4e89518a5999 Moved syslog configuration details into the separate documents.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
100 Запись в syslog доступна начиная с версии 1.7.1.
4e89518a5999 Moved syslog configuration details into the separate documents.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
101 Как часть
4e89518a5999 Moved syslog configuration details into the separate documents.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
102 <commercial_version>коммерческой подписки</commercial_version>
4e89518a5999 Moved syslog configuration details into the separate documents.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
103 запись в syslog доступна начиная с версии 1.5.3.
4e89518a5999 Moved syslog configuration details into the separate documents.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
104 </note>
4e89518a5999 Moved syslog configuration details into the separate documents.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
105 </para>
4e89518a5999 Moved syslog configuration details into the separate documents.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
106
4e89518a5999 Moved syslog configuration details into the separate documents.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
107 </section>
4e89518a5999 Moved syslog configuration details into the separate documents.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
108
4e89518a5999 Moved syslog configuration details into the separate documents.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
109 </article>