Instalar y configurar NRDOT para el monitoreo de PostgreSQL con Chef

Puede instalar y configurar el NRDOT Collector para el monitoreo de PostgreSQL usando el cookbook de Chef newrelic-install. El cookbook instala el recolector, crea el rol de monitoreo y sus permisos, y configura el recolector cuando ejecuta la receta newrelic-install::default.

Instalación guiada

Para instalar a través de la UI de New Relic en su lugar, vaya a one.newrelic.com > Integrations & Agents > PostgreSQL (Database 360). Esta página solo cubre la instalación manual.

Requisitos previos

Una cuenta de New Relic con una clave de licencia válida.
Un ID de cuenta de New Relic.
PostgreSQL 14 o posterior.
Chef 15 o posterior.
Un host recolector de Linux que ejecuta Debian/Ubuntu o RHEL/CentOS.
pg_stat_statements debe cargarse a través de shared_preload_libraries, lo que requiere un reinicio de la base de datos. Cumpla con los requisitos previos a nivel de servidor antes de ejecutar la receta.
Para PostgreSQL autohospedado: acceso administrativo al servidor de PostgreSQL (el superusuario postgres o equivalente), con una contraseña configurada y pg_hba.conf que permita la autenticación de host basada en contraseña.
Para PostgreSQL o Aurora en AWS RDS: conectividad de red desde el host del recolector hasta el extremo de RDS, y el nombre de usuario y la contraseña maestros de RDS.
Conectividad de red al extremo OTLP de New Relic para su región.
Para conocer los requisitos detallados, consulte Compatibilidad.

Descargar el cookbook de Chef

Descargue el cookbook de Chef newrelic-install desde Chef Supermarket al directorio del repositorio de Chef:

bash

$knife supermarket install newrelic-install

Reemplace los atributos predeterminados

Reemplace los atributos predeterminados en attributes/default.rb con los detalles de la cuenta:

Este cookbook monitorea una o más instancias de PostgreSQL desde un solo recolector. En lugar de un solo conjunto de host/puerto/credencial, lee dos archivos que ya deben existir en el nodo: un archivo de instancias (YAML) que enumera cada instancia que se va a monitorear y las bases de datos que se van a monitorear en cada una, y un archivo de secretos (KEY=VALUE) con un inicio de sesión y contraseña de superusuario para cada una, indexados para que coincidan. Consulte la página de instalación de la CLI para conocer los formatos de archivo exactos.

default['newrelic_install']['NEW_RELIC_API_KEY']    = <API key>
default['newrelic_install']['NEW_RELIC_ACCOUNT_ID'] = <Account ID>
default['newrelic_install']['NEW_RELIC_REGION']     = <Region>
default['newrelic_install']['targets'] = [
  'nrdot-collector-postgresql'
]
default['newrelic_install']['env']['NR_CLI_POSTGRES_CONFIG_PRESET']         = <1 Basic, 2 Advanced, default 1>
default['newrelic_install']['env']['NR_CLI_POSTGRES_INSTANCES_FILE']        = <path to the instances YAML file on the node>
default['newrelic_install']['env']['NR_CLI_POSTGRES_SECRETS_FILE']          = <path to the secrets file (KEY=VALUE per instance) on the node>
default['newrelic_install']['env']['NR_CLI_POSTGRES_ENABLE_EXPLAIN_HELPER'] = <y or N, default N; PREVIEW feature, see table below>
# See all available targets at: https://github.com/newrelic/chef-install

Importante

El cookbook se conecta a PostgreSQL a través de TCP mediante una contraseña, por lo que el superusuario de cada instancia debe tener una contraseña configurada y pg_hba.conf debe permitir la autenticación de host basada en contraseña (md5 o scram-sha-256) para las conexiones TCP:

bash

$sudo -u postgres psql -c "ALTER USER postgres WITH PASSWORD '<password>';"

Atributo (bajo `env` )	Descripción	Por defecto
`NR_CLI_POSTGRES_CONFIG_PRESET`	Configuración de NRDOT: `1` básica, `2` avanzada.	`1`
`NR_CLI_POSTGRES_INSTANCES_FILE`	Requerido. Ruta al archivo YAML de instancias, ya presente en el nodo.	Ninguno
`NR_CLI_POSTGRES_SECRETS_FILE`	Requerido. Ruta al archivo de secretos ( `KEY=VALUE` , un par de inicio de sesión/contraseña de superusuario por instancia), ya presente en el nodo.	Ninguno
`NR_CLI_POSTGRES_ENABLE_EXPLAIN_HELPER`	Recopile planes de consulta para declaraciones de bloqueo/escritura también. Crea una función auxiliar `SECURITY DEFINER` ( `otel.explain_statement` ) en cada base de datos monitoreada, otorgando al usuario de monitoreo `EXPLAIN` la ejecución sin otorgar acceso DML. Esta es una característica de VISTA PREVIA. `y` / `N` .	`n`

Sugerencia

No se incluyen valores de atributo predeterminados para estas variables. Establezca explícitamente los que sean relevantes para su objetivo mediante default['newrelic_install']['env'][...].

Sugerencia

