pgBadger - log analysis
Cette page décrit la mise en oeuvre de pgBadger, un outil d'analyse des logs PostgreSQL.
Ref: pgBadger - a fast PostgreSQL log analysis report
Installation
Configuration des clusters PostgreSQL
Il faut ajuster la configuration des clusters dont on veut analyser les requêtes.
Sur chaque serveur PostgreSQL à analyser, il faut ajouter les lignes suivantes dans postgresql.conf et redémarrer le cluster PostgreSQL.
Dans Muppy, ouvrez le cluster via Databases / Databases Cluster et entrez le bloc suivant dans l'onglet postgresql.conf après avoir éventuellement ajustées les valeurs de log_min_duration_statement et track_activity_query_size
# begin PGBadger
log_statement = none # required for pgBadger
log_min_duration_statement = 0 # adjust: minimum query duration to analyze
log_checkpoints = on
log_connections = on
log_disconnections = on
log_lock_waits = on
log_temp_files = 0
log_autovacuum_min_duration = 0
log_error_verbosity = default
lc_messages='en_US.UTF-8' # pgbdager does not parse fr_FR.UTF-8
track_activity_query_size = 1MB # adjust: space reserved for textual repr of query
# PGBadger endtrack_activity_query_size consomme beaucoup de ressources et alourdit le traitement fait par pgBadger. Les valeurs sont comprises entre 100 Bytes et 1 Megabytes.
log_min_duration_statement définit un seuil de durée d'exécution (en ms) au delà duquel les requêtes sont loggés. Par exemple, avec log_min_duration_statement = 300 seules les requêtes dont la durée d'execution dépasse 300 ms sont loggées. Commencez avec une valeur haute (eg. 2000) et descendez progressivement.
Installation de pgBagder
pgBadger est un programme perl qui s’installe à partir des sources.
Perl est installé en standard sous Ubuntu. Il est possible d’utiliser pgBadger sans rien installer.
pgBadger peut être installé en local sur un poste de travail (linux est recommandé) ou un serveur.
Procédure
Connecté en tant que ubuntu:
Utilisation de pgBadger
pgBdger peut être utilisée en local ou remote (via ssh).
Les performances ne sont pas bien différentes entre le mode local et le remote.
En local dans le serveur
Le fichier out.html contient le résultat de l’analyse.
A distance via une connexion SSH
Dans ce mode, un pgBdager local traite le log d’un serveur postgresql auquel il se connecte via une connexion SSH.
Step 1 : Check connectivity
pgbadger doit pouvoir se connecter en SSH sans mot de passe !
Step 2 : génération du rapport à distance
Attention le // après le port est nécessaire
Consultation du rapport d’analyse
pgBadger a produit un fichier out.html qui contient toutes les données.
Rapport généré à distance
Il faut ouvrir le fichier out.html dans un navigateur pour le consulter.
Rapport généré dans un serveur distant.
Dans le cas où le rapport a été généré dans un serveur, 2 options sont disponibles:
Copier le fichier en local, via scp puis ouvrir le fichier
monter un serveur web temporaire pour la durée de la consultation
Monter un serveur http temporaire
Les lignes suivantes montre comment générer le rapport isolé dans un dossier pour le publier en http.
Last updated