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

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

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

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

注意事项:

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

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

[comment]: # ({4128bc53-97d87248})
#### 参数

| 参数 | 必填 | 范围 | 默认值 | 描述 |
|--|--|--|--|----------|
| Plugins.MQTT.Default.Password | no |       |         | 连接MQTT的默认密码；当监控项键值或命名会话中未指定值时使用。 |
| Plugins.MQTT.Default.TLSCAFile | no |       |         | 包含file的完整路径名，该文件存放用于Zabbix agent 2与MQTT代理间加密通信的Top级CA证书，用于对端证书验证；当命名会话中未指定值时使用。 |
| Plugins.MQTT.Default.TLSCertFile | no |       |         | 包含file的完整路径名，该文件存放用于Zabbix agent 2与MQTT代理间加密通信的agent证书或证书链；当命名会话中未指定值时使用。 |
| Plugins.MQTT.Default.TLSKeyFile | no |       |         | 包含file的完整路径名，该文件存放用于Zabbix agent 2与MQTT代理间加密通信的MQTT私钥；当命名会话中未指定值时使用。 |
| Plugins.MQTT.Default.Topic | no |       |         | MQTT订阅的默认主题；当监控项键值或命名会话中未指定值时使用。<br><br>主题可包含通配符("+","#")<br>示例：`path/to/file`<br>`path/to/#`<br>`path/+/topic` |
| 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` |
| Plugins.MQTT.Default.User | no |       |         | 连接MQTT的默认用户名；当监控项键值或命名会话中未指定值时使用。 |
| Plugins.MQTT.Sessions.<SessionName>.Password | no |       |         | 命名会话密码。<br>**<SessionName>** - 定义用于监控项键值的会话名称。 |
| Plugins.MQTT.Sessions.<SessionName>.TLSCAFile | no |       |         | 包含file的完整路径名，该文件存放用于Zabbix agent 2与MQTT代理间加密通信的Top级CA证书，用于对端证书验证。<br>**<SessionName>** - 定义用于监控项键值的会话名称。 |
| Plugins.MQTT.Sessions.<SessionName>.TLSCertFile | no |       |         | 包含file的完整路径名，该文件存放用于Zabbix agent 2与MQTT代理间加密通信的agent证书或证书链。<br>**<SessionName>** - 定义用于监控项键值的会话名称。 |
| Plugins.MQTT.Sessions.<SessionName>.TLSKeyFile | no |       |         | 包含file的完整路径名，该文件存放用于Zabbix agent 2与MQTT代理间加密通信的MQTT私钥。<br>**<SessionName>** - 定义用于监控项键值的会话名称。 |
| Plugins.MQTT.Sessions.<SessionName>.Topic | no |       |         | 命名会话的MQTT订阅主题。<br>**<SessionName>** - 定义用于监控项键值的会话名称。<br><br>主题可包含通配符("+","#")<br>示例：`path/to/file`<br>`path/to/#`<br>`path/+/topic` |
| 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` |
| Plugins.MQTT.Sessions.<SessionName>.User | no |       |         | 命名会话用户名。<br>**<SessionName>** - 定义用于监控项键值的会话名称。 |

如需设置请求执行超时（在终止请求前等待其完成的时长），
请使用[配置](/manual/config/items/item#配置)格式。

另请参阅：

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

[comment]: # ({/4128bc53-97d87248})