Alpha.Community

В разделе Документация вы найдете все для уверенного старта и работы с Альфа платформой: от пошаговых инструкций по установке и конфигурированию до подробного описания работы компонентов и подсистем. Для поиска необходимых тем и вопросов в документации, воспользуйтесь поиском и фильтрацией результатов.

Приложение B: Формат сообщений Syslog

Модуль Syslog Сервер поддерживает следующие форматы сообщений Syslog :

  • RFC 5424;
  • RFC 3164.

RFC 5424

Сообщение Syslog в формате RFC 5424 имеет следующую структуру:

<PRI>VERSION TIMESTAMP HOSTNAME APPNAME PROCID MSGID [STRUCTURED-DATA] MSG

При передаче сообщений Syslog по протоколу TLS в начале сообщения указывается его размер:

LENGTH <PRI>VERSION TIMESTAMP HOSTNAME APPNAME PROCID MSGID [STRUCTURED-DATA] MSG

Согласно спецификации RFC 5424 в сообщении могут быть не указаны значения следующих полей:

  • HOSTNAME;
  • APPNAME;
  • PROCID;
  • MSGID.

Вместо отсутствующего значения в поле должен быть указан символ -.

RFC 3164

Сообщения Syslog в формате RFC 3164 передаются только по транспортному протоколу UDP.

Сообщение Syslog в формате RFC 3164 имеет следующую структуру:

<PRI> TIMESTAMP HOSTNAME APPNAME [PROCID]:MSG

Согласно спецификации RFC 3164 в сообщении могут быть не указаны значения любых полей. В этом случае значения соответствующих полей будут отсутствовать в структуре сообщения (допускается передача пустого сообщения, не содержащего ни одного символа):

  • если в сообщении не указано значение TIMESTAMP, то в качестве значения поля используется момент получения сообщения;
  • если в сообщении не указано значение PRI, то в качестве значения поля PRI используется значение 41 (Facility – 5, Severity – 1);
  • при отсутствии значений прочих полей, в качестве значения этих полей используется пустая строка.

Формату RFC 3164 соответствуют любые сообщения, которые могут быть получены: если при попытке разобрать отдельные поля в полученном сообщении произойдёт ошибка, то вся строка сообщения будет использоваться в качестве значения поля MSG.

Описание полей сообщений Syslog

Поле Описание
LENGTH Количество символов в сообщении. Указывается только в сообщениях, передаваемых по протоколу TLS
PRI

Приоритет. Содержит два значения: Facility (субъект, сформировавший сообщение) и Severity (уровень важности сообщения). Severity принимает значения от 0 до 7, Facility - от 0 до 23. Значение PRI вычисляется как PRI = Facility*8+Severity.

Facility

0 – Ядро операционной системы

1 – ПО пользователя

2 – Почтовая система

3 – Системные службы

4 – Сообщения безопасности/авторизации

5 – Собственные сообщения syslogd

6 – Подсистема печати

7 – Подсистема новостных групп

8 – Подсистема UUCP

9 – Службы времени

10 – Сообщения безопасности/авторизации

11 – Служба FTP

12 – Подсистема NTP

13 – Сообщения аудита

14 – Аварийные сообщения

15 – Службы времени 2

16-23 – локальное происхождение 0-7

Severity:

0 – Авария, система неработоспособна

1 – Тревога, система требует немедленного вмешательства

2 – Состояние системы критическое

3 – Сообщения об ошибках

4 – Предупреждения о возможных проблемах

5 – Сообщения о нормальных, но важных событиях

6 – Информационные сообщения

7 – Отладочные сообщения

VERSION Версия протокола
TIMESTAMP Метка времени сообщения
HOSTNAME IP-адрес или сетевое имя устройства, сгенерировавшего сообщение
APP-NAME Идентификатор устройства или приложения, сгенерировавшего сообщение
PROCID Позволяет регистрировать перерывы в потоке данных и обычно используется в качестве идентификатора процесса
MSGID Идентификатор типа сообщения
STRUCTURED-DATA Структурированные данные. В работе модуля Syslog Сервер не используются
MSG Текст сообщения

Поля сообщений Syslog используются следующим образом:

  • поля MSG и TIMESTAMP используются при формировании VQT значения, записываемого в сигнал;
  • поле HOSTNAME используется при поиске сигнала, предназначенного для записи сообщений от устройства, указанного в этом поле;
  • поля PRI, APP-NAME, PROCID, MSGID используются при поиске сигнала, имеющего соответствующие параметры фильтрации.