Документация: ПО Факел — разрабатываемая версия

Журналирование системы

Обзор

Журналирование системы (syslog) собирает сообщения операционной системы, служб и протоколов маршрутизатора и направляет их получателям: в основной журнал, в файлы журналов, на консоль, на терминалы пользователей и на удаленные серверы syslog. Просмотр журналов описан в разделе Журналы системы.

Каждое сообщение имеет категорию (facility) и уровень важности (level). Категории обозначают источник сообщения: auth, authpriv, cron, daemon, kern, lpr, mail, mark, news, syslog, user, uucp и local0 — local7. Значение all означает все категории, кроме mark. Уровни, от самого важного к наименее важному: emerg, alert, crit, err, warning, notice, info, debug; значение all означает все сообщения. Для получателя задается набор пар «категория — уровень»: узел facility <facility> выбирает категорию, параметр level — наименее важный уровень сообщений этой категории: получатель принимает сообщения указанного уровня и более важные (например, при уровне warning — сообщения уровней warning, err, crit, alert и emerg). Если уровень не указан, используется err. Категория syslog содержит сообщения самой службы журналирования: о запуске и остановке службы и об ошибках в ее конфигурации.

Получатели сообщений настраиваются в разделе system syslog:

  • global — основной журнал системы. Узел global facility <facility> задает, какие категории и уровни попадают в основной журнал. Параметр marker interval включает запись меток (mark-сообщений) с заданным интервалом в секундах (по умолчанию 1200). Параметр preserve-fqdn включает запись полного имени узла (FQDN) вместо короткого;

  • file <file> — отдельный файл журнала /var/log/user/<file>. Параметры archive size (размер файла в килобайтах, по умолчанию 256) и archive file (число архивных файлов, по умолчанию 5) управляют ротацией файла;

  • console — вывод сообщений на консоль;

  • user <user> — вывод сообщений на терминалы указанного пользователя: сообщение выводится во всех сеансах, которые пользователь открыл в системе, даже если прием сообщений в терминале запрещен;

  • host <host> — отправка сообщений на удаленный сервер syslog. Параметр port задает порт сервера (по умолчанию 514), параметр protocol — протокол передачи, udp (по умолчанию) или tcp, параметр source-address — адрес источника. Параметр format include-timezone добавляет в сообщения часовой пояс системы, параметр format octet-counted включает передачу сообщений с указанием длины. Для протокола UDP режим octet-counted не следует использовать: при применении конфигурации выводится предупреждение WARNING: Syslog UDP transport for "<host>" should not use octet-counted format!. Адрес источника должен быть назначен интерфейсу маршрутизатора, а его семейство адресов должно совпадать с семейством адреса сервера: иначе применение конфигурации завершается ошибкой.

Параметр system syslog vrf задает экземпляр VRF, в котором работает служба журналирования. При изменении экземпляра VRF служба перезапускается, при изменении остальных параметров конфигурация перечитывается без перезапуска.

Раздел system logs logrotate задает ротацию двух журналов: основного журнала системы (messages) и журнала atop, в который система каждые 10 минут записывает сведения об использовании ресурсов. Параметр max-size задает размер файла в мегабайтах, по достижении которого файл ротируется (по умолчанию 1 для messages и 10 для atop). Параметр rotate задает число ротаций, после которого старые файлы удаляются (по умолчанию 10). Размер файлов проверяется раз в час; журнал atop, кроме того, ротируется раз в сутки. Очистка основного журнала описана в разделе Журналы системы (команда clear log).

Команды режима «Администрирование» для настройки журналирования не предусмотрены: журналы выводят команды show log (см. Журналы системы).

В текущей версии ПО Факел параметр file не создает файл журнала, форматы octet-counted и include-timezone отключают отправку на сервер, а изменение параметров не применяется к работающей службе (см. Ограничения).

Список команд

Режим «Конфигурирование»


system syslog console facility <facility>

Описание:
Задает категорию сообщений, которые выводятся на консоль.

Синтаксис:

  • set system syslog console facility <facility>

  • delete system syslog console facility <facility>

  • show system syslog console facility

