Documentation
Table of Contents
11 PostgreSQL 插件
概述
本节列出PostgreSQL Zabbix agent 2插件配置file (postgresql.conf)中支持的参数.
PostgreSQL插件是一个可加载插件，其完整描述可在PostgreSQL plugin repository中获取.
请注意:
- 默认值反映进程默认值，而非随附配置文件中的值.
- Zabbix仅支持UTF-8编码的配置文件，不支持BOM.
- 以"#"开头的注释仅支持在行首使用.
选项
| 参数 | 描述 |
|---|---|
| -V --version | 打印插件version及许可证信息. |
| -h --help | 打印帮助信息(简写形式). |
参数
| 参数 | 必填 | 范围 | 默认值 | 描述 |
|---|---|---|---|---|
| Plugins.PostgreSQL.Default.CacheMode | no | prepare | PostgreSQL连接的缓存模式。 支持的值： prepare（默认）- 将在PostgreSQL服务器上create预处理语句； describe - 将使用匿名预处理语句来描述语句，而不在服务器上创建语句。 注意"describe"主要在环境不允许预处理语句时有用，例如运行PgBouncer等连接池时。 |
|
| Plugins.PostgreSQL.CallTimeout | no | 1-30 | global timeout | 请求完成的最大等待时间（秒）。 |
| Plugins.PostgreSQL.CustomQueriesPath | no | disabled | 包含自定义queries的.sql文件目录的完整路径名。 | |
| Plugins.PostgreSQL.Default.Database | no | 连接PostgreSQL的默认数据库；如果监控项键或命名会话中未指定值则使用。 | ||
| Plugins.PostgreSQL.Default.Password | no | 连接PostgreSQL的默认密码；如果监控项键或命名会话中未指定值则使用。 | ||
| Plugins.PostgreSQL.Default.TLSCAFile | no (yes, if Plugins.PostgreSQL.Default.TLSConnect is set to verify_ca or verify_full) |
包含Top级CA证书的file的完整路径名，用于Zabbix agent 2与受监控数据库之间加密通信的对等证书验证；如果命名会话中未指定值则使用。 | ||
| Plugins.PostgreSQL.Default.TLSCertFile | no (yes, if Plugins.PostgreSQL.Default.TLSConnect is set to verify_ca or verify_full) |
包含PostgreSQL证书或证书链的file的完整路径名，用于Zabbix agent 2与受监控数据库之间的加密通信；如果命名会话中未指定值则使用。 | ||
| Plugins.PostgreSQL.Default.TLSConnect | no | Zabbix agent 2与受监控数据库之间通信的加密类型；如果命名会话中未指定值则使用。 支持的值： required - 使用TLS作为传输模式连接，不进行身份检查； verify_ca - 使用TLS连接并验证证书； verify_full - 使用TLS连接，验证证书并验证DBHost指定的数据库身份（CN）与其证书匹配。 未定义加密类型表示未加密连接。 |
||
| Plugins.PostgreSQL.Default.TLSKeyFile | no (yes, if Plugins.PostgreSQL.Default.TLSConnect is set to verify_ca or verify_full) |
包含PostgreSQL私钥的file的完整路径名，用于Zabbix agent 2与受监控数据库之间的加密通信；如果命名会话中未指定值则使用。 | ||
| Plugins.PostgreSQL.Default.Uri | no | 连接PostgreSQL的默认URI；如果监控项键或命名会话中未指定值则使用。 不应包含嵌入式凭据（它们将被忽略）。 必须匹配URI格式。 支持的方案： tcp, unix。示例： tcp://127.0.0.1:5432tcp://localhostunix:/var/run/postgresql/.s.PGSQL.5432 |
||
| Plugins.PostgreSQL.Default.User | no | 连接PostgreSQL的默认用户名；如果监控项键或命名会话中未指定值则使用。 | ||
| Plugins.PostgreSQL.KeepAlive | no | 60-900 | 300 | 关闭未使用的插件连接前的最大等待时间（秒）。 |
| Plugins.PostgreSQL.Sessions.<SessionName>.CacheMode | no | prepare | PostgreSQL连接的缓存模式。 <SessionName> - 定义用于监控项键的会话名称。 支持的值： prepare（默认）- 将在PostgreSQL服务器上create预处理语句； describe - 将使用匿名预处理语句来描述语句，而不在服务器上创建语句。 注意"describe"主要在环境不允许预处理语句时有用，例如运行PgBouncer等连接池时。 |
|
| Plugins.PostgreSQL.Sessions.<SessionName>.Database | no | 会话连接的数据库。 <SessionName> - 定义用于监控项键的会话名称。 |
||
| Plugins.PostgreSQL.Sessions.<SessionName>.Password | no | Must match the password format. | 会话连接的密码。 <SessionName> - 定义用于监控项键的会话名称。 |
|
| Plugins.PostgreSQL.Sessions.<SessionName>.TLSCAFile | no (yes, if Plugins.PostgreSQL.Sessions.<SessionName>.TLSConnect is set to verify_ca or verify_full) |
包含Top级CA证书对等证书验证的file的完整路径名。 <SessionName> - 定义用于监控项键的会话名称。 |
||
| Plugins.PostgreSQL.Sessions.<SessionName>.TLSCertFile | yes, if Plugins.PostgreSQL.Sessions.<SessionName>.TLSKeyFile is specified | 包含PostgreSQL证书或证书链的file的完整路径名。 <SessionName> - 定义用于监控项键的会话名称。 |
||
| Plugins.PostgreSQL.Sessions.<SessionName>.TLSConnect | no | PostgreSQL连接的加密类型。 <SessionName> - 定义用于监控项键的会话名称。 支持的值： required - 使用TLS作为传输模式连接，不进行身份检查； verify_ca - 使用TLS连接并验证证书； verify_full - 使用TLS连接，验证证书并验证DBHost指定的数据库身份（CN）与其证书匹配。 未定义加密类型表示未加密连接。 |
||
| Plugins.PostgreSQL.Sessions.<SessionName>.TLSKeyFile | yes, if Plugins.PostgreSQL.Sessions.<SessionName>.TLSCertFile is specified | 包含PostgreSQL私钥的file的完整路径名。 <SessionName> - 定义用于监控项键的会话名称。 |
||
| Plugins.PostgreSQL.Sessions.<SessionName>.Uri | no | 命名会话的连接string。 <SessionName> - 定义用于监控项键的会话名称。 不应包含嵌入式凭据（它们将被忽略）。 必须匹配URI格式。 支持的方案： tcp, unix。示例： tcp://127.0.0.1:5432tcp://localhostunix:/var/run/postgresql/.s.PGSQL.5432 |
||
| Plugins.PostgreSQL.Sessions.<SessionName>.User | no | 命名会话的用户名。 <SessionName> - 定义用于监控项键的会话名称。 |
||
| Plugins.PostgreSQL.System.Path | yes | 外部插件可执行文件的路径。 | ||
| Plugins.PostgreSQL.Timeout | no | 1-30 | global timeout | 请求执行超时（在关闭请求前等待请求完成的持续时间，秒）。 |
另请参阅：
- 通用Zabbix agent 2配置参数描述：Zabbix agent 2 (UNIX) / Zabbix agent 2 (Windows)
- plugins配置说明