[comment]: # ({3ae0a4ae-e0afbd96})
# 7. Плагин MQTT 

[comment]: # ({/3ae0a4ae-e0afbd96})

[comment]: # ({b12cab0f-88abc321})
#### Обзор

В этом разделе перечислены параметры, поддерживаемые в файле конфигурации
плагина MQTT для Zabbix агента 2 (mqtt.conf).

Обратите внимание, что:

-  Значения по умолчанию отражают значения по умолчанию для процесса, а не значения в поставляемых файлах конфигурации;
-  Zabbix поддерживает файлы конфигурации только в кодировке UTF-8 без
 [BOM](https://ru.wikipedia.org/wiki/%D0%9C%D0%B0%D1%80%D0%BA%D0%B5%D1%80_%D0%BF%D0%BE%D1%81%D0%BB%D0%B5%D0%B4%D0%BE%D0%B2%D0%B0%D1%82%D0%B5%D0%BB%D1%8C%D0%BD%D0%BE%D1%81%D1%82%D0%B8_%D0%B1%D0%B0%D0%B9%D1%82%D0%BE%D0%B2);
-  Комментарии, начинающиеся с «\#», поддерживаются только в начале строки.

[comment]: # ({/b12cab0f-88abc321})

[comment]: # ({7ffda252-97d87248})
#### Параметры

|Параметр|Обязательный|Диапазон|По умолчанию|Описание|
|--|--|--|--|----------|
|Plugins.MQTT.Default.Password|нет| | |Пароль по умолчанию для подключения к MQTT; используется, если значение не указано в ключе элемента данных или в именованной сессии.<br>Поддерживается с версии 6.0.19|
|Plugins.MQTT.Default.TLSCAFile|нет| | |Абсолютный путь к файлу, который содержит сертификаты удостоверяющих центров (certificate authority, CA) верхнего уровня для проверки сертификата узла для зашифрованных соединений между Zabbix агентом 2 и брокером MQTT; используется, если значение не указано в именованной сессии.<br>Поддерживается с версии 6.0.19|
|Plugins.MQTT.Default.TLSCertFile|нет| | |Абсолютный путь к файлу, который содержит сертификат агента или цепочку сертификатов для зашифрованных соединений между Zabbix агентом 2 и брокером MQTT; используется, если значение не указано в именованной сессии.<br>Поддерживается с версии 6.0.19|
|Plugins.MQTT.Default.TLSKeyFile|нет| | |Абсолютный путь к файлу, содержащему закрытый ключ (private key) MQTT для зашифрованных коммуникаций между Zabbix агентом 2 и брокером MQTT; используется, если значение не указано в именованной сессии.<br>Поддерживается с версии 6.0.19|
|Plugins.MQTT.Default.Topic|нет| | |Тема по умолчанию для подписки MQTT; используется, если значение не указано в ключе элемента данных или в именованной сессии.<br><br>Тема может содержать подстановочные символы ("+","#")<br>Примеры: `path/to/file`<br>`path/to/#`<br>`path/+/topic`<br>Поддерживается с версии 6.0.19|
|Plugins.MQTT.Default.Url|нет| |tcp://localhost:1883|Строка подключения к брокеру MQTT по умолчанию; используется, если значение не указано в ключе элемента данных или в именованной сессии.<br><br>Не должна включать параметры запроса.<br>Должна соответствовать формату URL.<br>Поддерживаются схемы: `tcp` (по умолчанию), `ws`, `tls`; схема может быть опущена.<br>Порт может быть опущен (по умолчанию 1883).<br>Примеры: `tcp://host:1883`<br>`localhost`<br>`ws://host:8080`<br>Поддерживается с версии 6.0.19|
|Plugins.MQTT.Default.User|нет| | |Имя пользователя по умолчанию для подключения к MQTT; используется, если значение не указано в ключе элемента данных или в именованной сессии.<br>Поддерживается с версии 6.0.19|
|Plugins.MQTT.Sessions.<ИмяСессии>.Password|нет| | |Пароль именованной сессии.<br>**<ИмяСессии>** — определяет имя сессии, используемое в ключах элементов данных.<br>Поддерживается с версии 6.0.19|
|Plugins.MQTT.Sessions.<ИмяСессии>.TLSCAFile|нет| | |Абсолютный путь к файлу, который содержит сертификаты удостоверяющих центров (certificate authority, CA) верхнего уровня для проверки сертификата узла, используется для зашифрованных соединений между Zabbix агентом 2 и брокером MQTT.<br>**<ИмяСессии>** — определяет имя сессии, используемое в ключах элементов данных.<br>Поддерживается с версии 6.0.19|
|Plugins.MQTT.Sessions.<ИмяСессии>.TLSCertFile|нет| | |Абсолютный путь к файлу, который содержит сертификат агента или цепочку сертификатов, которые используются для зашифрованных соединений между Zabbix агентом 2 и брокером MQTT.<br>**<ИмяСессии>** — определяет имя сессии, используемое в ключах элементов данных.<br>Поддерживается с версии 6.0.19|
|Plugins.MQTT.Sessions.<ИмяСессии>.TLSKeyFile|нет| | |Абсолютный путь к файлу, содержащему закрытый ключ (private key) MQTT, который используется для зашифрованных коммуникаций между Zabbix агентом 2 и брокером MQTT.<br>**<ИмяСессии>** — определяет имя сессии, используемое в ключах элементов данных.<br>Поддерживается с версии 6.0.19|
|Plugins.MQTT.Sessions.<ИмяСессии>.Topic|нет| | |Тема именованной сессии для подписки MQTT.<br>**<ИмяСессии>** — определяет имя сессии, используемое в ключах элементов данных.<br><br>Тема может содержать подстановочные символы ("+","#")<br>Примеры: `path/to/file`<br>`path/to/#`<br>`path/+/topic`<br>Поддерживается с версии 6.0.19|
|Plugins.MQTT.Sessions.<ИмяСессии>.Url|нет| | |Строка подключения именованной сессии.<br>**<ИмяСессии>** — определяет имя сессии, используемое в ключах элементов данных.<br><br>Не должна включать параметры запроса.<br>Должна соответствовать формату URL.<br>Поддерживаются темы: `tcp` (по умолчанию), `ws`, `tls`; схема может быть опущена.<br>Порт может быть опущен (по умолчанию 1883).<br>Примеры: `tcp://host:1883`<br>`localhost`<br>`ws://host:8080`<br>Поддерживается с версии 6.0.19|
|Plugins.MQTT.Sessions.<ИмяСессии>.User|нет| | |Имя пользователя именованной сессии.<br>**<ИмяСессии>** — определяет имя сессии, используемое в ключах элементов данных.<br>Поддерживается с версии 6.0.19|
|Plugins.MQTT.Timeout|нет|1-30|глобальный тайм-аут|Тайм-аут выполнения запроса (продолжительность в секундах ожидания завершения запроса, прежде чем он будет завершён принудительно).|

Смотрите также:

-   Описание общих параметров конфигурации Zabbix агента 2:
    [Zabbix агент 2 (UNIX)](/manual/appendix/config/zabbix_agent2) /
    [Zabbix агент 2
    (Windows)](/manual/appendix/config/zabbix_agent2_win)
-   Инструкции по настройке [плагинов](/manual/config/items/plugins)

[comment]: # ({/7ffda252-97d87248})
