Installez & configurez NRDOT pour le monitoring de PostgreSQL avec la CLI

Vous pouvez installer et configurer le Collector NRDOT pour le monitoring PostgreSQL à l’aide de la CLI New Relic. La CLI installe le collecteur, crée le rôle de monitoring et ses privilèges, et configure le collecteur en une seule commande.

Installation guidée

Pour installer plutôt via l’UI de New Relic, accédez à one.newrelic.com > Integrations & Agents > PostgreSQL (Database 360). Cette page traite uniquement de l’installation manuelle.

Prérequis

Un compte New Relic avec une clé de licence valide.
Un ID de compte New Relic.
PostgreSQL 14 ou version ultérieure.
Un hôte collecteur Linux exécutant Debian/Ubuntu ou RHEL/CentOS, avec curl et systemd installés, et le client psql disponible.
pg_stat_statements doit être chargé via shared_preload_libraries. Le programme d’installation vérifie cela et échoue si ce n’est pas le cas. Voir les prérequis au niveau du serveur ci-dessous.
Pour PostgreSQL auto-hébergé : accès administrateur à votre serveur PostgreSQL (le superutilisateur postgres ou équivalent).
Pour AWS RDS/Aurora PostgreSQL : connectivité réseau depuis l’hôte du collecteur vers le point de terminaison RDS (accès entrant sur le port PostgreSQL dans le groupe de sécurité RDS), et le nom d’utilisateur et le mot de passe maître RDS.
Connectivité réseau vers le point de terminaison OTLP New Relic pour votre région.
Pour connaître les prérequis détaillés, consultez la page Compatibilité.

Prérequis au niveau du serveur

pg_stat_statements ne peut pas être créé sans shared_preload_libraries, et ce paramètre nécessite un redémarrage de la base de données, la CLI ne peut donc pas le configurer pour vous. Mettez ces paramètres en place avant d’exécuter l’installation :

paramètres	Valeur
`shared_preload_libraries`	`pg_stat_statements`
`pg_stat_statements.track`	`ALL`
`pg_stat_statements.max`	`10000`
`pg_stat_statements.save`	`on`
`track_activity_query_size`	`4096`
`track_functions`	`all`

Auto-hébergé: définissez-les dans postgresql.conf, puis redémarrez PostgreSQL. Certaines distributions nécessitent que le package postgresql-contrib soit installé pour que pg_stat_statements soit disponible.
AWS RDS ou Aurora: définissez-les dans le groupe de paramètres de la base de données, et non dans un fichier de configuration. track_activity_query_size et pg_stat_statements.max sont des paramètres statiques : appliquez-les avec apply_method: pending-reboot, puis redémarrez l’instance. Pour Aurora, le nom de la famille de groupes de paramètres doit correspondre exactement à la version majeure de votre moteur, par exemple aurora-postgresql16.

Installer et configurer le NRDOT Collector

Cette recette monitore une ou plusieurs instances PostgreSQL à partir d’un seul collecteur. Au lieu de demander un seul ensemble hôte/port/identifiants, elle lit deux fichiers que vous créez à l’avance : un fichier d’instances (YAML) listant chaque instance à monitorer et les bases de données à monitorer sur chacune, et un fichier de secrets (KEY=VALUE) avec un identifiant et un mot de passe de superutilisateur pour chacune, indexés pour correspondre.

Créez le fichier d’instances. Ajoutez une entrée par instance PostgreSQL que vous souhaitez que ce collecteur monitore ; toujours une seule entrée si vous n’exécutez qu’une seule instance. Chaque instance nécessite au moins une base de données : PostgreSQL n’a pas de mode pour monitorer toutes les bases de données :
bash
```
$cat > ~/postgresql-instances.yml << 'EOF'
$instances:
$  - host: localhost
$    port: 5432
$    login_name: newrelic
$    databases: [app1, app2]
$EOF
```

Créez le fichier de secrets avec un rôle de superutilisateur (n’importe quel rôle de superutilisateur fonctionne ; il n’est pas nécessaire que ce soit postgres) et un mot de passe pour chaque instance, indexés pour correspondre à l’ordre du fichier d’instances :

bash