Para monitorear más de una instancia de PostgreSQL desde este recolector, agregue más entradas al archivo de instancias y credenciales numeradas coincidentes (_2, _3...) al archivo de secretos. Una instancia que no pasa sus comprobaciones (o que no tiene bases de datos enumeradas) se omite con un motivo registrado en lugar de cancelar toda la instalación.

Este cookbook monitorea uno o más extremos de RDS PostgreSQL o Aurora desde un solo recolector, utilizando el mismo patrón de archivo de instancias/archivo de secretos que el autohospedado (ambos archivos ya deben existir en el nodo).

default['newrelic_install']['NEW_RELIC_API_KEY']    = <API key>
default['newrelic_install']['NEW_RELIC_ACCOUNT_ID'] = <Account ID>
default['newrelic_install']['NEW_RELIC_REGION']     = <Region>
default['newrelic_install']['targets'] = [
  'nrdot-collector-postgresql-rds'
]
default['newrelic_install']['env']['NR_CLI_POSTGRES_CONFIG_PRESET']         = <1 Basic, 2 Advanced, default 1>
default['newrelic_install']['env']['NR_CLI_POSTGRES_INSTANCES_FILE']        = <path to the instances YAML file on the node, using RDS or Aurora endpoints as host>
default['newrelic_install']['env']['NR_CLI_POSTGRES_SECRETS_FILE']          = <path to the secrets file (KEY=VALUE per instance) on the node>
default['newrelic_install']['env']['NR_CLI_POSTGRES_ENABLE_EXPLAIN_HELPER'] = <y or N, default N; PREVIEW feature, see table below>
# See all available targets at: https://github.com/newrelic/chef-install

Atributo (bajo `env` )	Descripción	Por defecto
`NR_CLI_POSTGRES_CONFIG_PRESET`	Configuración de NRDOT: `1` básica, `2` avanzada.	`1`
`NR_CLI_POSTGRES_INSTANCES_FILE`	Requerido. Ruta al archivo YAML de instancias, usando extremos de RDS o Aurora como `host` , ya presente en el nodo.	Ninguno
`NR_CLI_POSTGRES_SECRETS_FILE`	Requerido. Ruta al archivo de secretos ( `KEY=VALUE` , un par de nombre de usuario/contraseña maestro de RDS por instancia), ya presente en el nodo.	Ninguno
`NR_CLI_POSTGRES_ENABLE_EXPLAIN_HELPER`	Recopile planes de consulta para declaraciones de bloqueo/escritura también. Crea una función auxiliar `SECURITY DEFINER` ( `otel.explain_statement` ) en cada base de datos monitoreada, otorgando al usuario de monitoreo `EXPLAIN` la ejecución sin otorgar acceso DML. Esta es una característica de VISTA PREVIA. `y` / `N` .	`n`

Sugerencia

No se incluyen valores de atributo predeterminados para estas variables. Establezca explícitamente los que sean relevantes para su objetivo mediante default['newrelic_install']['env'][...].

Sugerencia

Para monitorear más de un extremo de RDS PostgreSQL o Aurora desde este recolector, agregue más entradas al archivo de instancias y credenciales numeradas coincidentes al archivo de secretos. Una instancia que falla sus comprobaciones (o no tiene bases de datos listadas) se omite con un motivo registrado en lugar de cancelar toda la instalación.

Cargue el cookbook de Chef

Cargue el cookbook de Chef newrelic-install en su servidor de Chef:

bash

$knife cookbook upload newrelic-install

Actualice la lista de ejecución

Agregue la receta newrelic-install a la lista de ejecución de un nodo:

"run_list": [
  "recipe[newrelic-install]"
]

Encuentra y utiliza tus datos

Una vez que sus datos se estén recopilando, puede acceder al monitoreo integral de bases de datos PostgreSQL a través de la UI de New Relic.

Para encontrar su entidad de base de datos PostgreSQL en New Relic:

Vaya a one.newrelic.com > All capabilities > Databases.
En el menú desplegable Entity type, seleccione PostgreSQL instance y luego haga clic en Apply.
Seleccione su base de datos PostgreSQL de la lista de entidades.

Introducción al monitoreo de PostgreSQL con NRDOT

Conozca todos los métodos de instalación disponibles para el monitoreo de PostgreSQL con New Relic.

Instalación de la CLI

Aprenda a instalar y configurar el monitoreo de PostgreSQL con un solo comando de la CLI de New Relic.

Instalación con Ansible

Aprenda a instalar y configurar el monitoreo de PostgreSQL a escala con el newrelic.newrelic_install rol de Ansible.

Instalación del chart de Helm

Aprenda a instalar y configurar el monitoreo de PostgreSQL en Kubernetes con el chart de Helm postgresql-otel.

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

Instalar y configurar NRDOT para el monitoreo de PostgreSQL con Chef

Instalación guiada

Requisitos previos .css-21sua1{background:none;border:none;width:0;padding:0;}

Descargar el cookbook de Chef

Reemplace los atributos predeterminados

PostgreSQL o Aurora en AWS RDS

Cargue el cookbook de Chef

Actualice la lista de ejecución

Encuentra y utiliza tus datos

Documentación relacionada

Introducción al monitoreo de PostgreSQL con NRDOT

Instalación de la CLI

Instalación con Ansible

Instalación del chart de Helm

Requisitos previos