Справка по переменным окружения

Ниже приведён список всех доступных переменных окружения Агента.

Поддержка перенаправления Syslog

SYSLOG_FORWARDING_ENABLED: включение перенаправления сообщений Syslog (true/false), значение по умолчанию: false; при включении необходимо указать адрес хотя бы одного сервера с индексом 0 (TCP или UDP) — без этого запуск контейнера прерывается
SYSLOG_FORWARDING_TCP_SERVERS_[N]_HOST: адрес TCP-сервера для отправки сообщений
SYSLOG_FORWARDING_TCP_SERVERS_[N]_PORT: порт TCP-сервера; для сервера с индексом 0 значение по умолчанию: 514, для остальных индексов указывается обязательно
SYSLOG_FORWARDING_UDP_SERVERS_[N]_HOST: адрес UDP-сервера для отправки сообщений
SYSLOG_FORWARDING_UDP_SERVERS_[N]_PORT: порт UDP-сервера; для сервера с индексом 0 значение по умолчанию: 514, для остальных индексов указывается обязательно

Где:

[N] — индекс сервера в списке, начиная с 0;
если список серверов пустой, пересылка по соответствующему протоколу не выполняется;
допускается указание нескольких серверов.

Пример конфигурации:

SYSLOG_FORWARDING_ENABLED=true
SYSLOG_FORWARDING_TCP_SERVERS_0_HOST=log1.example.com
SYSLOG_FORWARDING_TCP_SERVERS_0_PORT=514
SYSLOG_FORWARDING_TCP_SERVERS_1_HOST=log2.example.com
SYSLOG_FORWARDING_TCP_SERVERS_1_PORT=515
SYSLOG_FORWARDING_UDP_SERVERS_0_HOST=log3.example.com
SYSLOG_FORWARDING_UDP_SERVERS_0_PORT=514

Поддержка работы через HTTP-прокси

PROXY_ENABLED: включение прокси (true/false), значение по умолчанию: false
PROXY_HOST: адрес HTTP-прокси; обязателен, если PROXY_ENABLED установлен в true — без него запуск контейнера прерывается
PROXY_PORT: порт HTTP-прокси, значение по умолчанию: 3128
PROXY_USERNAME: имя пользователя для HTTP-прокси (если используется)
PROXY_PASSWORD: пароль для HTTP-прокси (если используется)
PROXY_EXCLUSION_HOST: список исключений для HTTP-прокси (опционально)

Управление очередью отправки уведомлений

AGENT_LAZY_QUEUE_ITEMS_LOADING_BATCH_SIZE: количество уведомлений, отправляемых за один цикл. По умолчанию 50
AGENT_LAZY_QUEUE_ITEMS_LOADING_INTERVAL_IN_SECONDS: интервал между циклами отправки уведомлений в секундах. По умолчанию 10
AGENT_LAZY_QUEUE_ITEMS_LOADING_TTL: время хранения неотправленных уведомлений в очереди перед их удалением. По умолчанию 3d

Фильтрация сообщений Syslog

SYSLOG_FILTER_SEVERITY_EXCLUDE: список уровней критичности Syslog, сообщения с которыми агент будет игнорировать. Указывается числами через запятую
SYSLOG_FILTER_EXCLUDES_APP_NAME: регулярное выражение для поиска в поле APP_NAME. Если в значении поля найдено совпадение с выражением, сообщение Syslog будет исключено из обработки
SYSLOG_FILTER_EXCLUDES_MESSAGE: регулярное выражение для поиска в поле MESSAGE. Если в значении поля найдено совпадение с выражением, сообщение Syslog будет исключено из обработки
SYSLOG_FILTER_EXCLUDES_HOST: регулярное выражение для поиска в поле HOST. Если в значении поля найдено совпадение с выражением, сообщение Syslog будет исключено из обработки

Пример конфигурации:

SYSLOG_FILTER_SEVERITY_EXCLUDE=6,7
SYSLOG_FILTER_EXCLUDES_APP_NAME=test
SYSLOG_FILTER_EXCLUDES_MESSAGE=^sshd$
SYSLOG_FILTER_EXCLUDES_HOST=^switch-01$