Surveillance de PostgreSQL

Les systèmes d'exploitation pris en charge par le capteur « PostgreSQL » correspondent aux exigences de l'agent hôte; vous pouvez les vérifier dans la section « Systèmes d'exploitation pris en charge » de chaque agent hôte, par exemple dans la section « Systèmes d'exploitation pris en charge » pour Unix.

Le capteur prend en charge les versions suivantes d' PostgreSQL:

• PostgreSQL 8.0.x sur 8.4.x
• PostgreSQL 9.0.x sur 9.6.x
• PostgreSQL 10.x
• PostgreSQL 11.x
• PostgreSQL 12.x
• PostgreSQL 13.x
• PostgreSQL 14.x
• PostgreSQL 15.x
• PostgreSQL 16.6
• PostgreSQL 17.2

Le tableau suivant présente la dernière version prise en charge et la politique d'assistance :

Pour plus d'informations sur la politique d'assistance, consultez la section « Stratégie d'assistance pour les capteurs ».

Pour cette technologie, Instana prend en charge le traçage côté client pour les langages et environnements d'exécution suivants :

• Java
• Node.js
• PHP
• .NET Framework
• .Net Core
• Bibliothèques et plateformes prises en charge par l' Go
• Python

La collecte des statistiques est contrôlée par les paramètres de configuration définis dans le fichier postgresql.conf , qui est créé lors de la configuration de postgresql. Pour contrôler la collecte des statistiques, définissez les paramètres suivants sur on (yes, true, et 1 sont également acceptés).

Pour localiser votre postgresql.conf fichier, exécutez la requête SQL suivante :

SHOW config_file;

Cette requête renvoie le chemin d'accès complet au postgresql.conf fichier sur votre serveur PostgreSQL.

Le tableau suivant répertorie les paramètres de configuration :

Pour plus d'informations sur la configuration de la collecte des statistiques, consultez la documentation de PostgreSQL.

Dans certains environnements, les fichiers de configuration d' PostgreSQL s ne sont pas conservés après un redémarrage. Les modifications apportées directement à postgresql.conf risquent de ne pas être conservées après le redémarrage du système. Pour s'assurer que le paramètre de collecte des statistiques reste activé après chaque redémarrage, il est recommandé d'utiliser la ALTER SYSTEM commande. Cette commande enregistre la configuration dans le postgresql.auto.conf fichier, qui se trouve dans le répertoire de données de PostgreSQL, et conserve la configuration si un volume persistant est utilisé.

Utilisez la commande suivante pour activer la collecte des statistiques :

• ALTER SYSTEM SET track_activities = 'on';
• ALTER SYSTEM SET track_counts = 'on';
• ALTER SYSTEM SET track_io_timing = 'on';

Exécutez la SELECT pg_reload_conf(); commande pour recharger la configuration. Vérifiez le paramètre en exécutant les commandes suivantes :

• SHOW track_activities;
• SHOW track_counts;
• SHOW track_io_timing;

Vous pouvez également consulter le postgresql.auto.conf fichier pour vérifier les modifications de configuration appliquées à l'aide de la ALTER SYSTEM commande. Ce fichier contient la configuration mise à jour.

Pour plus d'informations sur l'utilisation ALTER SYSTEM de la commande de configuration, consultez la documentation d' PostgreSQL.

cluster_name = 'PostgreSQL_cluster'

Pour activer la collecte de statistiques pour les conteneurs « rootless » d' PostgreSQLPodman, vous devez activer les paramètres dans le postgresql.conf fichier et mapper le port d'écoute du serveur PostgreSQL vers le même port sur l'hôte où le conteneur « rootless » d' Podman est hébergé. La redirection de ports est nécessaire pour établir une connexion et collecter les métriques requises. Enfin, définissez la clé « isRootlessPodman » sur « true » dans le fichier de configuration de l'agent.

Les droits minimaux pour la surveillance de la collecte de métriques sont SELECT sur la base de données pg_stat_database . L'exemple suivant montre comment créer un utilisateur pour les besoins de l'agent:

create user <USERNAME> with password <PASSWORD>;
grant SELECT ON pg_stat_database to <USERNAME>;
 

Pour configurer l'authentification requise lorsque le capteur se connecte à PostgreSQL, procédez comme suit :

1. Configurez les données d'identification de l'utilisateur en activant la section de configuration dans le fichier de configuration de l'agent <agent_install_dir>/etc/instana/configuration.yaml.

2. Entrez un nom d'utilisateur et un mot de passe.

   Le mot de passe est un mot de passe en texte clair.

Pour l'authentification par mot de passe, le mécanisme d'authentification de l'utilisateur PostgreSQL correspondant doit être md5, scram-sha-256 (version 10 et ultérieure) ou un mot de passe. Pour plus d'informations, consultez les sections « Authentification par mot de passe » et « Authentification du client » dans la documentation de PostgreSQL.

Pour qu'une connexion soit établie entre le capteur et PostgreSQL, PostgreSQL doit contenir une base de données dont le nom est identique à celui du nom d'utilisateur :

com.instana.plugin.postgresql:
  user: '<USERNAME>'
  password: '<PASSWORD>'
  database: '' # by default PostgreSQL will use 'user' as database to connect to.
  poll_rate: 10 #Values are in seconds. Default Value 1 Sec.
  isRootlessPodman: true/false # Optional. Use this field only if you are running postgres inside a rootless podman container. Default value is false.
 

La zone database est utilisée uniquement pour l'authentification. L'agent détecte automatiquement les modifications apportées au fichier de configuration <agent_install_dir>/etc/instana/configuration.yaml. Par conséquent, les modifications apportées à ce fichier de configuration sont rechargées à chaud (aucun redémarrage de l'agent n'est nécessaire).

Pour collecter des métriques de base de données, vous devez affecter à user le privilège CONNECT spécifié pour toutes les bases de données présentes dans l'instance PostgreSQL . L'exemple suivant montre comment accorder le privilège CONNECT à un utilisateur:

GRANT CONNECT ON DATABASE <DATABASE_NAME> TO <USERNAME>;
 

Consultez les données de configuration suivantes qui sont collectées à partir de l'instance Postgres en cours d'exécution:

• ID du processus
• Heure de début
• Port
• Version
• Rôle
• Nombre max de connexions

Les attributs de performance collectés pour chaque instance Postgres sont les suivants:

Chaque détecteur dispose d'une base de connaissances organisée de signatures de santé qui sont évaluées en continu par rapport aux métriques entrantes et qui sont utilisées pour signaler des problèmes ou des incidents qui dépendent de l'impact sur l'utilisateur.

Les événements intégrés déclenchent des problèmes ou des incidents en fonction de signatures d'intégrité défaillantes sur des entités, tandis que les événements personnalisés déclenchent des problèmes ou des incidents en fonction des seuils d'une métrique spécifique à une entité donnée.

Pour plus d'informations sur les événements générés pour le détecteur PostgreSQL , voir la référence des événements intégrés.

Type de problème de surveillance : postgresql_stats_not_enabled

Le serveur PostgreSQL est détecté, mais la collecte de statistiques n'est pas activée. Vous devez activer la collecte de statistiques. Pour plus d'informations, voir la section Activer la collecte de statistiques .

Type de problème de surveillance : postgresql_authentication_failed

L'authentification de PostgreSQL a échoué. Pour créer un utilisateur de surveillance et configurer l'agent, voir la section Créer un utilisateur de surveillance .

Type de problème de surveillance : postgresql_connection_failed

L'agent ne parvient pas à se connecter au serveur PostgreSQL . Vous devez vérifier que la connexion est établie entre l'agent et le détecteur.