Plug-in PostgreSQL

PostgreSQL est un système de gestion de bases de données objet-relationnelle compatible avec de nombreuses plates-formes telles que Linux, FreeBSD, Solaris, Microsoft Windows et macOS. Pour en savoir plus, consultez le site postgresql.org.

Détection

Même si le plug-in PostgreSQL n'est pas configuré, Cloud Monitoring découvre les services PostgreSQL s'exécutant dans votre projet Google Cloud en :

  • recherchant les noms d'instances correspondant à postgresql ;
  • recherchant des ports ouverts sur 5432 via des règles de pare-feu.

Les services détectés s'affichent sur la page "Services PostgreSQL" du menu Ressources. Une fois que vous avez installé l'agent de surveillance et configuré le plug-in PostgreSQL sur vos instances, Monitoring remplit la page "Services PostgreSQL" avec un inventaire et des métriques.

Configurer Monitoring pour surveiller PostgreSQL

Après avoir installé l'agent de surveillance, utilisez les instructions suivantes pour configurer le plug-in PostgreSQL sur vos instances.

Prérequis

Pour la collecte PostgreSQL, vous devez créer un utilisateur/rôle doté des privilèges minimaux permettant de se connecter à la base de données à l'aide d'un password ou de l'authentification md5. Cet utilisateur et son mot de passe sont appelés STATS_USER et STATS_PASS dans le fichier de configuration suivant. Certaines installations définissent des contrôles d'accès à l'authentification ident par défaut. Vous devez modifier votre fichier pg_hba.conf afin d'autoriser l'accès pour le rôle d'agent. En supposant que vous ayez nommé votre rôle stackdriver-agent, vous devrez peut-être ajouter l'une des lignes suivantes à votre fichier pg_hba.conf avant de redémarrer PostgreSQL :

  • Pour se connecter via des sockets de domaine Unix :

    local all stackdriver-agent md5

  • Pour se connecter via TCP/IP à localhost :

    host all stackdriver-agent 127.0.0.1/32 md5

Activer le plug-in de surveillance PostgreSQL

PostgreSQL est configuré par base de données sur votre système. Actuellement, aucune configuration prête à l'emploi n'est disponible. Le fichier de configuration suivant montre comment configurer une base de données nommée DATABASE_NAME. Cette configuration peut vous servir de modèle pour vos bases de données.

Sur votre instance de VM, téléchargez postgresql.conf à partir du dépôt de configuration GitHub et placez-le dans le répertoire /opt/stackdriver/collectd/etc/collectd.d/ :

(cd /opt/stackdriver/collectd/etc/collectd.d/ && sudo curl -O https://raw.githubusercontent.com/Stackdriver/stackdriver-agent-service-configs/master/etc/collectd.d/postgresql.conf)
    

En tant qu'utilisateur racine, modifiez le fichier de configuration téléchargé et ajoutez des informations sur vos bases de données. Les commentaires intégrés indiquent les endroits où vous devez ajouter une configuration pour des bases de données supplémentaires. Remplacez DATABASE_NAME par le nom de votre base de données.

Une fois que vous avez modifié le fichier de configuration, redémarrez l'agent de surveillance en exécutant la commande suivante :

sudo service stackdriver-agent restart
    

Pour plus d'informations sur le plug-in postgresql collectd, consultez la section Plug-in:PostgreSQL.

Métriques surveillées

La liste complète des métriques surveillées par le plug-in PostreSQL est disponible dans la section Métriques de l'agent : postgresql.