Плагин MQTT

Обзор

Параметры конфигурации позволяют настраивать поведение плагина MQTT.

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

Все параметры являются необязательными, если явно не указано, что параметр обязателен.

Эта страница имеет следующую структуру:

  • Обзор параметров (чтобы увидеть полные сведения о параметре, нажмите на его имя)
  • Сведения о параметрах
Параметр Описание
Plugins.MQTT.Default.Password Укажите пароль по умолчанию для подключения к MQTT.
Plugins.MQTT.Default.TLSCAFile Укажите полный путь к файлу, содержащему сертификаты корневого CA(ов) для проверки сертификата узла.
Plugins.MQTT.Default.TLSCertFile Укажите полный путь к файлу, содержащему сертификат агента или цепочку сертификатов.
Plugins.MQTT.Default.TLSKeyFile Укажите полный путь к файлу, содержащему закрытый ключ MQTT.
Plugins.MQTT.Default.Topic Укажите тему по умолчанию для подписки MQTT.
Plugins.MQTT.Default.Url Укажите строку подключения к брокеру MQTT по умолчанию.
Plugins.MQTT.Default.User Укажите имя пользователя по умолчанию для подключения к MQTT.
Plugins.MQTT.Sessions.<SessionName>.Password Укажите пароль именованной сессии для подключения к MQTT.
Plugins.MQTT.Sessions.<SessionName>.TLSCAFile Укажите полный путь к файлу, содержащему сертификаты корневого CA(ов) для проверки сертификата узла для именованной сессии.
Plugins.MQTT.Sessions.<SessionName>.TLSCertFile Укажите полный путь к файлу, содержащему сертификат агента или цепочку сертификатов для именованной сессии.
Plugins.MQTT.Sessions.<SessionName>.TLSKeyFile Укажите полный путь к файлу, содержащему закрытый ключ MQTT для именованной сессии.
Plugins.MQTT.Sessions.<SessionName>.Topic Укажите тему именованной сессии для подписки MQTT.
Plugins.MQTT.Sessions.<SessionName>.Url Укажите строку подключения к брокеру MQTT для именованной сессии.
Plugins.MQTT.Sessions.<SessionName>.User Укажите имя пользователя именованной сессии для подключения к MQTT.

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

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

Сведения о параметре

Plugins.MQTT.Default.Password

Укажите пароль по умолчанию для подключения к MQTT.
Используется, если значение не указано в ключе элемента данных или именованной сессии.

Plugins.MQTT.Default.TLSCAFile

Укажите полный путь к файлу, содержащему сертификаты корневого CA для проверки сертификата узла при зашифрованном обмене данными между агентом Zabbix 2 и MQTT-брокером.
Используется, если в именованной сессии значение не указано.

Plugins.MQTT.Default.TLSCertFile

Укажите полный путь к файлу, содержащему сертификат агента или цепочку сертификатов для зашифрованной связи между агентом Zabbix 2 и MQTT broker.
Используется, если в именованной сессии не указано значение.

Plugins.MQTT.Default.TLSKeyFile

Укажите полный путь к файлу, содержащему закрытый ключ MQTT для зашифрованной связи между агентом Zabbix 2 и MQTT-брокером.
Используется, если в именованной сессии не указано значение.

Plugins.MQTT.Default.Topic

Укажите тему по умолчанию для подписки MQTT.
Используется, если значение не указано в ключе элемента данных или именованной сессии.
Тема может содержать подстановочные знаки ("+","#").

Примеры:

path/to/file
path/to/#
path/+/topic
Plugins.MQTT.Default.Url

Укажите строку подключения по умолчанию для MQTT broker.
Используется, если в ключе элемента данных или именованной сессии не указано значение.
Не должно включать параметры запроса.
Должно соответствовать формату URL.
Поддерживаемые схемы: tcp (по умолчанию), ws, tls
Схему можно опустить.
Порт можно опустить (по умолчанию=1883)

По умолчанию: tcp://localhost:1883

Примеры:

tcp://host:1883
localhost
ws://host:8080
Plugins.MQTT.Default.User

Укажите имя пользователя по умолчанию для подключения к MQTT.
Используется, если значение не указано в ключе элемента данных или именованной сессии.

Plugins.MQTT.Sessions.<SessionName>.Password

Укажите пароль для именованной сессии для подключения к MQTT.
<SessionName> - задайте имя сессии для использования в ключах элементов данных.

Plugins.MQTT.Sessions.<SessionName>.TLSCAFile

Укажите полное имя пути к файлу, содержащему сертификаты корневого CA(ов) для проверки сертификата узла для указанной сессии, используемой для зашифрованного обмена данными между агентом Zabbix 2 и MQTT broker.
<SessionName> - задает имя сессии для использования в ключах элементов данных.

Plugins.MQTT.Sessions.<SessionName>.TLSCertFile

Укажите полное имя пути к файлу, содержащему сертификат агента или цепочку сертификатов для именованной сессии, используемой для зашифрованной связи между Zabbix агент 2 и MQTT broker.
<SessionName> - задает имя сессии для использования в ключах элементов данных.

Plugins.MQTT.Sessions.<SessionName>.TLSKeyFile

Укажите полное имя пути к файлу, содержащему закрытый ключ MQTT для именованной сессии, используемый для зашифрованной связи между агентом Zabbix 2 и брокером MQTT.
<SessionName> - задайте имя сессии для использования в ключах элементов данных.

Plugins.MQTT.Sessions.<SessionName>.Topic

Укажите тему именованной сессии для подписки MQTT.
<SessionName> - задает имя сессии для использования в ключах элементов данных.
Тема может содержать подстановочные знаки ("+","#").

Примеры:

path/to/file
path/to/#
path/+/topic
Plugins.MQTT.Sessions.<SessionName>.Url

Укажите строку подключения к MQTT-брокеру для именованной сессии.
<SessionName> - задайте имя сессии для использования в ключах элементов данных.
Не должно включать параметры запроса.
Должно соответствовать формату URL.
Поддерживаемые схемы: tcp (по умолчанию), ws, tls
Схему можно не указывать.
Порт можно не указывать (по умолчанию=1883)

По умолчанию: tcp://localhost:1883

Примеры:

tcp://host:1883
localhost
ws://host:8080
Plugins.MQTT.Sessions.<SessionName>.User

Укажите имя пользователя для именованной сессии, используемой для подключения к MQTT.
<SessionName> - задайте имя сессии для использования в ключах элементов данных.

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

См. также