Ausgabeformate

HTML, Text, Binärdaten, JSON oder Roh-CSV als Ausgabeformat wählen und Zwischendateien zusammenführen

Referenz

pgBadger bestimmt das Ausgabeformat anhand der Dateiendung oder über -x / --extension. Verwenden Sie -o / --outfile mehrfach, um in einem einzigen Analyselauf mehrere Formate zu erzeugen.

Format	Typische Erweiterung	Empfohlener Einsatz
HTML	`.html`	interaktiver, gut lesbarer Bericht mit Diagrammen
Text	`.txt`	Prüfung im Terminal und einfache Archivierung
Binär	`.bin`	zusammenführbare Zwischenstatistiken und Neuerstellung von Berichten
JSON	`.json`	Integration mit anderer Software; erfordert `JSON::XS`
Roh-CSV	gewählte Ausgabedatei	zeilenorientierter Export mit `--dump-raw-csv`

HTML und Text

Die Standardausgabe ist out.html:

$ pgbadger postgresql.log -o report.html

HTML enthält standardmäßig alle Skripte, Stylesheets, Schriftarten und Berichtsdaten, die für eine eigenständige Anzeige erforderlich sind. -X / --extra-files lagert gemeinsam genutzte JavaScript- und CSS-Dateien bei inkrementellen Berichten aus; bewahren Sie diese Ressourcen zusammen mit dem HTML-Verzeichnisbaum auf.

Geben Sie das Textformat ausdrücklich an:

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

Verwenden Sie - als Ausgabedateinamen, um ein unterstütztes Format auf die Standardausgabe zu schreiben.

Binäre Zwischendaten

Die Binärausgabe trennt die Analyse von der Darstellung. Erzeugen Sie stündliche Zwischenstände aus einer im Laufe des Tages wachsenden Protokolldatei:

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

Führen Sie ein oder mehrere Binärdateien in einem neuen Bericht zusammen:

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

Wenn der Server pro Stunde eine Protokolldatei schreibt, erstellen Sie für jede Rotation eine Binärdatei und erzeugen den kumulativen HTML-Bericht bei Bedarf neu:

$ 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

Führen Sie nur Binärdateien aus kompatiblen pgBadger-Versionen zusammen. Lesen Sie vor dem Upgrade eines dauerhaft genutzten Berichtsverzeichnisses in den Versionshinweisen nach, ob die Binärformate kompatibel sind.

JSON

Die JSON-Ausgabe ist für die maschinelle Weiterverarbeitung vorgesehen, etwa in Überwachungs- oder Berichtspipelines:

$ pgbadger -o report.json postgresql.log

Installieren Sie zunächst JSON::XS. Fügen Sie --prettify-json hinzu, um die Lesbarkeit zu verbessern, wenn Dateigröße und Erstellungsdauer weniger wichtig sind.

Roh- und abfrageorientierte Exporte

Die Befehlsreferenz bietet außerdem spezialisierte Exporte:

--dump-raw-csv analysiert das Protokoll und schreibt zeilenorientierte CSV-Dateien, ohne einen Bericht zu erstellen;
--csv-separator ändert das Trennzeichen für die Roh-CSV-Datei;
--dump-all-queries gibt jede Abfrage nach dem Ersetzen der Bind-Parameter aus;
--normalized-only schreibt normalisierte Abfragen;
--query-numbering nummeriert die Abfragen in der Textausgabe.

Diese Modi können Anwendungs-SQL, Bezeichner, Benutzer, Client-Adressen oder Literalwerte enthalten. Prüfen Sie die Ausgabe vor der Freigabe und verwenden Sie --anonymize, wenn die geplante Analyse keine Literalwerte erfordert.