7 MQTT 插件
概览
本节列出了 MQTT Zabbix 代理 2 插件配置文件（mqtt.conf）支持的参数。
请注意：
- 默认值反映了进程默认值，而不是配置文件中的值；
- Zabbix 仅支持 UTF-8 编码的配置文件，不包含 BOM；
- 仅支持以 “#” 开头的注释在行的开始处。
参数
| 参数 | 必填 | 范围 | 默认值 | 描述 |
|---|---|---|---|---|
| Plugins.MQTT.Default.Password | 否 | 连接到 MQTT 的默认密码；如果项目键或命名会话中未指定值，则使用此密码。 自版本 6.0.19 起支持 |
||
| Plugins.MQTT.Default.TLSCAFile | 否 | 包含顶层 CA 证书的文件的完整路径名，用于 Zabbix 代理 2 与 MQTT 代理之间加密通信的对等证书验证；如果命名会话中未指定值，则使用。 自版本 6.0.19 起支持 |
||
| Plugins.MQTT.Default.TLSCertFile | 否 | 包含代理证书或证书链的文件的完整路径名，用于 Zabbix 代理 2 与 MQTT 代理之间的加密通信；如果命名会话中未指定值，则使用。 自版本 6.0.19 起支持 |
||
| Plugins.MQTT.Default.TLSKeyFile | 否 | 包含 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.<SessionName>.Password | 否 | 命名会话密码。 <SessionName> - 定义会话名称，用于项目键中。 自版本 6.0.19 起支持 |
||
| Plugins.MQTT.Sessions.<SessionName>.TLSCAFile | 否 | 包含顶层 CA 证书的文件的完整路径名，用于 Zabbix 代理 2 与 MQTT 代理之间的加密通信。 <SessionName> - 定义会话名称，用于项目键中。 自版本 6.0.19 起支持 |
||
| Plugins.MQTT.Sessions.<SessionName>.TLSCertFile | 否 | 包含代理证书或证书链的文件的完整路径名，用于 Zabbix 代理 2 与 MQTT 代理之间的加密通信。 <SessionName> - 定义会话名称，用于项目键中。 自版本 6.0.19 起支持 |
||
| Plugins.MQTT.Sessions.<SessionName>.TLSKeyFile | 否 | 包含 MQTT 私钥的文件的完整路径名，用于 Zabbix 代理 2 与 MQTT 代理之间的加密通信。 <SessionName> - 定义会话名称，用于项目键中。 自版本 6.0.19 起支持 |
||
| Plugins.MQTT.Sessions.<SessionName>.Topic | 否 | 命名会话的 MQTT 订阅主题。 <SessionName> - 定义会话名称，用于项目键中。 主题可能包含通配符 ("+","#") 示例： path/to/filepath/to/#path/+/topic自版本 6.0.19 起支持 |
||
| Plugins.MQTT.Sessions.<SessionName>.Url | 否 | 命名会话的连接字符串。 <SessionName> - 定义会话名称，用于项目键中。 不应包含查询参数。 必须符合 URL 格式。 支持的方案： tcp (默认), ws, tls；可以省略方案。可以省略端口 (默认=1883)。 示例： tcp://host:1883localhostws://host:8080自版本 6.0.19 起支持 |
||
| Plugins.MQTT.Sessions.<SessionName>.User | 否 | 命名会话用户名。 <SessionName> - 定义会话名称，用于项目键中。 自版本 6.0.19 起支持 |
||
| Plugins.MQTT.Timeout | 否 | 1-30 | 全局超时 | 请求执行超时（在关闭之前等待请求完成的时间）。 |
另请参阅：
- Zabbix 代理 2 通用配置参数的描述： Zabbix agent 2 (UNIX) / Zabbix agent 2 (Windows)
- 插件配置指南