Installez & configurez NRDOT pour le monitoring de PostgreSQL avec Ansible

Vous pouvez installer et configurer le Collector NRDOT pour le monitoring de PostgreSQL à l’aide du rôle Ansible newrelic.newrelic_install. Le rôle installe le collecteur, crée le rôle de monitoring et ses privilèges, et configure le collecteur en un seul play.

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.
Ansible Core 2.13 ou 2.14, Python 3.10, et les collections ansible.windows et ansible.utils.
Un hôte collecteur Linux exécutant Debian/Ubuntu ou RHEL/CentOS.
pg_stat_statements doit être chargé via shared_preload_libraries, ce qui nécessite un redémarrage de la base de données. Mettez en place les prérequis au niveau du serveur avant d’exécuter le playbook.
Pour PostgreSQL auto-hébergé : un accès administratif à votre serveur PostgreSQL (le superutilisateur postgres ou équivalent), avec un mot de passe défini et pg_hba.conf permettant l’authentification de l’hôte par mot de passe.
Pour PostgreSQL ou Aurora sur AWS RDS : connectivité réseau depuis l'hôte du collecteur vers le point de terminaison RDS, et le nom d'utilisateur principal et le mot de passe 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é.

Installez le rôle

bash

$ansible-galaxy install newrelic.newrelic_install

Assurez-vous que les collections requises sont également installées :

bash

$ansible-galaxy collection install ansible.windows ansible.utils

Configurez le playbook

Ce rôle monitore une ou plusieurs instances PostgreSQL à partir d’un seul collecteur. Au lieu d’un seul ensemble hôte/port/identifiants, il lit deux fichiers qui doivent déjà exister sur l’hôte cible : 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é pour correspondre. Consultez la page CLI install pour connaître les formats de fichiers exacts.

Créez un fichier nommé playbook.yml et copiez-y le contenu suivant. Définissez targets sur postgresql-otel et remplacez les valeurs des espaces réservés par les vôtres :

- name: Install New Relic NRDOT for PostgreSQL
  hosts: all
  roles:
    - role: newrelic.newrelic_install
  vars:
    targets:
      - postgresql-otel
  environment:
    NEW_RELIC_API_KEY: <API key>
    NEW_RELIC_ACCOUNT_ID: <Account ID>
    NEW_RELIC_REGION: <Region>
    NR_CLI_POSTGRES_CONFIG_PRESET: <1 Basic, 2 Advanced, default 1>
    NR_CLI_POSTGRES_INSTANCES_FILE: <path to the instances YAML file on the target host>
    NR_CLI_POSTGRES_SECRETS_FILE: <path to the secrets file (KEY=VALUE per instance) on the target host>
    NR_CLI_POSTGRES_ENABLE_EXPLAIN_HELPER: <y or N, default N; PREVIEW feature, see table below>

Important

Le rôle 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 :

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 d’exécuter le playbook.

Conseil

Pour activer le logging de débogage, ajoutez verbosity: "debug" sous vars dans le playbook.

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 de l'instance, déjà présent sur l'hôte cible.	Aucun
`NR_CLI_POSTGRES_SECRETS_FILE`	Obligatoire. Chemin d’accès au fichier de secrets ( `KEY=VALUE` , une paire identifiant / mot de passe superutilisateur par instance), déjà présent sur l’hôte cible.	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 répertoriée) est ignorée avec une raison dans le log plutôt que d’annuler toute l’installation.

Ce rôle monitore un ou plusieurs points de terminaison RDS PostgreSQL ou Aurora à partir d’un seul collecteur, en utilisant le même modèle de fichier d’instances / fichier de secrets que la version auto-hébergée (les deux fichiers doivent déjà exister sur l’hôte cible). Créez un fichier nommé playbook.yml et copiez-y le contenu suivant. Définissez targets sur postgresql-otel-rds et remplacez les valeurs des espaces réservés par les vôtres :

- name: Install New Relic NRDOT for PostgreSQL on RDS
  hosts: all
  roles:
    - role: newrelic.newrelic_install
  vars:
    targets:
      - postgresql-otel-rds
  environment:
    NEW_RELIC_API_KEY: <API key>
    NEW_RELIC_ACCOUNT_ID: <Account ID>
    NEW_RELIC_REGION: <Region>
    NR_CLI_POSTGRES_CONFIG_PRESET: <1 Basic, 2 Advanced, default 1>
    NR_CLI_POSTGRES_INSTANCES_FILE: <path to the instances YAML file on the target host, using RDS or Aurora endpoints as host>
    NR_CLI_POSTGRES_SECRETS_FILE: <path to the secrets file (KEY=VALUE per instance) on the target host>
    NR_CLI_POSTGRES_ENABLE_EXPLAIN_HELPER: <y or N, default N; PREVIEW feature, see table below>

Conseil

Pour activer le logging de débogage, ajoutez verbosity: "debug" sous vars dans le playbook.

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 des instances, utilisant des points de terminaison RDS ou Aurora comme `host` , déjà présent sur l’hôte cible.	Aucun
`NR_CLI_POSTGRES_SECRETS_FILE`	Obligatoire. Chemin d’accès au fichier de secrets ( `KEY=VALUE` , une paire nom d’utilisateur / mot de passe maître RDS par instance), déjà présent sur l’hôte cible.	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.

Exécutez le playbook

bash

$ansible-playbook -i <inventory_file> <playbook_file>.yml

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.

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 la CLI

Découvrez comment installer et configurer le monitoring de PostgreSQL avec une seule commande CLI New Relic.

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.

Cette traduction automatique est fournie pour votre commodité.

Installez & configurez NRDOT pour le monitoring de PostgreSQL avec Ansible

Installation guidée

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

Installez le rôle

Configurez le playbook

PostgreSQL ou Aurora sur AWS RDS

Exécutez le playbook

Trouvez et utilisez vos données

Documentation associée

Introduction au monitoring de PostgreSQL avec NRDOT

Installation via la CLI

Installation via Chef

Installation du chart Helm

Prérequis