Mercurial > hg > nginx-site

comparison xml/ru/docs/ngx_core_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 6d9d4bb571a9
children aab8a1667171
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="Основная функциональность" 10 <module name="Основная функциональность"
11 link="/ru/docs/ngx_core_module.html" 11 link="/ru/docs/ngx_core_module.html"
12 lang="ru" 12 lang="ru"
13 rev="8"> 13 rev="9">
14 14
15 <section id="example" name="Пример конфигурации"> 15 <section id="example" name="Пример конфигурации">
16 16
17 <para> 17 <para>
18 <example> 18 <example>
142 </directive> 142 </directive>
143 143
144 144
145 <directive name="error_log"> 145 <directive name="error_log">
146 <syntax> 146 <syntax>
147 <value>файл</value> | <literal>stderr</literal> 147 <value>файл</value> | <literal>stderr</literal> |
148 <literal>syslog:</literal><literal>server</literal>=<value>адрес</value>[,<value>параметр</value>=<value>значение</value>]
148 [<literal>debug</literal> | 149 [<literal>debug</literal> |
149 <literal>info</literal> | 150 <literal>info</literal> |
150 <literal>notice</literal> | 151 <literal>notice</literal> |
151 <literal>warn</literal> | 152 <literal>warn</literal> |
152 <literal>error</literal> | 153 <literal>error</literal> |
168 Первый параметр задаёт файл, который будет хранить лог. 169 Первый параметр задаёт файл, который будет хранить лог.
169 <!-- 170 <!--
170 Если имя файла не абсолютное, к нему добавляется в начало путь префикса. 171 Если имя файла не абсолютное, к нему добавляется в начало путь префикса.
171 --> 172 -->
172 Специальное значение <literal>stderr</literal> выбирает стандартный файл ошибок. 173 Специальное значение <literal>stderr</literal> выбирает стандартный файл ошибок.
174 Запись в syslog настраивается указанием префикса
175 “<literal>syslog:</literal>”.
173 </para> 176 </para>
174 177
175 <para> 178 <para>
176 Второй параметр определяет уровень лога. 179 Второй параметр определяет уровень лога.
177 Уровни лога, указанные выше, перечислены в порядке возрастания важности. 180 Уровни лога, указанные выше, перечислены в порядке возрастания важности.
183 Если этот параметр не задан, используется <literal>error</literal>. 186 Если этот параметр не задан, используется <literal>error</literal>.
184 <note> 187 <note>
185 Для работы уровня лога <literal>debug</literal> необходимо сконфигурировать 188 Для работы уровня лога <literal>debug</literal> необходимо сконфигурировать
186 nginx с <literal>--with-debug</literal>, 189 nginx с <literal>--with-debug</literal>,
187 см. “<link doc="debugging_log.xml"/>”. 190 см. “<link doc="debugging_log.xml"/>”.
191 </note>
192 </para>
193
194 <para>
195 Запись в syslog настраивается при помощи следующих параметров:
196 <list type="tag">
197
198 <tag-name><literal>server=</literal><value>адрес</value></tag-name>
199 <tag-desc>
200 Задаёт адрес сервера syslog.
201 Адрес может быть указан в виде доменного имени или IP-адреса,
202 и необязательного порта, или в виде пути UNIX-сокета, который
203 указывается после префикса “<literal>unix:</literal>”.
204 Если порт не указан, используется порт 514.
205 Если доменному имени соответствует несколько IP-адресов,
206 используется только первый адрес.
207 </tag-desc>
208
209 <tag-name><literal>facility=</literal><value>строка</value></tag-name>
210 <tag-desc>
211 Задаёт категорию сообщений syslog в соответствии с
212 <link url="http://tools.ietf.org/html/rfc3164#section-4.1.1">RFC 3164</link>.
213 В качестве категории может быть указано одно из следующих значений:
214 “<literal>kern</literal>”, “<literal>user</literal>”,
215 “<literal>mail</literal>”, “<literal>daemon</literal>”,
216 “<literal>auth</literal>”, “<literal>intern</literal>”,
217 “<literal>lpr</literal>”, “<literal>news</literal>”, “<literal>uucp</literal>”,
218 “<literal>clock</literal>”, “<literal>authpriv</literal>”,
219 “<literal>ftp</literal>”, “<literal>ntp</literal>”, “<literal>audit</literal>”,
220 “<literal>alert</literal>”, “<literal>cron</literal>”,
221 “<literal>local0</literal>”..“<literal>local7</literal>”.
222 По умолчанию используется “<literal>local7</literal>”.
223 </tag-desc>
224
225 <tag-name><literal>tag=</literal><value>строка</value></tag-name>
226 <tag-desc>
227 Задаёт метку сообщений syslog.
228 По умолчанию используется “<literal>nginx</literal>”.
229 </tag-desc>
230
231 <!--
232 <tag-name><literal>bare=</literal><literal>on</literal> |
233 <literal>off</literal></tag-name>
234 <tag-desc>
235 Если включено, сообщения отправляются без заголовка syslog.
236 По умолчанию выключено.
237 </tag-desc>
238 -->
239
240 </list>
241 Пример конфигурации syslog:
242 <example>
243 error_log syslog:server=192.168.1.1 debug;
244 error_log syslog:server=unix:/var/log/nginx.sock;
245 error_log syslog:server=[2001:db8::1]:12345,facility=local7,tag=nginx error;
246 </example>
247 </para>
248
249 <para>
250 <note>
251 Запись в syslog доступна как часть
252 <commercial_version>коммерческой подписки</commercial_version>.
188 </note> 253 </note>
189 </para> 254 </para>
190 255
191 </directive> 256 </directive>
192 257