Table of Contents
6 MongoDB 插件
概述
本节列出了MongoDB Zabbix agent 2插件配置file (mongo.conf)中支持的参数.
自Zabbix 6.0.6起，MongoDB插件作为可加载插件提供，其完整描述见MongoDB plugin repository.
Windows平台的预编译插件二进制文件自Zabbix 6.0.19起提供，并与之前的6.0版本兼容.
注意事项:
- 默认值反映进程默认设置，而非随附配置文件中的值;
- Zabbix仅支持UTF-8编码的配置文件，不包含BOM;
- 以"#"开头的注释仅支持在行首使用.
选项
| 参数 | 描述 |
|---|---|
| -V --version | 打印插件version及许可证信息 |
| -h --help | 打印帮助信息(简写形式) |
参数
在Zabbix 6.0.6之前的版本中，参数名称以Plugins.Mongo.<参数>开头，而非Plugins.MongoDB.<参数>。例如，Plugins.Mongo.KeepAlive
| 参数 | 必填 | 范围 | 默认值 | 描述 |
|---|---|---|---|---|
| Plugins.MongoDB.Default.Password | no | 连接MongoDB的默认密码；当监控项键或命名会话中未指定值时使用。 自version 6.0.18版本起支持 |
||
| Plugins.MongoDB.Default.Uri | no | 连接MongoDB的默认URI；当监控项键或命名会话中未指定值时使用。 不应包含嵌入式凭据（将被忽略）。 必须符合URI格式。 仅支持 tcp协议；协议可省略。端口可省略（默认=27017）。 示例： tcp://127.0.0.1:27017, tcp:localhost, localhost自version 6.0.18版本起支持 |
||
| Plugins.MongoDB.Default.User | no | 连接MongoDB的默认用户名；当监控项键或命名会话中未指定值时使用。 自version 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证书的file完整路径名，用于Zabbix agent 2与被监控数据库之间的加密通信。 <SessionName> - 定义用于监控项键的会话名称。 插件版本1.2.0、6.0.13及更高版本支持1。 |
||
| 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证书或证书链的file完整路径名，用于Zabbix agent 2与被监控数据库之间的加密通信。 <SessionName> - 定义用于监控项键的会话名称。 插件版本1.2.0、6.0.13及更高版本支持1。 |
||
| Plugins.MongoDB.Sessions.<SessionName>.TLSConnect | no | Zabbix agent 2与被监控数据库之间的通信加密类型。 <SessionName> - 定义用于监控项键的会话名称。 支持值： required - 需要TLS连接； verify_ca - 验证证书； verify_full - 验证证书和IP地址。 插件版本1.2.0、6.0.13及更高版本支持1。 |
||
| 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 |
包含数据库私钥的file完整路径名，用于Zabbix agent 2与被监控数据库之间的加密通信。 <SessionName> - 定义用于监控项键的会话名称。 插件版本1.2.0、6.0.13及更高版本支持1。 |
||
| Plugins.MongoDB.Sessions.<SessionName>.Uri | no | 命名会话的连接string。 <SessionName> - 定义用于监控项键的会话名称。 不应包含嵌入式凭据（将被忽略）。 必须符合URI格式。 仅支持 tcp协议；协议可省略。端口可省略（默认=27017）。 示例： tcp://127.0.0.1:27017, tcp:localhost, localhost |
||
| Plugins.MongoDB.Sessions.<SessionName>.User | no | 命名会话用户名。 <SessionName> - 定义用于监控项键的会话名称。 |
||
| Plugins.MongoDB.System.Path | no | 外部插件可执行文件路径。自Zabbix 6.0.6版本起支持 | ||
| Plugins.MongoDB.Timeout | no | 1-30 | global timeout | 请求执行超时（在关闭请求前等待其完成的持续时间，以秒为单位）。 |
另请参阅：
- 通用Zabbix agent 2配置参数说明： Zabbix agent 2 (UNIX) / Zabbix agent 2 (Windows)
- plugins配置指南
脚注
1 - 自Zabbix 6.0.13起，可加载插件开始采用与Zabbix自身相同的版本控制系统。 因此，MongoDB插件version的版本号已从1.2.0变更为6.0.13。