On this page

7 MQTT 插件

概述

Zabbix agent 2 的配置文件用于配置插件。运行 MQTT 插件支持以下 Zabbix agent 2 配置参数。

建议将它们指定在各自的配置文件中（例如 mqtt.conf），然后使用 Include 指令将此文件添加到 Zabbix agent 2 配置中。

请注意：

  • 默认值反映的是进程默认值，而不是随软件提供的配置文件中的值；
  • 值支持环境变量；
  • Zabbix 仅支持 UTF-8 编码且不带 BOM 的配置文件；
  • 以 "#" 开头的注释仅在行首支持。

参数

Parameter Mandatory Range Default Description
Plugins.MQTT.Default.Password no 用于连接 MQTT 的默认密码；如果监控项键或命名会话中未指定值，则使用此密码。
Plugins.MQTT.Default.TLSCAFile no 包含用于对等证书验证的顶级 CA 证书的文件完整路径名，用于 Zabbix agent 2 与 MQTT broker 之间的加密通信；如果命名会话中未指定值，则使用此文件。
Plugins.MQTT.Default.TLSCertFile no 包含 agent 证书或证书链的文件完整路径名，用于 Zabbix agent 2 与 MQTT broker 之间的加密通信；如果命名会话中未指定值，则使用此文件。
Plugins.MQTT.Default.TLSKeyFile no 包含用于 Zabbix agent 2 与 MQTT broker 之间加密通信的 MQTT 私钥的文件完整路径名；如果命名会话中未指定值，则使用此文件。
Plugins.MQTT.Default.Topic no MQTT 订阅的默认主题；如果监控项键或命名会话中未指定值，则使用此主题。

主题可以包含通配符（"+"、"#"）
示例：path/to/file
path/to/#
path/+/topic
Plugins.MQTT.Default.Url no tcp://localhost:1883 默认 MQTT broker 连接字符串；如果监控项键或命名会话中未指定值，则使用此字符串。

不应包含查询参数。
必须符合 URL 格式。
支持的协议：tcp（默认）、ws、tls；协议可以省略。
端口可以省略（默认=1883）。
示例：tcp://host:1883
localhost
ws://host:8080
Plugins.MQTT.Default.User no 用于连接 MQTT 的默认用户名；如果监控项键或命名会话中未指定值，则使用此用户名。
Plugins.MQTT.Sessions.<SessionName>.Password no 命名会话密码。
<SessionName> - 定义用于监控项键中的会话名称。
Plugins.MQTT.Sessions.<SessionName>.TLSCAFile no 包含用于对等证书验证的顶级 CA 证书的文件完整路径名，用于 Zabbix agent 2 与 MQTT broker 之间的加密通信。
<SessionName> - 定义用于监控项键中的会话名称。
Plugins.MQTT.Sessions.<SessionName>.TLSCertFile no 包含 agent 证书或证书链的文件完整路径名，用于 Zabbix agent 2 与 MQTT broker 之间的加密通信。
<SessionName> - 定义用于监控项键中的会话名称。
Plugins.MQTT.Sessions.<SessionName>.TLSKeyFile no 包含用于 Zabbix agent 2 与 MQTT broker 之间加密通信的 MQTT 私钥的文件完整路径名。
<SessionName> - 定义用于监控项键中的会话名称。
Plugins.MQTT.Sessions.<SessionName>.Topic no 命名会话的 MQTT 订阅主题。
<SessionName> - 定义用于监控项键中的会话名称。

主题可以包含通配符（"+"、"#"）
示例：path/to/file
path/to/#
path/+/topic
Plugins.MQTT.Sessions.<SessionName>.Url no 命名会话的连接字符串。
<SessionName> - 定义用于监控项键中的会话名称。

不应包含查询参数。
必须符合 URL 格式。
支持的协议：tcp（默认）、ws、tls；协议可以省略。
端口可以省略（默认=1883）。
示例：tcp://host:1883
localhost
ws://host:8080
Plugins.MQTT.Sessions.<SessionName>.User no 命名会话用户名。
<SessionName> - 定义用于监控项键中的会话名称。

如果需要设置请求执行超时（即在关闭请求之前等待其完成的时间），请使用 监控项配置 表单。

另请参见：