Formats de sortie

Choisissez une sortie HTML, texte, binaire, JSON ou CSV brut et combinez les fichiers intermédiaires

Référence

pgBadger sélectionne la sortie en fonction de l’extension du nom de fichier ou de -x / --extension. Utilisez -o / --outfile plus d’une fois pour générer plusieurs formats à partir du même analyse.

Format	Extension typique	Meilleur usage
HTML	`.html`	rapport interactif, lisible par l’humain avec graphiques
Texte	`.txt`	consultation en terminal et sortie archivée brute
Binaire	`.bin`	statistiques intermédiaires fusionnables et reconstructions de rapport
JSON	`.json`	intégration avec d’autres logiciels ; nécessite `JSON::XS`
CSV brut	fichier de sortie choisi	extraction orientée ligne avec `--dump-raw-csv`

HTML et texte

La sortie par défaut est out.html :

$ pgbadger postgresql.log -o report.html

HTML intègre normalement les scripts, styles, polices et données de rapport nécessaires à la visualisation autonome. -X / --extra-files déplace les ressources JavaScript et CSS partagées hors des rapports incrémentiels ; conservez ces ressources à côté de l’arborescence HTML.

Générer du texte explicitement :

$ pgbadger -x text -o report.txt postgresql.log

Utilisez - comme nom de fichier de sortie pour écrire un format pris en charge sur la sortie standard.

Données intermédiaires binaires

La sortie binaire sépare l’analyse de la présentation. Générez des incréments horaires à partir d’un journal quotidien en croissance :

$ pgbadger --last-parsed .pgbadger_last_state \
    -o sunday/hour01.bin \
    /var/log/pgsql/postgresql-Sun.log

Fusionnez un ou plusieurs fichiers binaires dans un rapport frais :

$ pgbadger -o sunday.html sunday/*.bin

Lorsque le serveur écrit un fichier journal par heure, créez un fichier binaire pour chaque rotation, puis reconstruisez le fichier HTML cumulatif chaque fois que nécessaire :

$ pgbadger -o day1/hour01.bin postgresql-2026-08-15_01.log
$ pgbadger -o day1/hour02.bin postgresql-2026-08-15_02.log
$ pgbadger -o day1/hour03.bin postgresql-2026-08-15_03.log
$ pgbadger -o day1.html day1/*.bin

Gardez les fichiers binaires provenant de versions compatibles de pgBadger ensemble. Consultez les notes de version pour la compatibilité des formats incrémentaux avant de mettre à jour un répertoire de rapports à long terme.

JSON

La sortie JSON est destinée aux consommateurs programmables, tels que les pipelines de surveillance ou de rapport :

$ pgbadger -o report.json postgresql.log

Installez JSON::XS en premier. Ajoutez --prettify-json pour améliorer la lisibilité lorsque la taille du fichier et le temps de génération sont secondaires.

Exports bruts et orientés requêtes

La référence de commande fournit également des exports spécialisés :

--dump-raw-csv analyse le journal et écrit un fichier CSV orienté ligne sans générer de rapport ;
--csv-separator change le délimiteur du CSV brut ;
--dump-all-queries émet chaque requête après avoir remplacé les paramètres liés ;
--normalized-only écrit les requêtes normalisées ;
--query-numbering numérote la sortie texte orientée requête.

Ces modes peuvent contenir du SQL d’application, des identificateurs, des utilisateurs, des adresses clientes ou des valeurs littérales. Examinez la sortie avant de la partager et utilisez --anonymize lorsque l’analyse prévue ne nécessite pas de valeurs littérales.