Installez & configurez NRDOT pour le monitoring de PostgreSQL avec Chef

Prérequis

• Un compte New Relic avec une clé de licence valide.

• Un ID de compte New Relic.

• PostgreSQL 14 ou version ultérieure.

• Chef 15 ou version ultérieure.

• 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 la recette.

• 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é.

Télécharger le cookbook Chef

Téléchargez le newrelic-install livre de recettes Chef depuis le Chef Supermarket dans votre répertoire chef-repo :

$
knife supermarket install newrelic-install

Remplacez les attributs par défaut

Remplacez les attributs par défaut dans attributes/default.rb par les détails de votre compte :

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

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

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

Téléversez le cookbook Chef

Téléversez le cookbook Chef newrelic-install sur votre serveur Chef :

$
knife cookbook upload newrelic-install

Mettez à jour la liste d’exécution

Ajoutez la recette newrelic-install à la run list d'un nœud :

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

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 :

1. Allez à one.newrelic.com > All capabilities > Databases.
2. Dans la liste déroulante Entity type, sélectionnez PostgreSQL instance, puis cliquez sur Apply.
3. Sélectionnez votre base de données PostgreSQL dans la liste des entités.