Аргументы:

  • <facility> — категория (facility) сообщений. Возможные значения: all — все категории, кроме mark; auth — аутентификация и авторизация; authpriv — несистемная авторизация; cron — служба планирования заданий; daemon — системные службы; kern — ядро; lpr — подсистема печати; mail — почтовая подсистема; mark — метки времени; news — подсистема USENET; syslog — сообщения самой службы журналирования; user — прикладные процессы; uucp — подсистема UUCP; local0 — локальная категория 0; local1 — локальная категория 1; local2 — локальная категория 2; local3 — локальная категория 3; local4 — локальная категория 4; local5 — локальная категория 5; local6 — локальная категория 6; local7 — локальная категория 7.

Режим: «Конфигурирование».

system syslog console facility <facility> level <level>

Описание:
Задает уровень сообщений указанной категории, которые выводятся на консоль. Принимаются сообщения указанного уровня и более важные.

Синтаксис:

  • set system syslog console facility <facility> level <level>

  • delete system syslog console facility <facility> level <level>

  • show system syslog console facility <facility> level

Аргументы:

  • <facility> — категория (facility) сообщений. Возможные значения: all — все категории, кроме mark; auth — аутентификация и авторизация; authpriv — несистемная авторизация; cron — служба планирования заданий; daemon — системные службы; kern — ядро; lpr — подсистема печати; mail — почтовая подсистема; mark — метки времени; news — подсистема USENET; syslog — сообщения самой службы журналирования; user — прикладные процессы; uucp — подсистема UUCP; local0 — локальная категория 0; local1 — локальная категория 1; local2 — локальная категория 2; local3 — локальная категория 3; local4 — локальная категория 4; local5 — локальная категория 5; local6 — локальная категория 6; local7 — локальная категория 7.

  • <level> — уровень (level) сообщений. Возможные значения: emerg — аварийные сообщения; alert — срочные сообщения; crit — критические сообщения; err — сообщения об ошибках; warning — предупреждения; notice — сообщения, требующие внимания; info — информационные сообщения; debug — отладочные сообщения; all — все сообщения. Значение по умолчанию: err.

Режим: «Конфигурирование».

system syslog file <file>

Описание:
Создает файл журнала /var/log/user/<file>, в который записываются сообщения.

Синтаксис:

  • set system syslog file <file>

  • delete system syslog file <file>

  • show system syslog file

Аргументы:

  • <file> — имя файла журнала. Формат: строка.

Режим: «Конфигурирование».

system syslog file <file> archive file <file>

Описание:
Задает число сохраняемых архивных файлов журнала.

Синтаксис:

  • set system syslog file <file> archive file <file>

  • delete system syslog file <file> archive file <file>

  • show system syslog file <file> archive file

Аргументы:

  • <file> — имя файла журнала. Формат: строка.

  • <file> — число архивных файлов. Значение по умолчанию: 5.

Режим: «Конфигурирование».

system syslog file <file> archive size <size>

Описание:
Задает размер файла журнала в килобайтах, по достижении которого файл ротируется.

Синтаксис:

  • set system syslog file <file> archive size <size>

  • delete system syslog file <file> archive size <size>

  • show system syslog file <file> archive size

Аргументы:

  • <file> — имя файла журнала. Формат: строка.

  • <size> — размер файла в килобайтах. Значение по умолчанию: 256.

Режим: «Конфигурирование».

system syslog file <file> facility <facility>

Описание:
Задает категорию сообщений, которые записываются в файл журнала.

Синтаксис:

  • set system syslog file <file> facility <facility>

  • delete system syslog file <file> facility <facility>

  • show system syslog file <file> facility

Аргументы:

  • <file> — имя файла журнала. Формат: строка.

  • <facility> — категория (facility) сообщений. Возможные значения: all — все категории, кроме mark; auth — аутентификация и авторизация; authpriv — несистемная авторизация; cron — служба планирования заданий; daemon — системные службы; kern — ядро; lpr — подсистема печати; mail — почтовая подсистема; mark — метки времени; news — подсистема USENET; syslog — сообщения самой службы журналирования; user — прикладные процессы; uucp — подсистема UUCP; local0 — локальная категория 0; local1 — локальная категория 1; local2 — локальная категория 2; local3 — локальная категория 3; local4 — локальная категория 4; local5 — локальная категория 5; local6 — локальная категория 6; local7 — локальная категория 7.

