On this page

7 MQTT 插件

概述

Zabbix agent 2 的配置文件用于配置插件。以下这些 Zabbix agent 2 配置参数可用于运行 MQTT 插件。

建议在其各自的配置文件中指定这些参数（例如 mqtt.conf），然后使用 Include 指令将该文件添加到 Zabbix agent 2 配置中。

请注意：

  • 默认值反映的是进程默认值，而不是随附配置文件中的值；
  • 这些值支持环境变量；
  • Zabbix 仅支持采用 UTF-8 编码且不带 BOM 的配置文件；
  • 仅支持以“#”开头且位于行首的注释。

参数

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

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

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

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

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

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

另请参见：