Aller au contenu

Téléchargement et installation

Versions officielles, paquets, prérequis et installation à partir du code source

Choisissez un canal de distribution

Canal Utilisation Emplacement
Version officielle Archives sources et notes de version GitHub Releases
Paquet RPM Distributions Linux basées sur RPM PostgreSQL Yum Repository
Paquet Debian/Ubuntu Distributions Linux basées sur APT PostgreSQL Apt Repository
Code source de développement Code actuel non encore publié darold/pgbadger

Les exemples d’installation utilisent pgBadger 13.2. Consultez la page des versions avant de choisir une version.

Conditions requises

Le rapport HTML ne nécessite que :

  • une distribution Perl moderne ;
  • un navigateur web pour afficher les graphiques JavaScript intégrés.

Les fonctionnalités facultatives ajoutent les dépendances suivantes :

Fonctionnalité Dépendance
Analyse des journaux CSV de PostgreSQL Text::CSV_XS
Génération de sorties au format JSON JSON::XS
Lecture de fichiers .gz, .bz2, .lz4, .xz, .zip ou .zst l’utilitaire correspondant zcat, bzcat, lz4cat, xz, unzip, ou zstdcat

Installez le support JSON sur Debian ou Ubuntu :

$ sudo apt-get install libjson-xs-perl

Sur un système basé sur RPM :

$ sudo yum install perl-JSON-XS

Utilisez --zcat pour remplacer le chemin du décompresseur. Fournir une commande personnalisée désactive la possibilité d’utiliser plusieurs formats compressés dans la même invocation.

L’utilitaire xz doit prendre en charge --robot pour que pgBadger puisse lire les métadonnées de l’archive. Compressez les journaux lz4 avec --content-size afin que pgBadger puisse déterminer leur taille décompressée.

Installer à partir d’une archive officielle

Téléchargez une archive de version, puis compilez et installez le programme à l’aide de la chaîne d’outils standard de Perl :

$ tar xzf pgbadger-13.2.tar.gz
$ cd pgbadger-13.2
$ perl Makefile.PL
$ make
$ sudo make install

Le schéma par défaut site installe le programme sous le nom /usr/local/bin/pgbadger et la page de manuel sous le nom /usr/local/share/man/man1/pgbadger.1.

Pour une installation conforme aux conventions des distributions sous /usr, générez le fichier Makefile avec :

$ perl Makefile.PL INSTALLDIRS=vendor
$ make
$ sudo make install

INSTALLDIRS=perl est une autre disposition prise en charge par le projet amont. Vérifiez les chemins générés avant d’installer dans un système géré.

Installer le code de développement

$ git clone https://github.com/darold/pgbadger.git
$ cd pgbadger
$ perl Makefile.PL
$ make
$ make test
$ sudo make install

Le code en développement peut contenir des modifications non encore documentées dans les notes de version. Privilégiez une archive associée à une version publiée pour produire des paquets reproductibles en production.

Vérifier l’installation

$ pgbadger --version
$ pgbadger --help

Poursuivez avec la référence de la ligne de commande et la configuration de la journalisation PostgreSQL .