Instalar y configurar NRDOT para el monitoreo de PostgreSQL con AWS RDS

Configure el monitoreo de PostgreSQL mediante el NRDOT Collector para instancias de AWS RDS PostgreSQL. Los entornos de RDS tienen consideraciones específicas para las extensiones y los grupos de parámetros.

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

Antes de instalar, asegúrese de tener:

PostgreSQL 14 y superior
Una clave de licencia de New Relic.
Conectividad de red entre el host donde instala NRDOT Collector y su instancia de RDS PostgreSQL.
Conectividad de red a la documentación de los extremos OTLP de New Relic
Credenciales del usuario maestro de RDS.
Para conocer las versiones de PostgreSQL compatibles, los permisos requeridos y los parámetros de servidor recomendados, consulte Compatibilidad y requisitos previos.

Configurar NRDOT Collector

Instale el NRDOT Collector en un sistema que pueda conectarse a su instancia de RDS:

Para sistemas Debian/Ubuntu, ejecute:

bash

$NRDOT_VERSION=$(curl -s https://api.github.com/repos/newrelic/nrdot-collector-releases/releases/latest | grep '"tag_name":' | awk -F'"' '{print $4}') && curl -L "https://github.com/newrelic/nrdot-collector-releases/releases/download/${NRDOT_VERSION}/nrdot-collector_${NRDOT_VERSION}_linux_amd64.deb" --output nrdot-collector.deb && sudo dpkg -i nrdot-collector.deb

Para sistemas RHEL/CentOS/OEL, ejecute:

bash

$NRDOT_VERSION=$(curl -s https://api.github.com/repos/newrelic/nrdot-collector-releases/releases/latest | grep '"tag_name":' | awk -F'"' '{print $4}') && curl -L "https://github.com/newrelic/nrdot-collector-releases/releases/download/${NRDOT_VERSION}/nrdot-collector_${NRDOT_VERSION}_linux_x86_64.rpm" --output nrdot-collector.rpm && sudo rpm -ivh nrdot-collector.rpm

Para sistemas Debian/Ubuntu, ejecute:

bash

$NRDOT_VERSION=$(curl -s https://api.github.com/repos/newrelic/nrdot-collector-releases/releases/latest | grep '"tag_name":' | awk -F'"' '{print $4}') && curl -L "https://github.com/newrelic/nrdot-collector-releases/releases/download/${NRDOT_VERSION}/nrdot-collector_${NRDOT_VERSION}_linux_arm64.deb" --output nrdot-collector.deb && sudo dpkg -i nrdot-collector.deb

Para sistemas RHEL/CentOS/OEL, ejecute:

bash

$NRDOT_VERSION=$(curl -s https://api.github.com/repos/newrelic/nrdot-collector-releases/releases/latest | grep '"tag_name":' | awk -F'"' '{print $4}') && curl -L "https://github.com/newrelic/nrdot-collector-releases/releases/download/${NRDOT_VERSION}/nrdot-collector_${NRDOT_VERSION}_linux_aarch64.rpm" --output nrdot-collector.rpm && sudo rpm -ivh nrdot-collector.rpm

Configurar el usuario y los permisos de la base de datos

Cree un usuario de monitoreo con los privilegios necesarios para su instancia de PostgreSQL RDS.

Para crear el usuario de monitoreo y los permisos:

Conéctese a su instancia de RDS como usuario maestro:

bash

$psql --host=<YOUR_RDS_ENDPOINT> --dbname=postgres --port=5432 --username=<YOUR_MASTER_USERNAME>

Cree el usuario de monitoreo:

CREATE USER <YOUR_DB_USERNAME> WITH LOGIN PASSWORD '<YOUR_DB_PASSWORD>';

Otorgar la membresía del rol de usuario de monitoreo según sea necesario:

Si usa PostgreSQL 15 o superior, asigne el rol para heredar privilegios:

ALTER ROLE <YOUR_DB_USERNAME> INHERIT;

Sugerencia

Si usa PostgreSQL 14, el usuario de monitoreo hereda los privilegios por defecto, por lo que puede omitir este paso.

Cree el siguiente esquema y permisos en cada base de datos que desee monitorear:

CREATE SCHEMA IF NOT EXISTS otel;
      GRANT USAGE ON SCHEMA otel TO <YOUR_DB_USERNAME>;
      GRANT USAGE ON SCHEMA public TO <YOUR_DB_USERNAME>;
      GRANT SELECT ON ALL TABLES IN SCHEMA public TO <YOUR_DB_USERNAME>;
      GRANT pg_monitor TO <YOUR_DB_USERNAME>;
      CREATE EXTENSION IF NOT EXISTS pg_stat_statements;

(Opcional) Para recopilar métricas de vectores, cree la extensión pgvector en cada base de datos:

CREATE EXTENSION IF NOT EXISTS vector;

Las funciones de distancia l1, hamming y jaccard requieren la versión 0.7.0 o superior de pgvector.

(Opcional) Para verificar la conexión y los permisos, ejecute:

bash

$psql --username=<YOUR_DB_USERNAME> --host=<YOUR_RDS_ENDPOINT> --port=5432 --dbname=<YOUR_DATABASE_NAME> --command '\conninfo'
$      psql --username=<YOUR_DB_USERNAME> --host=<YOUR_RDS_ENDPOINT> --port=5432 --dbname=<YOUR_DATABASE_NAME> \
>        -c "SELECT * FROM pg_stat_database LIMIT 1;" && echo "pg_stat_database OK"
>      psql --username=<YOUR_DB_USERNAME> --host=<YOUR_RDS_ENDPOINT> --port=5432 --dbname=<YOUR_DATABASE_NAME> \
>        -c "SELECT * FROM pg_stat_activity LIMIT 1;" && echo "pg_stat_activity OK"
>      psql --username=<YOUR_DB_USERNAME> --host=<YOUR_RDS_ENDPOINT> --port=5432 --dbname=<YOUR_DATABASE_NAME> \
>        -c "SELECT * FROM pg_stat_statements LIMIT 1;" && echo "pg_stat_statements OK"

Si cada comando se completa sin errores, el usuario de monitoreo, el host y el puerto son correctos.

Configurar el Colector NRDOT

Configure el NRDOT Collector con los ajustes específicos de RDS PostgreSQL.

Esta configuración se centra en el monitoreo esencial de PostgreSQL solo con el receptor nrpostgresql.

configuración completa

Esta configuración de línea de base captura métricas esenciales. Para ver el catálogo completo de métricas, consulte la referencia de configuración.

Cree un archivo de configuración llamado postgresql-config.yaml:

bash

$sudo nano /etc/nrdot-collector/postgresql-config.yaml

Agregue la siguiente configuración al archivo postgresql-config.yaml que creó en el paso anterior.

Extremo de PostgreSQL RDS

Puerto de PostgreSQL

Nombre de usuario de la base de datos

Contraseña de la base de datos

Nombre de la base de datos

Extremo OTLP de New Relic

Clave de licencia de New Relic

postgresql-config.yaml

1
receivers:
2
nrpostgresql:
3
  endpoint: "mydb-instance.xxxxxxxxxxxx.us-east-1.rds.amazonaws.com:5432"
4
  username: "newrelic"
5
  password: "YOUR_PASSWORD"
6
databases:
7
   - YOUR_DATABASE_NAME
8
  # top_query/query_sample scan pg_stat_statements/pg_stat_activity cluster-wide
9
  # regardless of the databases list above; on RDS/Aurora, exclude reserved
10
  # databases the monitoring user can never reach.
11
exclude_databases:
12
   - rdsadmin
13
  collection_interval: 15s
14
events:
15
   db.server.top_query:
16
     enabled: true
17
   db.server.query_sample:
18
     enabled: true
19
   db.server.query_plan:
20
     enabled: true
21
top_query_collection:
22
   max_rows_per_query: 1000
23
   top_n_query: 200
24
   collection_interval: 60s
25
   allowed_comment_keys: [nr_service_guid]
26
query_sample_collection:
27
   max_rows_per_query: 1000
28
   allowed_comment_keys: [nr_service_guid]
29
resource_attributes:
30
   db.system.version:
31
     enabled: true
32
  # Metrics needed for the out-of-the-box dashboard but disabled by default:
33
  # see "Available metrics" below for the full default-on/default-off breakdown.
34
metrics:
35
   postgresql.database.locks:
36
     enabled: true
37
   postgresql.deadlocks:
38
     enabled: true
39
   postgresql.function.calls:
40
     enabled: true
41
   postgresql.query.conflicts:
42
     enabled: true
43
   postgresql.sequential_scans:
44
     enabled: true
45
   postgresql.temp.io:
46
     enabled: true
47
   postgresql.temp_files:
48
     enabled: true
49
processors:
50
batch:
51
  batch/metrics:
52
  send_batch_size: 8192
53
  send_batch_max_size: 8192
54
  timeout: 10s
55
exporters:
56
  otlp/newrelic:
57
  endpoint: "https://otlp.nr-data.net:4318"
58
headers:
59
   api-key: "YOUR_LICENSE_KEY"
60
  compression: gzip
61
sending_queue:
62
   enabled: true
63
   sizer: bytes
64
   queue_size: 100_000_000
65
   num_consumers: 10
66
   batch:
67
     sizer: bytes
68
     max_size: 1_000_000
69
     min_size: 0
70
     flush_timeout: 5s
71
retry_on_failure:
72
   enabled: true
73
   initial_interval: 5s
74
   max_interval: 30s
75
   max_elapsed_time: 300s
76
service:
77
telemetry:
78
metrics:
79
   level: none
80
pipelines:
81
metrics:
82
   receivers: [nrpostgresql]
83
   processors: [batch/metrics]
84
   exporters: [otlp/newrelic]
85
logs:
86
   receivers: [nrpostgresql]
87
   processors: [batch]
88
   exporters: [otlp/newrelic]

Parámetro de configuración

La siguiente tabla describe los parámetros de configuración clave para el receptor nrpostgresql:

Parámetro	Descripción
`<YOUR_RDS_ENDPOINT>`	Ingrese el nombre de host del extremo de su instancia RDS.
`<YOUR_DB_PORT>`	Ingrese el puerto de su base de datos PostgreSQL.
`<YOUR_DB_USERNAME>`	Ingrese su nombre de usuario de la base de datos.
`<YOUR_DB_PASSWORD>`	Ingrese la contraseña de su base de datos.
`<YOUR_DATABASE_NAME>`	Ingrese el nombre de la base de datos que desea monitorear.
`databases`	Lista de bases de datos para las que se recopilan estadísticas. Predeterminado: `[]` (todas las bases de datos que no son plantillas). Solo se aplica a las métricas. Las muestras de consultas y las consultas principales ignoran esta lista y se filtran únicamente por `exclude_databases`.
`exclude_databases`	Bases de datos excluidas de las estadísticas, muestras de consultas y consultas principales. Predeterminado: `[]`. Utilice esto para las bases de datos internas de servicios administrados (como `rdsadmin`) a las que su usuario de monitoreo no puede acceder.
`<YOUR_NEWRELIC_OTLP_ENDPOINT>`	Ingrese el extremo OTLP de New Relic. Para obtener más información, consulte Extremos OTLP de New Relic.
`<YOUR_NEWRELIC_LICENSE_KEY>`	Ingrese su clave de licencia de New Relic.
`collection_interval`	Ingrese el intervalo entre los raspados de métricas. Predeterminado: `15s`.

Sugerencia

Tú también puedes:

Configurar múltiples receptores: para monitorear múltiples instancias de PostgreSQL desde un recolector. Vincule su base de datos PostgreSQL con APM: para correlacionar el rendimiento de la aplicación con las operaciones de la base de datos. Esto le permite ver exactamente qué aplicaciones están generando cargas de trabajo de base de datos específicas. Planes de consulta para sentencias de escritura: para recopilar planes de consulta para sentencias de bloqueo o escritura sin otorgar acceso de escritura al usuario de monitoreo. Configurar la gestión de secretos: para administrar de forma segura información confidencial, como las credenciales de bases de datos. Esto ayuda a mejorar la seguridad de su configuración de monitoreo al evitar la codificación rígida de datos sensibles en los archivos de configuración.

Valide la configuración de NRDOT Collector

Actualice la ruta de configuración para que apunte a su nuevo archivo postgresql-config.yaml:

bash

$sudo sed -i 's|OTELCOL_OPTIONS="--config=/etc/nrdot-collector/config.yaml"|OTELCOL_OPTIONS="--config=/etc/nrdot-collector/postgresql-config.yaml"|' /etc/nrdot-collector/nrdot-collector.conf

Valide la configuración del NRDOT Collector para asegurarse de que tenga el formato correcto y funcione correctamente:

bash

$sudo /usr/bin/nrdot-collector validate --config=/etc/nrdot-collector/postgresql-config.yaml

Reiniciar NRDOT Collector

Después de configurar el recolector, reinicie el servicio NRDOT Collector para aplicar los cambios:

bash

$sudo systemctl restart nrdot-collector

Para verificar que el recolector se esté ejecutando correctamente, verifique el estado del servicio:

bash

$sudo systemctl status nrdot-collector

Sugerencia

Reinicie siempre el NRDOT Collector después de realizar cambios de configuración para garantizar que los nuevos ajustes surtan efecto.

Encuentra y utiliza tus datos

Las muestras de consulta y las consultas principales llegan como log de evento (event.name = 'db.server.query_sample' / 'db.server.top_query', db.system.name = 'postgresql'). Las métricas llegan bajo el namespace postgresql.*.

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

Vaya a https://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 RDS PostgreSQL de la lista de entidades.

Instrumentación en entornos autohospedados

Aprenda a configurar el monitoreo de PostgreSQL en entornos autohospedados con New Relic.

Referencia de métricas

Obtenga información sobre las métricas disponibles recopiladas por NRDOT Collector.

Guía de solución de problemas

Aprenda a solucionar problemas comunes con el monitoreo de PostgreSQL.

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

Instalar y configurar NRDOT para el monitoreo de PostgreSQL con AWS RDS

Instalación guiada

Requisitos previos

Configurar NRDOT Collector

Para la arquitectura AMD64

Para la arquitectura ARM64

Configurar el usuario y los permisos de la base de datos

Sugerencia

Configurar el Colector NRDOT

configuración completa

Parámetro de configuración

Sugerencia

Valide la configuración de NRDOT Collector

Reiniciar NRDOT Collector

Sugerencia

Encuentra y utiliza tus datos

Instrumentación en entornos autohospedados

Referencia de métricas

Guía de solución de problemas

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

Instalar y configurar NRDOT para el monitoreo de PostgreSQL con AWS RDS

Instalación guiada

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

Configurar NRDOT Collector

Para la arquitectura ARM64

Configurar el usuario y los permisos de la base de datos

Sugerencia

Configurar el Colector NRDOT

configuración completa

Parámetro de configuración

Sugerencia

Valide la configuración de NRDOT Collector

Reiniciar NRDOT Collector

Sugerencia

Encuentra y utiliza tus datos

Documentación relacionada

Instrumentación en entornos autohospedados

Referencia de métricas

Guía de solución de problemas

Requisitos previos