7 Плагин MQTT

Обзор

Файл конфигурации агента 2 Zabbix используется для настройки плагинов. Для работы плагина MQTT поддерживаются следующие параметры конфигурации агента 2 Zabbix.

Рекомендуется указывать их в отдельном файле конфигурации (например, mqtt.conf), а затем использовать директиву Include для добавления этого файла в конфигурацию агента 2 Zabbix.

Обратите внимание:

  • Значения по умолчанию отражают значения по умолчанию процесса, а не значения в поставляемых файлах конфигурации;
  • Значения поддерживают переменные среды;
  • Zabbix поддерживает файлы конфигурации только в кодировке UTF-8 без BOM;
  • Комментарии, начинающиеся с "#", поддерживаются только в начале строки.

Параметры

Parameter Mandatory Range Default Description
Plugins.MQTT.Default.Password no Пароль по умолчанию для подключения к MQTT; используется, если в ключе элемента данных или именованной сессии не указано значение.
Plugins.MQTT.Default.TLSCAFile no Полный путь к файлу, содержащему сертификаты корневого CA(ов) для проверки сертификата узла при зашифрованных соединениях между агентом Zabbix agent 2 и MQTT broker; используется, если в именованной сессии не указано значение.
Plugins.MQTT.Default.TLSCertFile no Полный путь к файлу, содержащему сертификат агента или цепочку сертификатов для зашифрованных соединений между агентом Zabbix agent 2 и MQTT broker; используется, если в именованной сессии не указано значение.
Plugins.MQTT.Default.TLSKeyFile no Полный путь к файлу, содержащему закрытый ключ MQTT для зашифрованных соединений между агентом Zabbix agent 2 и MQTT broker; используется, если в именованной сессии не указано значение.
Plugins.MQTT.Default.Topic no Тема MQTT по умолчанию для подписки; используется, если в ключе элемента данных или именованной сессии не указано значение.

Тема может содержать подстановочные знаки ("+","#")
Примеры: path/to/file
path/to/#
path/+/topic
Plugins.MQTT.Default.Url no tcp://localhost:1883 Строка подключения к MQTT broker по умолчанию; используется, если в ключе элемента данных или именованной сессии не указано значение.

Не должна включать параметры запроса.
Должна соответствовать формату URL.
Поддерживаемые схемы: tcp (по умолчанию), ws, tls; схему можно опустить.
Порт можно опустить (по умолчанию=1883).
Примеры: tcp://host:1883
localhost
ws://host:8080
Plugins.MQTT.Default.User no Имя пользователя по умолчанию для подключения к MQTT; используется, если в ключе элемента данных или именованной сессии не указано значение.
Plugins.MQTT.Sessions.<SessionName>.Password no Пароль именованной сессии.
<SessionName> - задает имя сессии для использования в ключах элементов данных.
Plugins.MQTT.Sessions.<SessionName>.TLSCAFile no Полный путь к файлу, содержащему сертификаты корневого CA(ов) для проверки сертификата узла, используется для зашифрованных соединений между агентом Zabbix agent 2 и MQTT broker.
<SessionName> - задает имя сессии для использования в ключах элементов данных.
Plugins.MQTT.Sessions.<SessionName>.TLSCertFile no Полный путь к файлу, содержащему сертификат агента или цепочку сертификатов, используется для зашифрованных соединений между агентом Zabbix agent 2 и MQTT broker.
<SessionName> - задает имя сессии для использования в ключах элементов данных.
Plugins.MQTT.Sessions.<SessionName>.TLSKeyFile no Полный путь к файлу, содержащему закрытый ключ MQTT, используемый для зашифрованных соединений между агентом Zabbix agent 2 и MQTT broker.
<SessionName> - задает имя сессии для использования в ключах элементов данных.
Plugins.MQTT.Sessions.<SessionName>.Topic no Тема именованной сессии для подписки MQTT.
<SessionName> - задает имя сессии для использования в ключах элементов данных.

Тема может содержать подстановочные знаки ("+","#")
Примеры: path/to/file
path/to/#
path/+/topic
Plugins.MQTT.Sessions.<SessionName>.Url no Строка подключения именованной сессии.
<SessionName> - задает имя сессии для использования в ключах элементов данных.

Не должна включать параметры запроса.
Должна соответствовать формату URL.
Поддерживаемые схемы: tcp (по умолчанию), ws, tls; схему можно опустить.
Порт можно опустить (по умолчанию=1883).
Примеры: tcp://host:1883
localhost
ws://host:8080
Plugins.MQTT.Sessions.<SessionName>.User no Имя пользователя именованной сессии.
<SessionName> - задает имя сессии для использования в ключах элементов данных.

Если требуется задать тайм-аут выполнения запроса (сколько ждать завершения запроса перед его остановкой), используйте форму настройки элемента данных.

См. также: