Mercurial > hg > nginx-site

comparison xml/ru/docs/ngx_core_module.xml @ 1285:4e89518a5999

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Moved syslog configuration details into the separate documents.
author Ruslan Ermilov <ru@nginx.com>
date Mon, 08 Sep 2014 17:21:16 +0400
parents aab8a1667171
children 2333e08e277d
comparison
equal deleted inserted replaced
1284:d3548b46b87f 1285:4e89518a5999
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="10"> 13 rev="11">
14 14
15 <section id="example" name="Пример конфигурации"> 15 <section id="example" name="Пример конфигурации">
16 16
17 <para> 17 <para>
18 <example> 18 <example>
169 Первый параметр задаёт файл, который будет хранить лог. 169 Первый параметр задаёт файл, который будет хранить лог.
170 <!-- 170 <!--
171 Если имя файла не абсолютное, к нему добавляется в начало путь префикса. 171 Если имя файла не абсолютное, к нему добавляется в начало путь префикса.
172 --> 172 -->
173 Специальное значение <literal>stderr</literal> выбирает стандартный файл ошибок. 173 Специальное значение <literal>stderr</literal> выбирает стандартный файл ошибок.
174 Запись в syslog настраивается указанием префикса 174 Запись в <link doc="syslog.xml">syslog</link> настраивается указанием префикса
175 “<literal>syslog:</literal>”. 175 “<literal>syslog:</literal>”.
176 </para> 176 </para>
177 177
178 <para> 178 <para>
179 Второй параметр определяет уровень лога. 179 Второй параметр определяет уровень лога.
186 Если этот параметр не задан, используется <literal>error</literal>. 186 Если этот параметр не задан, используется <literal>error</literal>.
187 <note> 187 <note>
188 Для работы уровня лога <literal>debug</literal> необходимо сконфигурировать 188 Для работы уровня лога <literal>debug</literal> необходимо сконфигурировать
189 nginx с <literal>--with-debug</literal>, 189 nginx с <literal>--with-debug</literal>,
190 см. “<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 доступна начиная с версии 1.7.1.
252 Как часть
253 <commercial_version>коммерческой подписки</commercial_version>
254 запись в syslog доступна начиная с версии 1.5.3.
255 </note> 191 </note>
256 </para> 192 </para>
257 193
258 </directive> 194 </directive>
259 195