Понимание шаблонов rsyslog

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

Содержание

Шаблоны rsyslog

Ниже приведен синтаксис для создания шаблона:

$template TEMPLATE_NAME, "text %PROPERTY% text", [OPTION]

1	$template TEMPLATE_NAME, "text %PROPERTY% text", [OPTION]

Поля описываются следующим образом:

Поле	Назначение
$template	Директива, определяющая шаблон
TEMPLATE_NAME	Имя шаблона
“text”	Собственно текст шаблона, окруженный кавычками
%PROPERTY%	Конкретное содержание сообщения, окруженное знаками процента
OPTION	Определяет параметры, изменяющие функциональность шаблона

Шаблоны можно использовать для создания динамических имен файлов. Укажите свойство как часть пути к файлу, чтобы создать новый файл для каждого уникального свойства. Например, используйте свойство timegenerated для создания уникального имени файла для каждого сообщения rsyslog:

$template DynamicFile, "/var/log/%timegenerated%-test.log"

1	$template DynamicFile, "/var/log/%timegenerated%-test.log"

Укажите имя шаблона в правиле для модификации вывода rsyslog. Динамические файлы представлены шаблоном и префиксом вопросительного знака (?). Пример:

*.* ?DynamicFile

1	. ?DynamicFile

Свойства

Вы можете использовать свойства внутри шаблона для ссылки на определенное содержимое сообщения rsyslog. Для определения свойства внутри шаблона используйте следующий синтаксис:

%PROPERTY_NAME[:FROM_CHAR:TO_CHAR:OPTION]%

1	%PROPERTY_NAME[:FROM_CHAR:TO_CHAR:OPTION]%

Поля описываются следующим образом:

Поле	Назначение
PROPERTY_NAME	Имя свойства
FROM_CHAR и TO_CHAR	Диапазон символов, на которые действует указанное свойство
OPTION	Параметры свойства

Список доступных свойств и их описание можно найти на сайте http://www.rsyslog.com/doc/property_replacer.html.

1. Следующее свойство представляет весь текст сообщения rsyslog:

%msg%

%msg%

2. Следующий пример представляет первые два символа текста сообщения:

%msg:1:2%

%msg:1:2%

3. Следующее свойство представляет имя хоста в сообщении rsyslog:

%hostname%

1	%hostname%

4. Следующее свойство представляет объект из сообщения в текстовом виде:

%syslogfacility-text%

1	%syslogfacility-text%

Шаблон: Пример

Следующий пример определяет шаблон с именем class, который форматирует сообщение rsyslog для вывода метки времени, объекта в текстовом виде, приоритета в текстовом виде, имени хоста, текста сообщения и заканчивается новой строкой:

$template class, "Time: %timestamp%, Facility: %syslogfacilitytext%, Priority: %syslogpriority-text%, Hostname: %hostname%, Message: %msg%\n"

1	$template class, "Time: %timestamp%, Facility: %syslogfacilitytext%, Priority: %syslogpriority-text%, Hostname: %hostname%, Message: %msg%\n"

Чтобы использовать шаблон для сообщений /var/log/logfile, включите имя шаблона следующим образом:

*.* /var/log/logfile;class

1	. /var/log/logfile;class