Режим: «Конфигурирование».

system syslog file <file> facility <facility> level <level>

Описание:
Задает уровень сообщений указанной категории, которые записываются в файл журнала. Принимаются сообщения указанного уровня и более важные.

Синтаксис:

  • set system syslog file <file> facility <facility> level <level>

  • delete system syslog file <file> facility <facility> level <level>

  • show system syslog file <file> facility <facility> level

Аргументы:

  • <file> — имя файла журнала. Формат: строка.

  • <facility> — категория (facility) сообщений. Возможные значения: all — все категории, кроме mark; auth — аутентификация и авторизация; authpriv — несистемная авторизация; cron — служба планирования заданий; daemon — системные службы; kern — ядро; lpr — подсистема печати; mail — почтовая подсистема; mark — метки времени; news — подсистема USENET; syslog — сообщения самой службы журналирования; user — прикладные процессы; uucp — подсистема UUCP; local0 — локальная категория 0; local1 — локальная категория 1; local2 — локальная категория 2; local3 — локальная категория 3; local4 — локальная категория 4; local5 — локальная категория 5; local6 — локальная категория 6; local7 — локальная категория 7.

  • <level> — уровень (level) сообщений. Возможные значения: emerg — аварийные сообщения; alert — срочные сообщения; crit — критические сообщения; err — сообщения об ошибках; warning — предупреждения; notice — сообщения, требующие внимания; info — информационные сообщения; debug — отладочные сообщения; all — все сообщения. Значение по умолчанию: err.

Режим: «Конфигурирование».

system syslog global facility <facility>

Описание:
Задает категорию сообщений, которые записываются в основной журнал системы.

Синтаксис:

  • set system syslog global facility <facility>

  • delete system syslog global facility <facility>

  • show system syslog global facility

Аргументы:

  • <facility> — категория (facility) сообщений. Возможные значения: all — все категории, кроме mark; auth — аутентификация и авторизация; authpriv — несистемная авторизация; cron — служба планирования заданий; daemon — системные службы; kern — ядро; lpr — подсистема печати; mail — почтовая подсистема; mark — метки времени; news — подсистема USENET; syslog — сообщения самой службы журналирования; user — прикладные процессы; uucp — подсистема UUCP; local0 — локальная категория 0; local1 — локальная категория 1; local2 — локальная категория 2; local3 — локальная категория 3; local4 — локальная категория 4; local5 — локальная категория 5; local6 — локальная категория 6; local7 — локальная категория 7.

Режим: «Конфигурирование».

system syslog global facility <facility> level <level>

Описание:
Задает уровень сообщений указанной категории, которые записываются в основной журнал системы. Принимаются сообщения указанного уровня и более важные.

Синтаксис:

  • set system syslog global facility <facility> level <level>

  • delete system syslog global facility <facility> level <level>

  • show system syslog global facility <facility> level

Аргументы:

  • <facility> — категория (facility) сообщений. Возможные значения: all — все категории, кроме mark; auth — аутентификация и авторизация; authpriv — несистемная авторизация; cron — служба планирования заданий; daemon — системные службы; kern — ядро; lpr — подсистема печати; mail — почтовая подсистема; mark — метки времени; news — подсистема USENET; syslog — сообщения самой службы журналирования; user — прикладные процессы; uucp — подсистема UUCP; local0 — локальная категория 0; local1 — локальная категория 1; local2 — локальная категория 2; local3 — локальная категория 3; local4 — локальная категория 4; local5 — локальная категория 5; local6 — локальная категория 6; local7 — локальная категория 7.

  • <level> — уровень (level) сообщений. Возможные значения: emerg — аварийные сообщения; alert — срочные сообщения; crit — критические сообщения; err — сообщения об ошибках; warning — предупреждения; notice — сообщения, требующие внимания; info — информационные сообщения; debug — отладочные сообщения; all — все сообщения. Значение по умолчанию: err.

Режим: «Конфигурирование».

system syslog global marker interval <interval>

Описание:
Включает запись в журнал меток (mark-сообщений) и задает интервал между ними в секундах.

Синтаксис:

  • set system syslog global marker interval <interval>

  • delete system syslog global marker interval <interval>

  • show system syslog global marker interval

