7 MQTT 插件
概述
本节列出MQTT Zabbix agent 2插件配置文件(mqtt.conf)支持的参数。
注意事项：
- 默认值反映进程默认设置，而非随附配置文件中的值；
- Zabbix仅支持UTF-8编码的配置文件，且不包含BOM；
- 以"#"开头的注释仅支持在行首使用。
参数
| 参数 | 必选 | 取值范围 | 默认值 | 描述 |
|---|---|---|---|---|
| Plugins.MQTT.Default.Password | no | 连接MQTT的默认密码；当监控项键值或命名会话中未指定值时使用。 自版本 6.0.19 起支持 |
||
| Plugins.MQTT.Default.TLSCAFile | no | 包含Top级CA证书的文件完整路径，用于Zabbix agent 2与MQTT代理间加密通信的证书验证；当命名会话中未指定值时使用。 自版本 6.0.19 起支持 |
||
| Plugins.MQTT.Default.TLSCertFile | no | 包含agent证书或证书链的文件完整路径，用于Zabbix agent 2与MQTT代理间加密通信；当命名会话中未指定值时使用。 自版本 6.0.19 起支持 |
||
| Plugins.MQTT.Default.TLSKeyFile | no | 包含MQTT私钥的文件完整路径，用于Zabbix agent 2与MQTT代理间加密通信；当命名会话中未指定值时使用。 自版本 6.0.19 起支持 |
||
| Plugins.MQTT.Default.Topic | no | MQTT订阅的默认主题；当监控项键值或命名会话中未指定值时使用。 主题可包含通配符("+","#") 示例： path/to/filepath/to/#path/+/topic自版本 6.0.19 起支持 |
||
| Plugins.MQTT.Default.Url | no | tcp://localhost:1883 | 默认MQTT代理连接string；当监控项键值或命名会话中未指定值时使用。 不应包含query参数。 必须符合URL格式。 支持协议： tcp（默认）、ws、tls；可省略协议头。端口可省略（默认1883）。 示例： tcp://host:1883localhostws://host:8080自版本 6.0.19 起支持 |
|
| Plugins.MQTT.Default.User | no | 连接MQTT的默认用户名；当监控项键值或命名会话中未指定值时使用。 自版本 6.0.19 起支持 |
||
| Plugins.MQTT.Sessions.<SessionName>.Password | no | 命名会话密码。 <SessionName> - 定义用于监控项键值的会话名称。 自版本 6.0.19 起支持 |
||
| Plugins.MQTT.Sessions.<SessionName>.TLSCAFile | no | 包含Top级CA证书的文件完整路径，用于Zabbix agent 2与MQTT代理间加密通信的证书验证。 <SessionName> - 定义用于监控项键值的会话名称。 自版本 6.0.19 起支持 |
||
| Plugins.MQTT.Sessions.<SessionName>.TLSCertFile | no | 包含agent证书或证书链的文件完整路径，用于Zabbix agent 2与MQTT代理间加密通信。 <SessionName> - 定义用于监控项键值的会话名称。 自版本 6.0.19 起支持 |
||
| Plugins.MQTT.Sessions.<SessionName>.TLSKeyFile | no | 包含MQTT私钥的文件完整路径，用于Zabbix agent 2与MQTT代理间加密通信。 <SessionName> - 定义用于监控项键值的会话名称。 自版本 6.0.19 起支持 |
||
| Plugins.MQTT.Sessions.<SessionName>.Topic | no | 命名会话的MQTT订阅主题。 <SessionName> - 定义用于监控项键值的会话名称。 主题可包含通配符("+","#") 示例： path/to/filepath/to/#path/+/topic自版本 6.0.19 起支持 |
||
| Plugins.MQTT.Sessions.<SessionName>.Url | no | 命名会话的连接string。 <SessionName> - 定义用于监控项键值的会话名称。 不应包含query参数。 必须符合URL格式。 支持协议： tcp（默认）、ws、tls；可省略协议头。端口可省略（默认1883）。 示例： tcp://host:1883localhostws://host:8080自版本 6.0.19 起支持 |
||
| Plugins.MQTT.Sessions.<SessionName>.User | no | 命名会话用户名。 <SessionName> - 定义用于监控项键值的会话名称。 自版本 6.0.19 起支持 |
||
| Plugins.MQTT.Timeout | no | 1-30 | 全局超时 | 请求执行超时时间（以秒为单位，在终止请求前等待完成的持续时间）。 |
另请参阅：
- Zabbix agent 2通用配置参数说明： Zabbix agent 2 (UNIX) / Zabbix agent 2 (Windows)
- plugins配置指南