Table of Contents
6 MongoDB 插件
概览
本节列出了 MongoDB Zabbix 代理 2 插件配置文件（mongo.conf）支持的参数。
自 Zabbix 6.0.6 起，MongoDB 插件是一个可加载插件，并且在 MongoDB 插件仓库 中可用并有完整描述。
自 Zabbix 6.0.19 起，Windows 的预编译插件二进制文件可用，并且与之前的 6.0 版本兼容。
请注意：
- 默认值反映了进程默认值，而不是配置文件中的值；
- Zabbix 仅支持 UTF-8 编码的配置文件，不包含 BOM；
- 仅支持以 "#" 开头的注释在行的开始处。
选项
| 参数 | 描述 |
|---|---|
| -V --version | 打印插件版本及license信息。 |
| -h --help | 打印帮助信息（简化版）。 |
参数
在 Zabbix 6.0.6 之前的版本中，参数名称以 Plugins.Mongo.<Parameter> 开头，而不是 Plugins.MongoDB.<Parameter>。例如，Plugins.Mongo.KeepAlive。
| 参数 | 必填 | 范围 | 默认值 | 描述 |
|---|---|---|---|---|
| Plugins.MongoDB.Default.Password | 否 | 连接到 MongoDB 的默认密码；如果项目键或命名会话中未指定值，则使用此密码。 自版本 6.0.18 起支持 |
||
| Plugins.MongoDB.Default.Uri | 否 | 连接到 MongoDB 的默认 URI；如果项目键或命名会话中未指定值，则使用此 URI。 不应包含嵌入式凭据（它们将被忽略）。 必须符合 URI 格式。 仅支持 tcp 方案；可以省略方案。可以省略端口（默认=27017）。 示例： tcp://127.0.0.1:27017, tcp:localhost, localhost自版本 6.0.18 起支持 |
||
| Plugins.MongoDB.Default.User | 否 | 连接到 MongoDB 的默认用户名；如果项目键或命名会话中未指定值，则使用此用户名。 自版本 6.0.18 起支持 |
||
| Plugins.MongoDB.KeepAlive | 否 | 60-900 | 300 | 未使用的插件连接被关闭之前的最长等待时间（秒）。 |
| Plugins.MongoDB.Sessions.<SessionName>.Password | 否 | 命名会话密码。 <SessionName> - 定义会话名称，用于项目键中。 |
||
| Plugins.MongoDB.Sessions.<SessionName>.TLSCAFile | 否 (如果 Plugins.MongoDB.Sessions.<SessionName>.TLSConnect 设置为 verify_ca 或 verify_full，则为是) |
用于 Zabbix 代理 2 与监控数据库之间加密通信的顶级 CA 证书文件的完整路径名，用于对等证书验证。 <SessionName> - 定义会话名称，用于项目键中。 支持插件版本 1.2.0, 6.0.13 及更新版本1. |
||
| Plugins.MongoDB.Sessions.<SessionName>.TLSCertFile | 如果指定了 Plugins.MongoDB.Sessions.<SessionName>.TLSKeyFile，则为是 在 6.0.24 版本之前，如果 Plugins.MongoDB.Sessions.<SessionName>.TLSConnect 设置为 verify_ca 或 verify_full，则始终为必填 |
包含代理证书或证书链的文件的完整路径名，用于 Zabbix 代理 2 与监控数据库之间的加密通信。 <SessionName> - 定义会话名称，用于项目键中。 支持插件版本 1.2.0, 6.0.13 及更新版本1. |
||
| Plugins.MongoDB.Sessions.<SessionName>.TLSConnect | 否 | Zabbix 代理 2 与监控数据库之间通信的加密类型。 <SessionName> - 定义会话名称，用于项目键中。 支持的值： required - 要求 TLS 连接； verify_ca - 验证证书； verify_full - 验证证书和 IP 地址。 支持插件版本 1.2.0, 6.0.13 及更新版本1. |
||
| Plugins.MongoDB.Sessions.<SessionName>.TLSKeyFile | 如果指定了 Plugins.MongoDB.Sessions.<SessionName>.TLSCertFile，则为是 在 6.0.24 版本之前，如果 Plugins.MongoDB.Sessions.<SessionName>.TLSConnect 设置为 verify_ca 或 verify_full，则始终为必填 |
包含数据库私钥的文件的完整路径名，用于 Zabbix 代理 2 与监控数据库之间的加密通信。 <SessionName> - 定义会话名称，用于项目键中。 支持插件版本 1.2.0, 6.0.13 及更新版本1. |
||
| Plugins.MongoDB.Sessions.<SessionName>.Uri | 否 | 命名会话的连接字符串。 <SessionName> - 定义会话名称，用于项目键中。 不应包含嵌入式凭据（它们将被忽略）。 必须符合 URI 格式。 仅支持 tcp 方案；可以省略方案。可以省略端口（默认=27017）。 示例： tcp://127.0.0.1:27017, tcp:localhost, localhost |
||
| Plugins.MongoDB.Sessions.<SessionName>.User | 否 | 命名会话用户名。 <SessionName> - 定义会话名称，用于项目键中。 |
||
| Plugins.MongoDB.System.Path | 否 | 外部插件可执行文件的路径。自 Zabbix 6.0.6 起支持 | ||
| Plugins.MongoDB.Timeout | 否 | 1-30 | 全局超时 | 请求执行超时（在关闭之前等待请求完成的时间）。 |
另请参阅：
- Zabbix 代理 2 通用配置参数的描述： Zabbix 代理 2 (UNIX) / Zabbix 代理 2 (Windows)
- 插件配置指南
脚注
1 - 自 Zabbix 6.0.13 起，可加载插件开始使用与 Zabbix 本身相同的版本系统。 结果，MongoDB 插件版本从 1.2.0 变更为 6.0.13。