Аргументы:

  • <interval> — интервал между метками в секундах. Значение по умолчанию: 1200.

Режим: «Конфигурирование».

system syslog global preserve-fqdn

Описание:
Включает запись в сообщения полного имени узла (FQDN). Если заданы параметры system host-name и system domain-name, используется имя вида <host-name>.<domain-name>.

Синтаксис:

  • set system syslog global preserve-fqdn

  • delete system syslog global preserve-fqdn

  • show system syslog global preserve-fqdn

Режим: «Конфигурирование».

system syslog host <host>

Описание:
Задает удаленный сервер syslog, на который отправляются сообщения. Можно задать несколько серверов.

Синтаксис:

  • set system syslog host <host>

  • delete system syslog host <host>

  • show system syslog host

Аргументы:

  • <host> — адрес удаленного сервера syslog. Формат: IPv4-адрес (x.x.x.x), IPv6-адрес (h:h:h:h:h:h:h:h) или полное имя узла (FQDN).

Режим: «Конфигурирование».

system syslog host <host> facility <facility>

Описание:
Задает категорию сообщений, которые отправляются на удаленный сервер syslog.

Синтаксис:

  • set system syslog host <host> facility <facility>

  • delete system syslog host <host> facility <facility>

  • show system syslog host <host> facility

Аргументы:

  • <host> — адрес удаленного сервера syslog. Формат: IPv4-адрес (x.x.x.x), IPv6-адрес (h:h:h:h:h:h:h:h) или полное имя узла (FQDN).

  • <facility> — категория (facility) сообщений. Возможные значения: all — все категории, кроме mark; auth — аутентификация и авторизация; authpriv — несистемная авторизация; cron — служба планирования заданий; daemon — системные службы; kern — ядро; lpr — подсистема печати; mail — почтовая подсистема; mark — метки времени; news — подсистема USENET; syslog — сообщения самой службы журналирования; user — прикладные процессы; uucp — подсистема UUCP; local0 — локальная категория 0; local1 — локальная категория 1; local2 — локальная категория 2; local3 — локальная категория 3; local4 — локальная категория 4; local5 — локальная категория 5; local6 — локальная категория 6; local7 — локальная категория 7.

Режим: «Конфигурирование».

system syslog host <host> facility <facility> level <level>

Описание:
Задает уровень сообщений указанной категории, которые отправляются на удаленный сервер syslog. Принимаются сообщения указанного уровня и более важные.

Синтаксис:

  • set system syslog host <host> facility <facility> level <level>

  • delete system syslog host <host> facility <facility> level <level>

  • show system syslog host <host> facility <facility> level

Аргументы:

  • <host> — адрес удаленного сервера syslog. Формат: IPv4-адрес (x.x.x.x), IPv6-адрес (h:h:h:h:h:h:h:h) или полное имя узла (FQDN).

  • <facility> — категория (facility) сообщений. Возможные значения: all — все категории, кроме mark; auth — аутентификация и авторизация; authpriv — несистемная авторизация; cron — служба планирования заданий; daemon — системные службы; kern — ядро; lpr — подсистема печати; mail — почтовая подсистема; mark — метки времени; news — подсистема USENET; syslog — сообщения самой службы журналирования; user — прикладные процессы; uucp — подсистема UUCP; local0 — локальная категория 0; local1 — локальная категория 1; local2 — локальная категория 2; local3 — локальная категория 3; local4 — локальная категория 4; local5 — локальная категория 5; local6 — локальная категория 6; local7 — локальная категория 7.

  • <level> — уровень (level) сообщений. Возможные значения: emerg — аварийные сообщения; alert — срочные сообщения; crit — критические сообщения; err — сообщения об ошибках; warning — предупреждения; notice — сообщения, требующие внимания; info — информационные сообщения; debug — отладочные сообщения; all — все сообщения. Значение по умолчанию: err.

Режим: «Конфигурирование».

system syslog host <host> format include-timezone

Описание:
Включает в сообщения, которые отправляются на удаленный сервер, часовой пояс системы.

Синтаксис:

  • set system syslog host <host> format include-timezone

  • delete system syslog host <host> format include-timezone

  • show system syslog host <host> format include-timezone

