Конфигурационный файл агента

Для применения изменений необходимо перезапустить службу

  • saymon-agent (Linux/Mac OS);

  • SaymonAgent (Windows).

Далее описаны параметры конфигурационного файл агента <Папка_установки_агента>/conf/agent.properties.

Общие настройки

Параметр Описание

agent.discoveryEnabled

Включает автоматический поиск агентом сетевых устройств.

  • false - автоматический поиск выключен,

  • true - автоматический поиск включен.

По умолчанию - false - автоматический поиск выключен.

Задать родительский объект для обнаруженных устройств можно с помощью параметра discovery_parent_id в разделе Server конфигурационного файла сервера.

agent.id

Уникальный идентификатор объекта класса Saymon Agent в web-интерфейсе системы.

При указании agent.id=0 на сервере будет создан новый объект класса Saymon Agent. По умолчанию агенты создаются в корневом объекте, задать родительский объект для создаваемых агентов можно с помощью параметра agent_registration_parent_id в разделе Server конфигурационного файла сервера.

ID созданного объекта будет передан агенту. На хосте с агентом будет создан файл …​/saymon-agent/storage/registration.json, где будет записан данный идентификатор.

Чтобы заново инициировать процедуру получения ID, к примеру, если необходимо подключить агента к другому серверу, достаточно удалить файл registration.json и перезапустить агента.

agent.scriptsEnabled

Включает выполнение агентом скриптов с указанным текстом;

  • false - выполнение скриптов выключено,

  • true - выполнение скриптов включено.

По умолчанию - true - выполнение скриптов включено.

agent.snmpTrapEnabled

Позволяет использовать агента в качестве получателя трапов.

  • false - получение трапов агентом выключено,

  • true - получение трапов агентом включено.

По умолчанию - false - получение трапов агентом выключено.

О возможностях работы с SNMP-Trap читайте в разделах Настройка мониторинга и проверок и Журнал событий.

agent.snmpTrapListenPort

Порт для получения трапов.

По умолчанию - 1162.

agent.snmpTrapReceiverThreadPoolSize

Количество одновременных потоков для получения трапов.

По умолчанию - 4.

metrics.buffer.in-memory.capacity

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

Значение параметра - количество наборов данных от агента (результатов проверок), которые будут храниться в буфере до восстановления связи с сервером. После восстановления связи все данные из буфера пересылаются на сервер, и буфер очищается. При переполнении буфера очередные наборы данных заменяют наиболее старые из имеющихся в буфере.

По умолчанию буфер выключен.

Функционал поддерживается агентами версии 4.5.72 и выше.

server.host

Адрес сервера Kafka.

По умолчанию - 127.0.0.1.

server.port

Порт Kafka, по которому осуществляется подключение агентов к серверу.

По умолчанию - 9092.

Подключение к Kafka Cluster

При использовании Kafka Cluster необходимо также использовать дополнительные параметры подключения, начинающиеся на kafka.; все возможные параметры представлены в документации по Kafka.

Пример:

...
kafka.bootstrap.servers=192.168.1.11:9092,192.168.1.12:9092,192.168.1.13:9092
kafka.security.protocol=SASL_SSL
kafka.ssl.truststore.location=/opt/kafka/kafka.client.truststore.jks
kafka.ssl.truststore.password=saymon
kafka.sasl.mechanism=PLAIN
kafka.sasl.jaas.config=org.apache.kafka.common.security.plain.PlainLoginModule required username="user" password="password"
...
Параметр Описание

kafka.bootstrap.servers

Список пар хост:порт, использующихся для установки первоначального соединения с кластером Kafka.
При использовании Kafka Cluster поле server.host не должно быть пустым, там необходимо указать адрес одного из kafka.bootstrap.servers.

Авторизация и шифрование

Параметр Описание

kafka.sasl.jaas.config

Параметры контекста входа в систему для SASL-соединений в формате, используемом конфигурационными файлами JAAS.

kafka.sasl.mechanism

Механизм SASL, используемый для клиентских подключений.

kafka.security.protocol

Протокол, используемый для взаимодействия с брокерами.

Возможные значения:

  • PLAINTEXT,

  • SSL,

  • SASL_PLAINTEXT,

  • SASL_SSL.

kafka.ssl.truststore.location

Расположение файла truststore.

kafka.ssl.truststore.password

Пароль для файла truststore. Если пароль не задан, сконфигурированный файл также будет использоваться, но без проверки целостности.