Mercurial > hg > nginx-site
comparison xml/ru/docs/http/ngx_http_log_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 | 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 |