[comment]: # ({3ae0a4ae-e0afbd96})
# 7 MQTT 插件

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

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

本节列出MQTT Zabbix agent 2插件配置文件file (mqtt.conf)支持的参数.

请注意:

-   默认值反映进程默认设置，而非随附配置文件中的值;
-   Zabbix仅支持UTF-8编码的配置文件，不含[BOM](https://en.wikipedia.org/wiki/Byte_order_mark);
-   以"\#"开头的注释仅支持在行首使用.

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

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

| 参数 | 必选 | 范围 | 默认值 | 描述 |
|--|--|--|--|----------|
| Plugins.MQTT.Default.Password | no |       |         | 连接MQTT的默认密码，当监控项键或命名会话中未指定值时使用。<br>自version 6.0.19版本起支持 |
| Plugins.MQTT.Default.TLSCAFile | no |       |         | 包含Top级CA证书的file完整路径，用于Zabbix agent 2与MQTT代理之间加密通信的对等证书验证；当命名会话中未指定值时使用。<br>自version 6.0.19版本起支持 |
| Plugins.MQTT.Default.TLSCertFile | no |       |         | 包含agent证书或证书链的file完整路径，用于Zabbix agent 2与MQTT代理之间的加密通信；当命名会话中未指定值时使用。<br>自version 6.0.19版本起支持 |
| Plugins.MQTT.Default.TLSKeyFile | no |       |         | 包含MQTT私钥的file完整路径，用于Zabbix agent 2与MQTT代理之间的加密通信；当命名会话中未指定值时使用。<br>自version 6.0.19版本起支持 |
| Plugins.MQTT.Default.Topic | no |       |         | MQTT订阅的默认主题，当监控项键或命名会话中未指定值时使用。<br><br>主题可包含通配符("+","#")<br>示例: `path/to/file`<br>`path/to/#`<br>`path/+/topic`<br>自version 6.0.19版本起支持 |
| Plugins.MQTT.Default.Url | no |       | tcp://localhost:1883 | 默认MQTT代理连接string，当监控项键或命名会话中未指定值时使用。<br><br>不应包含query参数。<br>必须符合URL格式。<br>支持的协议: `tcp` (默认), `ws`, `tls`; 协议可省略。<br>端口可省略(默认=1883)。<br>示例: `tcp://host:1883`<br>`localhost`<br>`ws://host:8080`<br>自version 6.0.19版本起支持 |
| Plugins.MQTT.Default.User | no |       |         | 连接MQTT的默认用户名，当监控项键或命名会话中未指定值时使用。<br>自version 6.0.19版本起支持 |
| Plugins.MQTT.Sessions.<SessionName>.Password | no |       |         | 命名会话密码。<br>**<SessionName>** - 定义用于监控项键的会话名称。<br>自version 6.0.19版本起支持 |
| Plugins.MQTT.Sessions.<SessionName>.TLSCAFile | no |       |         | 包含Top级CA证书的file完整路径，用于Zabbix agent 2与MQTT代理之间加密通信的对等证书验证。<br>**<SessionName>** - 定义用于监控项键的会话名称。<br>自version 6.0.19版本起支持 |
| Plugins.MQTT.Sessions.<SessionName>.TLSCertFile | no |       |         | 包含agent证书或证书链的file完整路径，用于Zabbix agent 2与MQTT代理之间的加密通信。<br>**<SessionName>** - 定义用于监控项键的会话名称。<br>自version 6.0.19版本起支持 |
| Plugins.MQTT.Sessions.<SessionName>.TLSKeyFile | no |       |         | 包含MQTT私钥的file完整路径，用于Zabbix agent 2与MQTT代理之间的加密通信。<br>**<SessionName>** - 定义用于监控项键的会话名称。<br>自version 6.0.19版本起支持 |
| Plugins.MQTT.Sessions.<SessionName>.Topic | no |       |         | 命名会话的MQTT订阅主题。<br>**<SessionName>** - 定义用于监控项键的会话名称。<br><br>主题可包含通配符("+","#")<br>示例: `path/to/file`<br>`path/to/#`<br>`path/+/topic`<br>自version 6.0.19版本起支持 |
| Plugins.MQTT.Sessions.<SessionName>.Url | no |       |         | 命名会话的连接string。<br>**<SessionName>** - 定义用于监控项键的会话名称。<br><br>不应包含query参数。<br>必须符合URL格式。<br>支持的协议: `tcp` (默认), `ws`, `tls`; 协议可省略。<br>端口可省略(默认=1883)。<br>示例: `tcp://host:1883`<br>`localhost`<br>`ws://host:8080`<br>自version 6.0.19版本起支持 |
| Plugins.MQTT.Sessions.<SessionName>.User | no |       |         | 命名会话用户名。<br>**<SessionName>** - 定义用于监控项键的会话名称。<br>自version 6.0.19版本起支持 |
| Plugins.MQTT.Timeout | no | 1-30 | 全局超时 | 请求执行超时时间(等待请求完成的持续时间，单位为秒，超时后关闭)。 |

另请参阅:

-   Zabbix agent 2通用配置参数说明:
    [Zabbix agent 2 (UNIX)](/manual/appendix/config/zabbix_agent2) /
    [Zabbix agent 2
    (Windows)](/manual/appendix/config/zabbix_agent2_win)
-   [plugins](/manual/config/items/plugins)配置说明

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