Documentation
7 MQTT 插件
概述
本节列出了Zabbix agent 2的MQTT插件配置文件(mqtt.conf)中所有支持的参数。
请注意：
- 默认值表示的是进程默认值，而不是附带的配置文件中的值；
- Zabbix 仅支持不带BOM的 UTF-8 编码的配置文件；
- 仅支持在行首以"#"开头的注释。
参数说明
| 参数 | 是否必须 | 可选范围 | 默认值 | 描述 |
|---|---|---|---|---|
| Plugins.MQTT.Default.Password | 否 | MQTT连接的默认密码；如果在项目键或命名会话中未指定值，则使用此值。 | ||
| Plugins.MQTT.Default.TLSCAFile | 否 | 包含用于Zabbix agent 2与MQTT broker之间加密通信的顶级CA证书的文件的完整路径；如果在命名会话中未指定值，则使用此值。 | ||
| Plugins.MQTT.Default.TLSCertFile | 否 | 包含用于Zabbix agent 2与MQTT broker之间加密通信的代理证书或证书链的文件的完整路径；如果在命名会话中未指定值，则使用此值。 | ||
| Plugins.MQTT.Default.TLSKeyFile | 否 | 包含用于Zabbix agent 2与MQTT broker之间加密通信的MQTT私钥的文件的完整路径；如果在命名会话中未指定值，则使用此值。 | ||
| Plugins.MQTT.Default.Topic | 否 | MQTT订阅的默认主题；如果在项目键或命名会话中未指定值，则使用此值。 主题可以包含通配符（"+", "#"） 示例： path/to/filepath/to/#path/+/topic |
||
| Plugins.MQTT.Default.Url | 否 | tcp://localhost:1883 | MQTT broker的默认连接字符串；如果在项目键或命名会话中未指定值，则使用此值。 不应包含查询参数。 必须匹配URL格式。 支持的协议： tcp（默认）、ws、tls；可以省略协议。端口可以省略（默认=1883）。 示例： tcp://host:1883localhostws://host:8080 |
|
| Plugins.MQTT.Default.User | 否 | MQTT连接的默认用户名；如果在项目键或命名会话中未指定值，则使用此值。 | ||
| Plugins.MQTT.Sessions.<SessionName>.Password | 否 | 命名会话的密码。 <SessionName> - 在项目键中使用的会话名称。 |
||
| Plugins.MQTT.Sessions.<SessionName>.TLSCAFile | 否 | 包含用于加密通信的Zabbix agent 2与MQTT broker之间的顶级CA证书的文件的完整路径。 <SessionName> - 在项目键中使用的会话名称。 |
||
| Plugins.MQTT.Sessions.<SessionName>.TLSCertFile | 否 | 包含用于加密通信的Zabbix agent 2与MQTT broker之间的代理证书或证书链的文件的完整路径。 <SessionName> - 在项目键中使用的会话名称。 |
||
| Plugins.MQTT.Sessions.<SessionName>.TLSKeyFile | 否 | 包含用于加密通信的Zabbix agent 2与MQTT broker之间的MQTT私钥的文件的完整路径。 <SessionName> - 在项目键中使用的会话名称。 |
||
| Plugins.MQTT.Sessions.<SessionName>.Topic | 否 | 命名会话的MQTT订阅主题。 <SessionName> - 在项目键中使用的会话名称。 主题可以包含通配符（"+", "#"） 示例： path/to/filepath/to/#path/+/topic |
||
| Plugins.MQTT.Sessions.<SessionName>.Url | 否 | 命名会话的连接字符串。 <SessionName> - 在项目键中使用的会话名称。 不应包含查询参数。 必须匹配URL格式。 支持的协议： tcp（默认）、ws、tls；可以省略协议。端口可以省略（默认=1883）。 示例： tcp://host:1883localhostws://host:8080 |
||
| Plugins.MQTT.Sessions.<SessionName>.User | 否 | 命名会话的用户名。 <SessionName> - 在项目键中使用的会话名称。 |
如果需要设置请求执行超时时间（等待请求完成前的时间），请在监控项配置中设置。
另请参阅：
- 一般Zabbix agent 2配置参数说明： Zabbix agent 2 (UNIX) Zabbix agent 2 (Windows)
- 插件配置说明