6 MongoDB 插件

概述

本节列出MongoDB Zabbix agent 2插件配置文件(mongo.conf)支持的参数。

从Zabbix 6.0.6版本开始,MongoDB插件作为可加载插件提供,其完整说明参见MongoDB plugin repository

Windows平台的预编译插件二进制文件自Zabbix 6.0.19起提供,并与早期6.0版本兼容。

注意事项:

  • 默认值反映进程默认配置,而非随附配置文件中的值;
  • Zabbix仅支持UTF-8编码的配置文件,且不包含BOM
  • 以"#"开头的注释仅支持在行首使用。

选项

参数 描述
-V --version 打印插件版本和许可信息。
-h --help 打印帮助信息(简写形式)。

参数

在Zabbix 6.0.6之前的版本中,参数名称以Plugins.Mongo.<参数>开头,而非Plugins.MongoDB.<参数>。例如:Plugins.Mongo.KeepAlive

参数 必选 范围 默认值 说明
Plugins.MongoDB.Default.Password no MongoDB连接默认密码;当监控项键或命名会话未指定值时使用。
自6.0.18版本起支持
Plugins.MongoDB.Default.Uri no MongoDB连接默认URI;当监控项键或命名会话未指定值时使用。

不应包含嵌入式凭据(将被忽略)。
必须符合URI格式。
仅支持tcp协议;协议可省略。
端口可省略(默认=27017)。
示例:tcp://127.0.0.1:27017tcp:localhostlocalhost
自6.0.18版本起支持
Plugins.MongoDB.Default.User no MongoDB连接默认用户名;当监控项键或命名会话未指定值时使用。
自6.0.18版本起支持
Plugins.MongoDB.KeepAlive no 60-900 300 关闭未使用的插件连接前的最大等待时间(秒)。
Plugins.MongoDB.Sessions.<SessionName>.Password no 命名会话密码。
<SessionName> - 定义用于监控项键的会话名称。
Plugins.MongoDB.Sessions.<SessionName>.TLSCAFile no
(yes, if Plugins.MongoDB.Sessions.<SessionName>.TLSConnect is set to one of: verify_ca, verify_full)
包含Top级CA证书的文件完整路径,用于Zabbix agent 2与被监控数据库间的加密通信。
<SessionName> - 定义用于监控项键的会话名称。

插件版本1.2.0、6.0.13及更高版本支持脚注
Plugins.MongoDB.Sessions.<SessionName>.TLSCertFile yes, if Plugins.MongoDB.Sessions.<SessionName>.TLSKeyFile is specified

Before version 6.0.24 always mandatory if Plugins.MongoDB.Sessions.<SessionName>.TLSConnect is set to one of: verify_ca, verify_full
包含agent证书或证书链的文件完整路径,用于Zabbix agent 2与被监控数据库间的加密通信。
<SessionName> - 定义用于监控项键的会话名称。

插件版本1.2.0、6.0.13及更高版本支持脚注
Plugins.MongoDB.Sessions.<SessionName>.TLSConnect no Zabbix agent 2与被监控数据库间的通信加密类型。
<SessionName> - 定义用于监控项键的会话名称。

支持值:
required - 要求TLS连接;
verify_ca - 验证证书;
verify_full - 验证证书及IP地址。

插件版本1.2.0、6.0.13及更高版本支持脚注
Plugins.MongoDB.Sessions.<SessionName>.TLSKeyFile yes, if Plugins.MongoDB.Sessions.<SessionName>.TLSCertFile is specified

Before version 6.0.24 always mandatory if Plugins.MongoDB.Sessions.<SessionName>.TLSConnect is set to one of: verify_ca, verify_full
包含数据库私钥的文件完整路径,用于Zabbix agent 2与被监控数据库间的加密通信。
<SessionName> - 定义用于监控项键的会话名称。

插件版本1.2.0、6.0.13及更高版本支持脚注
Plugins.MongoDB.Sessions.<SessionName>.Uri no 命名会话的连接string。
<SessionName> - 定义用于监控项键的会话名称。

不应包含嵌入式凭据(将被忽略)。
必须符合URI格式。
仅支持tcp协议;协议可省略。
端口可省略(默认=27017)。
示例:tcp://127.0.0.1:27017tcp:localhostlocalhost
Plugins.MongoDB.Sessions.<SessionName>.User no 命名会话用户名。
<SessionName> - 定义用于监控项键的会话名称。
Plugins.MongoDB.System.Path no 外部插件可执行文件路径。自Zabbix 6.0.6起支持
Plugins.MongoDB.Timeout no 1-30 全局超时 请求执行超时(等待请求完成的持续时间,秒)。

另请参阅:

脚注

1 - 自Zabbix 6.0.13起,可加载插件开始采用与Zabbix自身相同的版本控制系统。 因此,MongoDB插件版本已从1.2.0变更为6.0.13。