Complemento de PostgreSQL

Resumen

Los parámetros de configuración permiten personalizar el comportamiento del plugin de PostgreSQL.

Se recomienda especificarlos en su propio archivo de configuración (por ejemplo, postgresql.conf), en lugar de hacerlo en el archivo de configuración de agent 2. Luego, use la directiva Include para incluir este archivo en la configuración de Zabbix agent 2.

El plugin de PostgreSQL es un plugin cargable y está disponible y descrito en detalle en el repositorio del plugin de PostgreSQL.

Todos los parámetros son opcionales, a menos que se indique explícitamente que el parámetro es obligatorio.

Esta página está estructurada de la siguiente manera:

  • Resumen de parámetros (para ver los detalles completos de un parámetro, haga clic en su nombre)
  • Detalles de parámetros
Parameter Description
Plugins.PostgreSQL.CallTimeout Establece el tiempo máximo de espera, en segundos, para que se complete una solicitud.
Plugins.PostgreSQL.CustomQueriesPath Especifica la ruta completa del directorio que contiene archivos .sql con consultas personalizadas.
Plugins.PostgreSQL.CustomQueriesEnabled Habilita la ejecución de la clave de item postgresql.custom.query.
Plugins.PostgreSQL.Default.CacheMode Especifica el modo de caché predeterminado para la conexión de PostgreSQL.
Plugins.PostgreSQL.Default.Database Especifica el nombre de la base de datos predeterminada.
Plugins.PostgreSQL.Default.Password Especifica la contraseña predeterminada.
Plugins.PostgreSQL.Default.TLSCAFile Especifica la ruta completa del archivo que contiene el certificado de la(s) CA raíz para la verificación del certificado de pares.
Plugins.PostgreSQL.Default.TLSCertFile Especifica la ruta completa del archivo que contiene el certificado de PostgreSQL o la cadena de certificados.
Plugins.PostgreSQL.Default.TLSConnect Especifica el nivel de cifrado predeterminado para las comunicaciones entre Zabbix agent 2 y las bases de datos monitorizadas.
Plugins.PostgreSQL.Default.TLSKeyFile Especifica la ruta completa del archivo que contiene la clave privada de PostgreSQL.
Plugins.PostgreSQL.Default.Uri Especifica el URI predeterminado.
Plugins.PostgreSQL.Default.User Especifica el nombre de usuario predeterminado.
Plugins.PostgreSQL.KeepAlive Establece el tiempo máximo de espera, en segundos, antes de cerrar las conexiones del plugin no utilizadas.
Plugins.PostgreSQL.Sessions.<SessionName>.CacheMode Especifica el modo de caché de la sesión con nombre para la conexión de PostgreSQL.
Plugins.PostgreSQL.Sessions.<SessionName>.Database Especifica el nombre de la base de datos de la sesión con nombre.
Plugins.PostgreSQL.Sessions.<SessionName>.Password Especifica la contraseña de la sesión con nombre.
Plugins.PostgreSQL.Sessions.<SessionName>.TLSCAFile Especifica la ruta completa del archivo que contiene el certificado de la(s) CA raíz para la verificación del certificado de pares.
Plugins.PostgreSQL.Sessions.<SessionName>.TLSCertFile Especifica la ruta completa del archivo que contiene el certificado de PostgreSQL o la cadena de certificados.
Plugins.PostgreSQL.Sessions.<SessionName>.TLSConnect Especifica el nivel de cifrado de la sesión con nombre para las comunicaciones entre Zabbix agent 2 y las bases de datos monitorizadas.
Plugins.PostgreSQL.Sessions.<SessionName>.TLSKeyFile Especifica la ruta completa del archivo que contiene la clave privada de PostgreSQL.
Plugins.PostgreSQL.Sessions.<SessionName>.Uri Especifica el URI de la sesión con nombre.
Plugins.PostgreSQL.Sessions.<SessionName>.User Especifica el nombre de usuario de la sesión con nombre.

|Plugins.PostgreSQL.System.Path|Especifica la ruta al ejecutable del plugin de PostgreSQL.| |Plugins.PostgreSQL.Timeout|Establece el tiempo de espera de ejecución de la solicitud.|

Tenga en cuenta que:

  • Los valores predeterminados reflejan los valores predeterminados del proceso, no los valores de los archivos de configuración suministrados.
  • Los valores admiten variables de entorno;
  • Zabbix solo admite archivos de configuración en codificación UTF-8 sin BOM.
  • Los comentarios que comienzan con "#" solo se admiten al principio de la línea.

Detalles del parámetro

Plugins.PostgreSQL.CallTimeout

Establece el tiempo máximo de espera, en segundos, para que se complete una solicitud.

Predeterminado: global timeout
Rango: 1-30

Plugins.PostgreSQL.CustomQueriesPath

Especifique la ruta completa del directorio que contiene archivos .sql con consultas personalizadas.

Valores predeterminados:
/usr/local/share/zabbix/custom-queries/postgreSQL - para sistemas Unix,
*:\Program Files\Zabbix Agent 2\Custom Queries\PostgreSQL - para sistemas Windows (donde * es el nombre de la unidad de la variable de entorno ProgramFiles)

Ejemplo:

/etc/zabbix/oracle/sql
Plugins.PostgreSQL.CustomQueriesEnabled

Habilita la ejecución de la clave de item postgresql.custom.query.
Si está deshabilitado, no se cargarán consultas desde la ruta del directorio de consultas personalizadas.

Predeterminado: false
Rango: true/false

Plugins.PostgreSQL.Default.CacheMode

Especifica el modo de caché predeterminado para la conexión de PostgreSQL.

Predeterminado: prepare
Rango:
prepare - crea sentencias preparadas en el server de PostgreSQL;
describe - usa la sentencia preparada anónima para describir una sentencia sin crear una sentencia en el server.

Tenga en cuenta que describe es útil principalmente cuando el entorno no permite sentencias preparadas, como al ejecutar un pooler de conexiones como PgBouncer.

Plugins.PostgreSQL.Default.Database

Especifique la base de datos predeterminada para conectarse a PostgreSQL.
Se usa si no se especifica ningún valor en una clave de item o en una sesión con nombre.

Plugins.PostgreSQL.Default.Password

Especifique la contraseña predeterminada para conectarse a PostgreSQL.
Se usa si no se especifica ningún valor en una clave de item o en una sesión con nombre.

Plugins.PostgreSQL.Default.TLSCAFile

Especifique la ruta completa del archivo que contiene el certificado de la CA de nivel superior para la verificación del certificado del par en las comunicaciones cifradas entre Zabbix agent 2 y las bases de datos monitorizadas.
Se usa si no se especifica ningún valor en una sesión con nombre.

Obligatorio: yes, si Plugins.PostgreSQL.Default.TLSConnect está establecido en verify_ca o verify_full

Plugins.PostgreSQL.Default.TLSCertFile

Especifique la ruta completa del archivo que contiene el certificado de PostgreSQL o la cadena de certificados para las comunicaciones cifradas entre Zabbix agent 2 y las bases de datos monitorizadas.
Se usa si no se especifica ningún valor en una sesión con nombre.

Obligatorio: yes, si se especifica Plugins.PostgreSQL.Default.TLSKeyFile

Plugins.PostgreSQL.Default.TLSConnect

Especifique el nivel predeterminado de cifrado para las comunicaciones entre Zabbix agent 2 y las bases de datos monitorizadas.
Se usa si no se especifica ningún valor en una sesión con nombre.

Rango:
required - conectarse usando TLS como modo de transporte sin comprobaciones de identidad;
verify_ca - conectarse usando TLS y verificar el certificado;
verify_full - conectarse usando TLS, verificar el certificado y verificar que la identidad de la base de datos (CN) especificada por DBHost coincida con su certificado.

Un tipo de cifrado no definido significa una conexión sin cifrar.

Plugins.PostgreSQL.Default.TLSKeyFile

Especifique la ruta completa del archivo que contiene la clave privada de PostgreSQL para las comunicaciones cifradas entre Zabbix agent 2 y las bases de datos monitorizadas.
Se usa si no se especifica ningún valor en una sesión con nombre.

Obligatorio: yes, si se especifica Plugins.PostgreSQL.Default.TLSCertFile

Plugins.PostgreSQL.Default.Uri

Especifique la URI predeterminada para conectarse a PostgreSQL.
Se usa si no se especifica ningún valor en una clave de item o en una sesión con nombre.
Las credenciales incrustadas se ignorarán.
Debe coincidir con el formato de URI.
Esquemas compatibles: tcp, unix

Ejemplos:

tcp://127.0.0.1:5432
tcp://localhost
unix:/var/run/postgresql/.s.PGSQL.5432
Plugins.PostgreSQL.Default.User

Especifique el nombre de usuario predeterminado para conectarse a PostgreSQL.
Se utiliza si no se especifica ningún valor en una clave de item o en una sesión con nombre.

Plugins.PostgreSQL.KeepAlive

Establece el tiempo máximo de espera (en segundos) antes de que se cierren las conexiones del plugin que no se estén utilizando.

Plugins.PostgreSQL.Sessions.<SessionName>.CacheMode

Especifique el modo de caché de sesión con nombre para la conexión de PostgreSQL.
<SessionName> - defina el nombre de una sesión para usarlo en las claves de item.

Predeterminado: prepare
Rango:
prepare - crea sentencias preparadas en el server de PostgreSQL;
describe - usa la sentencia preparada anónima para describir una sentencia sin crear una sentencia en el server.

Tenga en cuenta que describe es principalmente útil cuando el entorno no permite sentencias preparadas, como al ejecutar un pooler de conexiones como PgBouncer.

Plugins.PostgreSQL.Sessions.<SessionName>.Database

Especifica la base de datos de la sesión con nombre para conectarse a PostgreSQL.
<SessionName> - define el nombre de una sesión para usarlo en las claves de item.

Plugins.PostgreSQL.Sessions.<SessionName>.Password

Especifique la contraseña de la sesión con nombre para conectarse a PostgreSQL.
<SessionName> - define el nombre de una sesión para usar en las claves de item.
Debe coincidir con el formato de la contraseña.

Plugins.PostgreSQL.Sessions.<SessionName>.TLSCAFile

Especifique la ruta completa del archivo que contiene el certificado de la CA de nivel superior para la verificación del certificado del par en las comunicaciones cifradas entre Zabbix agent 2 y las bases de datos monitorizadas.
<SessionName> - defina el nombre de una sesión para usarlo en las claves de item.

Obligatorio: yes, si Plugins.PostgreSQL.Sessions.<SessionName>.TLSConnect está establecido en verify_ca o verify_full

Plugins.PostgreSQL.Sessions.<SessionName>.TLSCertFile

Especifique la ruta completa del archivo que contiene el certificado de PostgreSQL o la cadena de certificados para las comunicaciones cifradas entre Zabbix agent 2 y las bases de datos monitorizadas.
<SessionName> - defina el nombre de una sesión para usarlo en las claves de item.

Obligatorio: yes, si se especifica Plugins.PostgreSQL.Sessions.<SessionName>.TLSKeyFile

Plugins.PostgreSQL.Sessions.<SessionName>.TLSConnect

Especifica el nivel de cifrado con nombre de la sesión para las comunicaciones entre Zabbix agent 2 y las bases de datos monitorizadas.
<SessionName> - define el nombre de una sesión para usarlo en las claves de item.

Rango:
required - conectarse usando TLS como modo de transporte sin comprobaciones de identidad;
verify_ca - conectarse usando TLS y verificar el certificado;
verify_full - conectarse usando TLS, verificar el certificado y verificar que la identidad de la base de datos (CN) especificada por DBHost coincida con su certificado.

Un tipo de cifrado no definido significa una conexión sin cifrar.

Plugins.PostgreSQL.Sessions.<SessionName>.TLSKeyFile

Especifique la ruta completa del archivo que contiene la clave privada de PostgreSQL para las comunicaciones cifradas entre Zabbix agent 2 y las bases de datos supervisadas.
<SessionName> - defina el nombre de una sesión para usarlo en las claves de item.

Obligatorio: yes, si se especifica Plugins.PostgreSQL.Sessions.<SessionName>.TLSCertFile.

Plugins.PostgreSQL.Sessions.<SessionName>.Uri

Especifique la URI de la sesión con nombre para conectarse a PostgreSQL.
<SessionName> - defina el nombre de una sesión para usarlo en las claves de item.
Las credenciales incrustadas se ignorarán.
Debe coincidir con el formato de URI.
Esquemas compatibles: tcp, unix

Ejemplos:

tcp://127.0.0.1:5432
tcp://localhost
unix:/var/run/postgresql/.s.PGSQL.5432
Plugins.PostgreSQL.Sessions.<SessionName>.User

Especifique el nombre de usuario de la sesión con nombre para conectarse a PostgreSQL.
<SessionName> - defina el nombre de una sesión para usarlo en las claves de item.

Plugins.PostgreSQL.System.Path

Especifique la ruta al ejecutable del plugin de PostgreSQL.

Obligatorio: yes

Ejemplo:

Plugins.PostgreSQL.System.Path=/usr/libexec/zabbix/zabbix-agent2-plugin-postgresql
Plugins.PostgreSQL.Timeout

Establece el tiempo de espera para la ejecución de la solicitud (la duración, en segundos, que se espera a que una solicitud se complete antes de finalizarla).

Predeterminado: global timeout
Rango: 1-30

Opciones

Parameter Description
-V --version Imprime la versión del plugin y la información de la licencia.
-h --help Imprime la información de ayuda (abreviado).
-t, --test <item key> Inicia el plugin para pruebas (se ignora la configuración del plugin).

Véase también