Table of Contents

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/file
path/to/#
path/+/topic
自版本 6.0.19 起支持
Plugins.MQTT.Default.Url no tcp://localhost:1883 默认MQTT代理连接string;当监控项键值或命名会话中未指定值时使用。

不应包含query参数。
必须符合URL格式。
支持协议:tcp(默认)、wstls;可省略协议头。
端口可省略(默认1883)。
示例:tcp://host:1883
localhost
ws://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/file
path/to/#
path/+/topic
自版本 6.0.19 起支持
Plugins.MQTT.Sessions.<SessionName>.Url no 命名会话的连接string。
<SessionName> - 定义用于监控项键值的会话名称。

不应包含query参数。
必须符合URL格式。
支持协议:tcp(默认)、wstls;可省略协议头。
端口可省略(默认1883)。
示例:tcp://host:1883
localhost
ws://host:8080
自版本 6.0.19 起支持
Plugins.MQTT.Sessions.<SessionName>.User no 命名会话用户名。
<SessionName> - 定义用于监控项键值的会话名称。
自版本 6.0.19 起支持
Plugins.MQTT.Timeout no 1-30 全局超时 请求执行超时时间(以秒为单位,在终止请求前等待完成的持续时间)。

另请参阅: