Documentation
Table of Contents
7. Плагин MQTT
Обзор
В этом разделе перечислены параметры, поддерживаемые в файле конфигурации плагина MQTT для Zabbix агента 2 (mqtt.conf).
Обратите внимание, что:
- Значения по умолчанию отражают значения по умолчанию для процесса, а не значения в поставляемых файлах конфигурации;
- Zabbix поддерживает файлы конфигурации только в кодировке UTF-8 без BOM;
- Комментарии, начинающиеся с «#», поддерживаются только в начале строки.
Параметры
| Параметр | Обязательный | Диапазон | По умолчанию | Описание |
|---|---|---|---|---|
| Plugins.MQTT.Default.Password | нет | Пароль по умолчанию для подключения к MQTT; используется, если значение не указано в ключе элемента данных или в именованной сессии. Поддерживается с версии 6.0.19 |
||
| Plugins.MQTT.Default.TLSCAFile | нет | Абсолютный путь к файлу, который содержит сертификаты удостоверяющих центров (certificate authority, CA) верхнего уровня для проверки сертификата узла для зашифрованных соединений между Zabbix агентом 2 и брокером MQTT; используется, если значение не указано в именованной сессии. Поддерживается с версии 6.0.19 |
||
| Plugins.MQTT.Default.TLSCertFile | нет | Абсолютный путь к файлу, который содержит сертификат агента или цепочку сертификатов для зашифрованных соединений между Zabbix агентом 2 и брокером MQTT; используется, если значение не указано в именованной сессии. Поддерживается с версии 6.0.19 |
||
| Plugins.MQTT.Default.TLSKeyFile | нет | Абсолютный путь к файлу, содержащему закрытый ключ (private key) MQTT для зашифрованных коммуникаций между Zabbix агентом 2 и брокером MQTT; используется, если значение не указано в именованной сессии. Поддерживается с версии 6.0.19 |
||
| Plugins.MQTT.Default.Topic | нет | Тема по умолчанию для подписки MQTT; используется, если значение не указано в ключе элемента данных или в именованной сессии. Тема может содержать подстановочные символы ("+","#") Примеры: path/to/filepath/to/#path/+/topicПоддерживается с версии 6.0.19 |
||
| Plugins.MQTT.Default.Url | нет | tcp://localhost:1883 | Строка подключения к брокеру MQTT по умолчанию; используется, если значение не указано в ключе элемента данных или в именованной сессии. Не должна включать параметры запроса. Должна соответствовать формату URL. Поддерживаются схемы: tcp (по умолчанию), ws, tls; схема может быть опущена.Порт может быть опущен (по умолчанию 1883). Примеры: tcp://host:1883localhostws://host:8080Поддерживается с версии 6.0.19 |
|
| Plugins.MQTT.Default.User | нет | Имя пользователя по умолчанию для подключения к MQTT; используется, если значение не указано в ключе элемента данных или в именованной сессии. Поддерживается с версии 6.0.19 |
||
| Plugins.MQTT.Sessions.<ИмяСессии>.Password | нет | Пароль именованной сессии. <ИмяСессии> - определяет имя сессии, используемое в ключах элементов данных. Поддерживается с версии 6.0.19 |
||
| Plugins.MQTT.Sessions.<ИмяСессии>.TLSCAFile | нет | Абсолютный путь к файлу, который содержит сертификаты удостоверяющих центров (certificate authority, CA) верхнего уровня для проверки сертификата узла, используется для зашифрованных соединений между Zabbix агентом 2 и брокером MQTT. <ИмяСессии> - определяет имя сессии, используемое в ключах элементов данных. Поддерживается с версии 6.0.19 |
||
| Plugins.MQTT.Sessions.<ИмяСессии>.TLSCertFile | нет | Абсолютный путь к файлу, который содержит сертификат агента или цепочку сертификатов, которые используются для зашифрованных соединений между Zabbix агентом 2 и брокером MQTT. <ИмяСессии> - определяет имя сессии, используемое в ключах элементов данных. Поддерживается с версии 6.0.19 |
||
| Plugins.MQTT.Sessions.<ИмяСессии>.TLSKeyFile | нет | Абсолютный путь к файлу, содержащему закрытый ключ (private key) MQTT, который используется для зашифрованных коммуникаций между Zabbix агентом 2 и брокером MQTT. <ИмяСессии> - определяет имя сессии, используемое в ключах элементов данных. Поддерживается с версии 6.0.19 |
||
| Plugins.MQTT.Sessions.<ИмяСессии>.Topic | нет | Тема именованной сессии для подписки MQTT. <ИмяСессии> - определяет имя сессии, используемое в ключах элементов данных. Тема может содержать подстановочные символы ("+","#") Примеры: path/to/filepath/to/#path/+/topicПоддерживается с версии 6.0.19 |
||
| Plugins.MQTT.Sessions.<ИмяСессии>.Url | нет | Строка подключения именованной сессии. <ИмяСессии> - определяет имя сессии, используемое в ключах элементов данных. Не должна включать параметры запроса. Должна соответствовать формату URL. Поддерживаются темы: tcp (по умолчанию), ws, tls; схема может быть опущена.Порт может быть опущен (по умолчанию 1883). Примеры: tcp://host:1883localhostws://host:8080Поддерживается с версии 6.0.19 |
||
| Plugins.MQTT.Sessions.<ИмяСессии>.User | нет | Имя пользователя именованной сессии. <ИмяСессии> - определяет имя сессии, используемое в ключах элементов данных. Поддерживается с версии 6.0.19 |
||
| Plugins.MQTT.Timeout | нет | 1-30 | глобальный тайм-аут | Время ожидания выполнения запроса (как долго запрос будет ожидать выполнения, прежде чем будет принудительно завершён). |
Смотрите также:
- Описание общих параметров конфигурации Zabbix агента 2: Zabbix агент 2 (UNIX) / Zabbix агент 2 (Windows)
- Инструкции по настройке плагинов