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