Аргументы:

  • <host> — адрес удаленного сервера syslog. Формат: IPv4-адрес (x.x.x.x), IPv6-адрес (h:h:h:h:h:h:h:h) или полное имя узла (FQDN).

Режим: «Конфигурирование».

system syslog host <host> format octet-counted

Описание:
Включает передачу сообщений с указанием длины (octet-counted): такая передача позволяет отправлять любые символы внутри сообщения syslog. С протоколом UDP параметр использовать не следует: при этом выводится предупреждение.

Синтаксис:

  • set system syslog host <host> format octet-counted

  • delete system syslog host <host> format octet-counted

  • show system syslog host <host> format octet-counted

Аргументы:

  • <host> — адрес удаленного сервера syslog. Формат: IPv4-адрес (x.x.x.x), IPv6-адрес (h:h:h:h:h:h:h:h) или полное имя узла (FQDN).

Режим: «Конфигурирование».

system syslog host <host> port <port>

Описание:
Задает порт удаленного сервера syslog.

Синтаксис:

  • set system syslog host <host> port <port>

  • delete system syslog host <host> port <port>

  • show system syslog host <host> port

Аргументы:

  • <host> — адрес удаленного сервера syslog. Формат: IPv4-адрес (x.x.x.x), IPv6-адрес (h:h:h:h:h:h:h:h) или полное имя узла (FQDN).

  • <port> — номер порта сервера. Формат: целое число. Диапазон значений: от 1 до 65535. Значение по умолчанию: 514.

Режим: «Конфигурирование».

system syslog host <host> protocol <protocol>

Описание:
Задает протокол передачи сообщений на удаленный сервер syslog.

Синтаксис:

  • set system syslog host <host> protocol <protocol>

  • delete system syslog host <host> protocol <protocol>

  • show system syslog host <host> protocol

Аргументы:

  • <host> — адрес удаленного сервера syslog. Формат: IPv4-адрес (x.x.x.x), IPv6-адрес (h:h:h:h:h:h:h:h) или полное имя узла (FQDN).

  • <protocol> — протокол передачи. Возможные значения: udp — протокол UDP; tcp — протокол TCP. Значение по умолчанию: udp.

Режим: «Конфигурирование».

system syslog host <host> source-address <source-address>

Описание:
Задает IP-адрес источника, с которого сообщения отправляются на удаленный сервер. Адрес должен быть назначен интерфейсу маршрутизатора, а его семейство (IPv4 или IPv6) должно совпадать с семейством адреса сервера.

Синтаксис:

  • set system syslog host <host> source-address <source-address>

  • delete system syslog host <host> source-address <source-address>

  • show system syslog host <host> source-address

Аргументы:

  • <host> — адрес удаленного сервера syslog. Формат: IPv4-адрес (x.x.x.x), IPv6-адрес (h:h:h:h:h:h:h:h) или полное имя узла (FQDN).

  • <source-address> — адрес источника. Формат: IPv4-адрес (x.x.x.x) или IPv6-адрес (h:h:h:h:h:h:h:h).

Режим: «Конфигурирование».

system syslog user <user>

Описание:
Включает вывод сообщений на терминалы указанного пользователя. Сообщение выводится во всех сеансах, которые пользователь открыл в системе, в виде строки <источник>: <текст>.

Синтаксис:

  • set system syslog user <user>

  • delete system syslog user <user>

  • show system syslog user

Аргументы:

  • <user> — имя локального пользователя. Формат: строка.

Режим: «Конфигурирование».

system syslog user <user> facility <facility>

Описание:
Задает категорию сообщений, которые выводятся на терминал пользователя.

Синтаксис:

  • set system syslog user <user> facility <facility>

  • delete system syslog user <user> facility <facility>

  • show system syslog user <user> facility

Аргументы:

  • <user> — имя локального пользователя. Формат: строка.

  • <facility> — категория (facility) сообщений. Возможные значения: all — все категории, кроме mark; auth — аутентификация и авторизация; authpriv — несистемная авторизация; cron — служба планирования заданий; daemon — системные службы; kern — ядро; lpr — подсистема печати; mail — почтовая подсистема; mark — метки времени; news — подсистема USENET; syslog — сообщения самой службы журналирования; user — прикладные процессы; uucp — подсистема UUCP; local0 — локальная категория 0; local1 — локальная категория 1; local2 — локальная категория 2; local3 — локальная категория 3; local4 — локальная категория 4; local5 — локальная категория 5; local6 — локальная категория 6; local7 — локальная категория 7.

