Mercurial > hg > nginx-site

comparison xml/ru/docs/http/ngx_http_log_module.xml @ 1175:a05d9fa73ce2

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
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 07402a11fd8d
children 4eea26b34ea5
comparison
equal deleted inserted replaced
1174:f121a423a6dd 1175:a05d9fa73ce2
8 <!DOCTYPE module SYSTEM "../../../../dtd/module.dtd"> 8 <!DOCTYPE module SYSTEM "../../../../dtd/module.dtd">
9 9
10 <module name="Модуль ngx_http_log_module" 10 <module name="Модуль ngx_http_log_module"
11 link="/ru/docs/http/ngx_http_log_module.html" 11 link="/ru/docs/http/ngx_http_log_module.html"
12 lang="ru" 12 lang="ru"
13 rev="10"> 13 rev="11">
14 14
15 <section id="summary"> 15 <section id="summary">
16 16
17 <para> 17 <para>
18 Модуль <literal>ngx_http_log_module</literal> записывает логи запросов 18 Модуль <literal>ngx_http_log_module</literal> записывает логи запросов
57 <value>путь</value> 57 <value>путь</value>
58 <value>формат</value> 58 <value>формат</value>
59 <literal>gzip[=<value>степень</value>]</literal> 59 <literal>gzip[=<value>степень</value>]</literal>
60 [<literal>buffer</literal>=<value>размер</value>] 60 [<literal>buffer</literal>=<value>размер</value>]
61 [<literal>flush</literal>=<value>время</value>]</syntax> 61 [<literal>flush</literal>=<value>время</value>]</syntax>
62 <syntax>
63 <literal>syslog:</literal><literal>server</literal>=<value>адрес</value>[,<value>параметр</value>=<value>значение</value>]
64 [<value>формат</value>]</syntax>
62 <syntax><literal>off</literal></syntax> 65 <syntax><literal>off</literal></syntax>
63 <default>logs/access.log combined</default> 66 <default>logs/access.log combined</default>
64 <context>http</context> 67 <context>http</context>
65 <context>server</context> 68 <context>server</context>
66 <context>location</context> 69 <context>location</context>
68 <context>limit_except</context> 71 <context>limit_except</context>
69 72
70 <para> 73 <para>
71 Задаёт путь, формат и настройки буферизованной записи в лог. 74 Задаёт путь, формат и настройки буферизованной записи в лог.
72 На одном уровне может использоваться несколько логов. 75 На одном уровне может использоваться несколько логов.
76 Запись в syslog настраивается указанием префикса
77 “<literal>syslog:</literal>” в первом параметре.
73 Специальное значение <literal>off</literal> отменяет все директивы 78 Специальное значение <literal>off</literal> отменяет все директивы
74 <literal>access_log</literal> для текущего уровня. 79 <literal>access_log</literal> для текущего уровня.
75 Если формат не указан, то используется предопределённый формат 80 Если формат не указан, то используется предопределённый формат
76 “<literal>combined</literal>”. 81 “<literal>combined</literal>”.
77 </para> 82 </para>
167 ... 172 ...
168 </example> 173 </example>
169 </listitem> 174 </listitem>
170 175
171 </list> 176 </list>
177 </para>
178
179 <para>
180 Запись в syslog настраивается при помощи следующих параметров:
181 <list type="tag">
182
183 <tag-name><literal>server=</literal><value>адрес</value></tag-name>
184 <tag-desc>
185 Задаёт адрес сервера syslog.
186 Адрес может быть указан в виде доменного имени, IP-адреса или
187 в виде пути UNIX-сокета (указывается после префикса
188 “<literal>unix:</literal>”).
189 Вместе с именем или адресом может быть указан порт.
190 Если порт не указан, используется порт 514.
191 Если доменному имени соответствует несколько IP-адресов,
192 используется только первый адрес.
193 </tag-desc>
194
195 <tag-name><literal>facility=</literal><value>строка</value></tag-name>
196 <tag-desc>
197 Задаёт категорию сообщений syslog в соответствии с
198 <link url="http://tools.ietf.org/html/rfc3164#section-4.1.1">RFC 3164</link>.
199 В качестве категории может быть указано одно из следующих значений:
200 “<literal>kern</literal>”, “<literal>user</literal>”,
201 “<literal>mail</literal>”, “<literal>daemon</literal>”,
202 “<literal>auth</literal>”, “<literal>intern</literal>”,
203 “<literal>lpr</literal>”, “<literal>news</literal>”, “<literal>uucp</literal>”,
204 “<literal>clock</literal>”, “<literal>authpriv</literal>”,
205 “<literal>ftp</literal>”, “<literal>ntp</literal>”, “<literal>audit</literal>”,
206 “<literal>alert</literal>”, “<literal>cron</literal>”,
207 “<literal>local0</literal>”..“<literal>local7</literal>”.
208 По умолчанию используется “<literal>local7</literal>”.
209 </tag-desc>
210
211 <tag-name><literal>severity=</literal><value>строка</value></tag-name>
212 <tag-desc>
213 Задаёт важность сообщений syslog в соответствии с
214 <link url="http://tools.ietf.org/html/rfc3164#section-4.1.1">RFC 3164</link>.
215 Возможны те же самые значения, что и у второго параметра (уровень)
216 директивы <link doc="../ngx_core_module.xml" id="error_log"/>.
217 По умолчанию используется “<literal>info</literal>”.
218 </tag-desc>
219
220 <tag-name><literal>tag=</literal><value>строка</value></tag-name>
221 <tag-desc>
222 Задаёт метку сообщений syslog.
223 По умолчанию используется “<literal>nginx</literal>”.
224 </tag-desc>
225
226 <!--
227 <tag-name><literal>bare=</literal><literal>on</literal> |
228 <literal>off</literal></tag-name>
229 <tag-desc>
230 Если включено, сообщения отправляются без заголовка syslog.
231 По умолчанию выключено.
232 </tag-desc>
233 -->
234
235 </list>
236 Пример конфигурации syslog:
237 <example>
238 access_log syslog:server=192.168.1.1;
239 access_log syslog:server=unix:/var/log/nginx.sock;
240 access_log syslog:server=[2001:db8::1]:12345,facility=local7,tag=nginx,severity=info combined;
241 </example>
242 </para>
243
244 <para>
245 <note>
246 Запись в syslog доступна как часть
247 <commercial_version>коммерческой подписки</commercial_version>.
248 </note>
172 </para> 249 </para>
173 250
174 </directive> 251 </directive>
175 252
176 253