<?xml version="1.0"?>

<!--
  Copyright (C) Nginx, Inc.
  -->

<!DOCTYPE article SYSTEM "../../../dtd/article.dtd">

<article name="Запись в syslog"
         link="/ru/docs/syslog.html"
         lang="ru"
         rev="6">

<section>

<para>
Директивы
<link doc="ngx_core_module.xml" id="error_log"/>
и
<link doc="http/ngx_http_log_module.xml" id="access_log"/>
поддерживают запись в syslog.
Запись в syslog настраивается при помощи следующих параметров:
<list type="tag">

<tag-name><literal>server=</literal><value>адрес</value></tag-name>
<tag-desc>
Задаёт адрес сервера syslog.
Адрес может быть указан в виде доменного имени или IP-адреса,
и необязательного порта, или в виде пути UNIX-сокета, который
указывается после префикса “<literal>unix:</literal>”.
Если порт не указан, используется UDP-порт 514.
Если доменному имени соответствует несколько IP-адресов,
используется только первый адрес.
</tag-desc>

<tag-name><literal>facility=</literal><value>строка</value></tag-name>
<tag-desc>
Задаёт категорию сообщений syslog в соответствии с
<link url="https://datatracker.ietf.org/doc/html/rfc3164#section-4.1.1">RFC 3164</link>.
В качестве категории может быть указано одно из следующих значений:
“<literal>kern</literal>”, “<literal>user</literal>”,
“<literal>mail</literal>”, “<literal>daemon</literal>”,
“<literal>auth</literal>”, “<literal>intern</literal>”,
“<literal>lpr</literal>”, “<literal>news</literal>”, “<literal>uucp</literal>”,
“<literal>clock</literal>”, “<literal>authpriv</literal>”,
“<literal>ftp</literal>”, “<literal>ntp</literal>”, “<literal>audit</literal>”,
“<literal>alert</literal>”, “<literal>cron</literal>”,
“<literal>local0</literal>”..“<literal>local7</literal>”.
По умолчанию используется “<literal>local7</literal>”.
</tag-desc>

<tag-name><literal>severity=</literal><value>строка</value></tag-name>
<tag-desc>
Задаёт важность сообщений syslog для
<link doc="http/ngx_http_log_module.xml" id="access_log"/>
в соответствии с
<link url="https://datatracker.ietf.org/doc/html/rfc3164#section-4.1.1">RFC 3164</link>.
Возможны те же самые значения, что и у второго параметра (уровень)
директивы <link doc="ngx_core_module.xml" id="error_log"/>.
По умолчанию используется “<literal>info</literal>”.
<note>
Важность сообщений об ошибках определяется самим nginx, поэтому
в директиве <literal>error_log</literal> параметр игнорируется.
</note>
</tag-desc>

<tag-name><literal>tag=</literal><value>строка</value></tag-name>
<tag-desc>
Задаёт метку сообщений syslog.
По умолчанию используется “<literal>nginx</literal>”.
</tag-desc>

<tag-name><literal>nohostname</literal></tag-name>
<tag-desc>
Запрещает добавление поля “hostname” в заголовок сообщения syslog (1.9.7).
</tag-desc>

<!--
<tag-name><literal>bare=</literal><literal>on</literal> |
<literal>off</literal></tag-name>
<tag-desc>
Если включено, сообщения отправляются без заголовка syslog.
По умолчанию выключено.
</tag-desc>
-->

</list>
Пример конфигурации syslog:
<example>
error_log syslog:server=192.168.1.1 debug;

access_log syslog:server=unix:/var/log/nginx.sock,nohostname;
access_log syslog:server=[2001:db8::1]:12345,facility=local7,tag=nginx,severity=info combined;
</example>
</para>

<para>
<note>
Запись в syslog доступна начиная с версии 1.7.1.
Как часть
<commercial_version>коммерческой подписки</commercial_version>
запись в syslog доступна начиная с версии 1.5.3.
</note>
</para>

</section>

</article>