Режим: «Конфигурирование».

system syslog user <user> facility <facility> level <level>

Описание:
Задает уровень сообщений указанной категории, которые выводятся на терминал пользователя. Принимаются сообщения указанного уровня и более важные.

Синтаксис:

  • set system syslog user <user> facility <facility> level <level>

  • delete system syslog user <user> facility <facility> level <level>

  • show system syslog user <user> facility <facility> level

Аргументы:

  • <user> — имя локального пользователя. Формат: строка.

  • <facility> — категория (facility) сообщений. Возможные значения: all — все категории, кроме mark; auth — аутентификация и авторизация; authpriv — несистемная авторизация; cron — служба планирования заданий; daemon — системные службы; kern — ядро; lpr — подсистема печати; mail — почтовая подсистема; mark — метки времени; news — подсистема USENET; syslog — сообщения самой службы журналирования; user — прикладные процессы; uucp — подсистема UUCP; local0 — локальная категория 0; local1 — локальная категория 1; local2 — локальная категория 2; local3 — локальная категория 3; local4 — локальная категория 4; local5 — локальная категория 5; local6 — локальная категория 6; local7 — локальная категория 7.

  • <level> — уровень (level) сообщений. Возможные значения: emerg — аварийные сообщения; alert — срочные сообщения; crit — критические сообщения; err — сообщения об ошибках; warning — предупреждения; notice — сообщения, требующие внимания; info — информационные сообщения; debug — отладочные сообщения; all — все сообщения. Значение по умолчанию: err.

Режим: «Конфигурирование».

system syslog vrf <vrf>

Описание:
Задает экземпляр VRF, в котором работает служба журналирования. При изменении экземпляра VRF служба перезапускается.

Синтаксис:

  • set system syslog vrf <vrf>

  • delete system syslog vrf <vrf>

  • show system syslog vrf

Аргументы:

  • <vrf> — имя экземпляра VRF. Формат: строка.

Режим: «Конфигурирование».

system logs logrotate atop max-size <max-size>

Описание:
Задает размер файла журнала atop в мегабайтах, по достижении которого выполняется ротация.

Синтаксис:

  • set system logs logrotate atop max-size <max-size>

  • delete system logs logrotate atop max-size <max-size>

  • show system logs logrotate atop max-size

Аргументы:

  • <max-size> — размер файла в мегабайтах. Формат: целое число. Диапазон значений: от 1 до 1024. Значение по умолчанию: 10.

Режим: «Конфигурирование».

system logs logrotate atop rotate <rotate>

Описание:
Задает число ротаций журнала atop, после которого старые файлы удаляются.

Синтаксис:

  • set system logs logrotate atop rotate <rotate>

  • delete system logs logrotate atop rotate <rotate>

  • show system logs logrotate atop rotate

Аргументы:

  • <rotate> — число ротаций. Формат: целое число. Диапазон значений: от 1 до 100. Значение по умолчанию: 10.

Режим: «Конфигурирование».

system logs logrotate messages max-size <max-size>

Описание:
Задает размер файла основного журнала системы в мегабайтах, по достижении которого выполняется ротация.

Синтаксис:

  • set system logs logrotate messages max-size <max-size>

  • delete system logs logrotate messages max-size <max-size>

  • show system logs logrotate messages max-size

Аргументы:

  • <max-size> — размер файла в мегабайтах. Формат: целое число. Диапазон значений: от 1 до 1024. Значение по умолчанию: 1.

Режим: «Конфигурирование».

system logs logrotate messages rotate <rotate>

Описание:
Задает число ротаций основного журнала системы, после которого старые файлы удаляются.

Синтаксис:

  • set system logs logrotate messages rotate <rotate>

  • delete system logs logrotate messages rotate <rotate>

  • show system logs logrotate messages rotate

Аргументы:

  • <rotate> — число ротаций. Формат: целое число. Диапазон значений: от 1 до 100. Значение по умолчанию: 10.

Режим: «Конфигурирование».