9 PostgreSQL plugin

Overview

This section lists parameters supported in the PostgreSQL Zabbix agent 2 plugin configuration file (postgres.conf). Note that:

  • The default values reflect process defaults, not the values in the shipped configuration files;
  • Zabbix supports configuration files only in UTF-8 encoding without BOM;
  • Comments starting with “#” are only supported at the beginning of the line.

Parameters

ParameterMandatoryRangeDefaultDescription
Plugins.Postgres.CallTimeoutno1-30global timeoutThe maximum wait time in seconds for a request to be completed.
Plugins.Postgres.CustomQueriesPathnoFull pathname of a directory containing .sql files with custom queries.
Disabled by default.
Example: /etc/zabbix/postgres/sql
Plugins.Postgres.HostnolocalhostIP address or DNS name of the host used for PostgreSQL.
Examples: localhost, 192.168.1.1
Plugins.Postgres.KeepAliveno60-900300The maximum time of waiting (in seconds) before unused plugin connections are closed.
Plugins.Postgres.Portno5432A port to be used for PostgreSQL.
Plugins.Postgres.Sessions.<SessionName>.DatabasenopostgresDatabase name of a named session.
<SessionName> - name of a session for using in item keys.
Plugins.Postgres.Sessions.<SessionName>.PasswordnoNamed session password.
<SessionName> - name of a session for using in item keys.
Plugins.Postgres.Sessions.<SessionName>.TLSCAFilenoFull pathname of a file containing the top-level CA(s) certificates for peer certificate verification, used for encrypted communications between Zabbix agent 2 and monitored databases.
<SessionName> - name of a session for using in item keys.
Plugins.Postgres.Sessions.<SessionName>.TLSCertFilenoFull pathname of a file containing the agent certificate or certificate chain, used for encrypted communications between Zabbix agent 2 and monitored databases.
<SessionName> - name of a session for using in item keys.
Plugins.Postgres.Sessions.<SessionName>.TLSConnectnoEncryption type for communications between Zabbix agent 2 and monitored databases.
<SessionName> - name of a session for using in item keys.

Accepted values:
required - require TLS connection;
verify_ca - verify certificates;
verify_full - verify certificates and IP address.
Plugins.Postgres.Sessions.<SessionName>.TLSKeyFilenoFull pathname of a file containing the database private key used for encrypted communications between Zabbix agent 2 and monitored databases.
<SessionName> - name of a session for using in item keys.
Plugins.Postgres.Sessions.<SessionName>.UrinopostgresNamed session connection string for Oracle.
<SessionName> - name of a session for using in item keys.

Should not include embedded credentials (they will be ignored).
Must match the URI format.
Supported schemes are tcp and unix.
Examples: tcp://127.0.0.1:5432
localhost
Plugins.Postgres.Sessions.<SessionName>.UsernoNamed session username.
<SessionName> - name of a session for using in item keys.
Plugins.Postgres.Timeoutno1-30global timeoutRequest execution timeout (how long to wait for a request to complete before shutting it down).

See also: