Ajustes de configuración de la integración de PostgreSQL

Esta integración es software de código abierto. Eso significa que puedes explorar su código fuente y enviar mejoras, o crear tu propia bifurcación y compilarla.

Configuración de instancia de PostgreSQL

La integración PostgreSQL recopila información tanto métrica (M) como de inventario (I). La columna Applies To en la siguiente tabla indica qué configuraciones se pueden usar para cada colección específica:

Configuración	Descripción	Se aplica a
`HOSTNAME`	El nombre de host para la conexión PostgreSQL. El valor predeterminado es localhost.	M/I
`PORT`	El puerto donde se ejecuta PostgreSQL. El valor predeterminado es 5432.	M/I
`USERNAME`	El nombre de usuario para la conexión PostgreSQL. Required.	M/I
`PASSWORD`	La contraseña para la conexión PostgreSQL. Required.	M/I
`COLLECTION_LIST`	Matriz JSON, un objeto JSON o la cadena literal `ALL` que especifica la entidad que se va a recopilar. El usuario de PostgreSQL solo puede recopilar tablas e índices métricos de tablas para las que tiene `SELECT` permisos. Obligatorio, excepto `PgBouncer`. Importante Esto no se aplica a la consulta personalizada configurada con `CUSTOM_METRICS_QUERY` o `CUSTOM_METRICS_CONFIG`. Para obtener ayuda, consulte estos ejemplos.	M
`COLLECTION_IGNORE_DATABASE_LIST`	Matriz JSON de nombres de base de datos que se ignorarán para la recopilación métrica. Normalmente es útil para casos en los que `COLLECTION_LIST` está establecido en `ALL` y es necesario ignorar alguna base de datos. El valor predeterminado es `[]`. Importante Esto no se aplica a la consulta personalizada configurada con `CUSTOM_METRICS_QUERY` o `CUSTOM_METRICS_CONFIG`.	M
`PGBOUNCER`	Recoge `pgbouncer` métrica. El valor predeterminado es `false`.	M
`ENABLE_SSL`	Determina si SSL está habilitado. Si se requieren `true`, `ssl_cert_location` y `ssl_key_location` . El valor predeterminado es `false`.	M/I
`TRUST_SERVER_CERTIFICATE`	Si es `true`, el certificado del servidor no se verifica para SSL. Si `false`, se verifica el certificado del servidor identificado en `ssl_root_cert_location` . El valor predeterminado es `false`.	M/I
`SSL_ROOT_CERT_LOCATION`	Ruta absoluta al archivo de certificado raíz codificado en PEM. Obligatorio si `trust_server_certificate` es `false`.	M/I
`SSL_CERT_LOCATION`	Ruta absoluta al archivo de certificado de cliente codificado en PEM. Obligatorio si `enable_ssl` es `true`.	M/I
`SSL_KEY_LOCATION`	Ruta absoluta al archivo de clave de cliente codificado en PEM. Obligatorio si `enable_ssl` es `true`.	M/I
`TIMEOUT`	Espera máxima de conexión, en segundos. Establezca en `0` para que no haya tiempo de espera. El valor predeterminado es 10.	M/I
`DATABASE`	La base de datos PostgreSQL a la que conectarse. El valor predeterminado es `postgres`.	M/I
`CUSTOM_METRICS_QUERY`	La consulta SQL que requiere `columns metric_name`, `metric_type` y `metric_value.metric_type` puede ser `gauge`, `rate`, `delta` o `attribute`. Las columnas adicionales recopiladas con la consulta se agregan al conjunto métrico como atributo.	M
`CUSTOM_METRICS_CONFIG`	Una ruta a un archivo YAML con una lista de consultas personalizadas, junto con su tipo de métrica, base de datos y anulaciones de nombres de muestra. Vea los ejemplos para más detalles.	M
`COLLECT_DB_LOCK_METRICS`	Habilite la recopilación de datos base de bloqueo métrico, que puede ser intensivo en rendimiento. El valor predeterminado es `false`.	M
`COLLECT_BLOAT_METRICS`	Habilite el aumento del espacio de tabla métrica, lo que puede requerir un alto rendimiento. El valor predeterminado es `true`.	M
`METRICS`	Establezca en `true` para habilitar la recopilación solo métrica. El valor predeterminado es `false`.
`INVENTORY`	Configúrelo en `true` para habilitar la recopilación solo de inventario. El valor predeterminado es `false`.

Los valores para estas configuraciones se pueden definir de varias maneras:

Agregando el valor directamente en el archivo de configuración. Esta es la forma más común.
Reemplazar los valores de las variables de entorno usando la notación {{ }} . Lea más sobre el uso de transferencias de variables de entorno con integración en el host o vea el ejemplo para el reemplazo de variables de entorno.
Importante
Esto requiere el agente de infraestructura v1.14.0+.
Utilizando la gestión de secretos. Utilícelo para proteger información confidencial, como contraseñas que quedarían expuestas en texto sin formato en el archivo de configuración. Para obtener más información, consulte gestión de secretos.

Etiquetas y atributos personalizados

Las variables de entorno se pueden utilizar para controlar los ajustes de configuración, como su , y luego se pasan al agente de infraestructura. Para obtener instrucciones sobre cómo utilizar esta característica, consulte Configurar el agente de infraestructura.

Puedes decorar aún más tu métrica usando etiquetas. Las etiquetas le permiten agregar valor de pares principales de atributos a su métrica que luego puede usar para consultar, filtrar o agrupar su métrica.

Nuestro archivo de configuración de muestra predeterminado incluye ejemplos de etiquetas pero, como no son obligatorias, puede eliminar, modificar o agregar nuevas de su elección:

labels:
   env: production
   role: postgresql

Datos de inventario

La integración de PostgreSQL recopila cada configuración de pg_settings junto con sus boot_val y reset_val. Los datos de infraestructura de inventario aparecen en la página Inventario, bajo la fuente config/postgresql .

Resolución de problemas

A continuación se ofrecen algunos consejos para la resolución de problemas de la integración de PostgreSQL:

Si tiene problemas de conexión, asegúrese de poder conectarse al clúster desde el mismo cuadro con psql.
Si tienes problemas para recolectar PgBouncer métrica, asegúrate de estar conectado a la instancia a través de PgBouncer. El puerto predeterminado es 6432.
Si recibe el mensaje de error Error creating list of entities to collect: pq: unsupported startup parameter: extra_float_digits, configure ignore_startup_parameters = extra_float_digits en el archivo de configuración PgBouncer .

Te ofrecemos esta traducción automática para facilitar la lectura.

Ajustes de configuración de la integración de PostgreSQL

Configuración de instancia de PostgreSQL .css-21sua1{background:none;border:none;width:0;padding:0;}

Importante

Importante

Importante

Etiquetas y atributos personalizados

Datos de inventario

Resolución de problemas

Configuración de instancia de PostgreSQL