$umask 077
$cat > ~/postgresql-secrets.env << 'EOF'
$NR_CLI_POSTGRES_SUPERUSER_USER_1=postgres
$NR_CLI_POSTGRES_SUPERUSER_PASSWORD_1=YourSuperuserPassword1
$EOF
$chmod 600 ~/postgresql-secrets.env

bash

$curl -Ls https://download.newrelic.com/install/newrelic-cli/scripts/install.sh | bash && sudo NEW_RELIC_API_KEY=INSERT_YOUR_API_KEY NEW_RELIC_ACCOUNT_ID=INSERT_YOUR_ACCOUNT_ID NEW_RELIC_REGION=INSERT_YOUR_REGION /usr/local/bin/newrelic install -n nrdot-collector-postgresql

Important

Ce programme d’installation se connecte à PostgreSQL via TCP à l’aide d’un mot de passe, le superutilisateur de chaque instance doit donc avoir un mot de passe défini et pg_hba.conf doit autoriser l’authentification de l’hôte par mot de passe (md5 ou scram-sha-256) pour les connexions TCP. Une nouvelle installation n’a pas de mot de passe défini sur postgres par défaut. Veuillez d’abord en définir un :

bash

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

Sur RHEL/CentOS, le pg_hba.conf par défaut ne permet souvent pas du tout l’authentification de l’hôte par mot de passe. Vérifiez-le et mettez-le à jour, puis rechargez PostgreSQL avant de lancer l’installation.

La CLI affiche un prompt de manière interactive pour les variables suivantes. Vous pouvez également les définir à l’avance comme variables d’environnement pour une exécution non interactive.

Variable	Description	Défaut
`NR_CLI_POSTGRES_CONFIG_PRESET`	Configuration NRDOT : `1` basique, `2` avancée.	`1`
`NR_CLI_POSTGRES_INSTANCES_FILE`	Obligatoire. Chemin d’accès au fichier YAML de l’instance.	Aucun
`NR_CLI_POSTGRES_SECRETS_FILE`	Obligatoire. Chemin d’accès au fichier de secrets ( `KEY=VALUE` , une paire identifiant / mot de passe de superutilisateur par instance).	Aucun
`NR_CLI_POSTGRES_ENABLE_EXPLAIN_HELPER`	Collectez également les plans de requête pour les instructions de verrouillage/écriture. Crée une fonction d’assistance `SECURITY DEFINER` ( `otel.explain_statement` ) dans chaque base de données monitorée, accordant l’exécution à l’utilisateur de monitoring `EXPLAIN` sans accorder d’accès DML. Il s’agit d’une fonctionnalité en APERÇU. `y` / `N` .	`n`

Conseil

Pour monitorer plus d’une instance PostgreSQL à partir de ce collecteur, ajoutez des entrées supplémentaires au fichier d’instances et des identifiants numérotés correspondants (_2, _3,…) au fichier de secrets. Une instance qui échoue à ses vérifications (ou qui n’a aucune base de données listée) est ignorée avec une raison dans le log plutôt que d’annuler toute l’installation ; l’installation n’échoue complètement que si aucune des instances ne réussit.

Cette recette monitore un ou plusieurs points de terminaison RDS PostgreSQL ou Aurora depuis un seul collecteur, en utilisant le même modèle de fichier d’instances / fichier de secrets que pour l’auto-hébergement.

Créez le fichier d’instances, en utilisant le point de terminaison RDS ou Aurora comme host; toujours une seule entrée si vous effectuez uniquement le monitoring d’une seule instance. Chaque instance nécessite au moins une base de données : PostgreSQL n’a pas de mode pour monitorer toutes les bases de données :
bash
```
$cat > ~/postgresql-instances.yml << 'EOF'
$instances:
$  - host: mydb1.abcdefg12345.us-east-1.rds.amazonaws.com
$    port: 5432
$    login_name: newrelic
$    databases: [app1, app2]
$EOF
```

Créez le fichier de secrets avec le nom d’utilisateur et le mot de passe maître RDS pour chaque instance, indexé pour correspondre à l’ordre du fichier des instances :

bash

$umask 077
$cat > ~/postgresql-secrets.env << 'EOF'
$NR_CLI_POSTGRES_ADMIN_USER_1=postgres
$NR_CLI_POSTGRES_ADMIN_PASSWORD_1=YourMasterPassword1
$EOF
$chmod 600 ~/postgresql-secrets.env

bash

$curl -Ls https://download.newrelic.com/install/newrelic-cli/scripts/install.sh | bash && sudo NEW_RELIC_API_KEY=INSERT_YOUR_API_KEY NEW_RELIC_ACCOUNT_ID=INSERT_YOUR_ACCOUNT_ID NEW_RELIC_REGION=INSERT_YOUR_REGION /usr/local/bin/newrelic install -n nrdot-collector-postgresql-rds

La CLI affiche un prompt de manière interactive pour les variables suivantes. Vous pouvez également les définir à l’avance comme variables d’environnement pour une exécution non interactive.

Variable	Description	Défaut
`NR_CLI_POSTGRES_CONFIG_PRESET`	Configuration NRDOT : `1` basique, `2` avancée.	`1`
`NR_CLI_POSTGRES_INSTANCES_FILE`	Obligatoire. Chemin vers le fichier YAML d’instances, utilisant les points de terminaison RDS ou Aurora comme `host` .	Aucun
`NR_CLI_POSTGRES_SECRETS_FILE`	Obligatoire. Chemin vers le fichier de secrets ( `KEY=VALUE` , une paire nom d’utilisateur / mot de passe maître RDS par instance).	Aucun
`NR_CLI_POSTGRES_ENABLE_EXPLAIN_HELPER`	Collectez également les plans de requête pour les instructions de verrouillage/écriture. Crée une fonction d’assistance `SECURITY DEFINER` ( `otel.explain_statement` ) dans chaque base de données monitorée, accordant l’exécution à l’utilisateur de monitoring `EXPLAIN` sans accorder d’accès DML. Il s’agit d’une fonctionnalité en APERÇU. `y` / `N` .	`n`

Conseil

Pour monitorer plus d’un point de terminaison RDS PostgreSQL ou Aurora depuis ce collecteur, ajoutez plus d’entrées au fichier des instances, et les identifiants numérotés correspondants au fichier des secrets. Une instance qui échoue à ses vérifications (ou qui n’a aucune base de données répertoriée) est ignorée avec une raison dans le log plutôt que d’annuler toute l’installation.

Trouvez et utilisez vos données

Une fois vos données collectées, vous pouvez accéder à un monitoring complet de la base de données PostgreSQL via l'UI de New Relic.

Pour trouver votre entité de base de données PostgreSQL dans New Relic :

Allez à one.newrelic.com > All capabilities > Databases.
Dans la liste déroulante Entity type, sélectionnez PostgreSQL instance, puis cliquez sur Apply.
Sélectionnez votre base de données PostgreSQL dans la liste des entités.
Pour confirmer que les données arrivent, exécutez cette requête dans le générateur de requêtes:
```
SELECT count(*) FROM Metric
WHERE metricName LIKE 'postgresql.%'
AND instrumentation.provider = 'opentelemetry'
SINCE 10 minutes ago
```

Introduction au monitoring de PostgreSQL avec NRDOT

Découvrez toutes les méthodes d’installation disponibles pour le monitoring de PostgreSQL avec New Relic.

Installation via Ansible

Découvrez comment installer et configurer le monitoring PostgreSQL à grande échelle avec le newrelic.newrelic_install rôle Ansible.

Installation via Chef

Découvrez comment installer et configurer le monitoring PostgreSQL à grande échelle avec le cookbook Chef newrelic-install.

Installation du chart Helm

Apprenez à installer et configurer le monitoring PostgreSQL sur Kubernetes avec le chart Helm postgresql-otel.

Installation Docker

Découvrez comment exécuter le Collector NRDOT en tant que conteneur frère d’une instance PostgreSQL déjà en cours d’exécution dans Docker.

Cette traduction automatique est fournie pour votre commodité.

Installez & configurez NRDOT pour le monitoring de PostgreSQL avec la CLI

Installation guidée

Prérequis .css-21sua1{background:none;border:none;width:0;padding:0;}

Prérequis au niveau du serveur

Installer et configurer le NRDOT Collector

AWS RDS/Aurora PostgreSQL

Trouvez et utilisez vos données

Documentation associée

Introduction au monitoring de PostgreSQL avec NRDOT

Installation via Ansible

Installation via Chef

Installation du chart Helm

Installation Docker

Prérequis