Dokumentation zu pgBadger 13.2 on PIG.CENTER

Download und Installation

Mon, 01 Jan 0001 00:00:00 +0000

Verteilungskanal auswählen

Kanal	Verwendungszweck	Bezugsquelle
Offizielles Release	Quellcode-Tarballs und Versionshinweise	GitHub Releases
RPM-Paket	RPM-basierte Linux-Distributionen	PostgreSQL Yum Repository
Debian/Ubuntu-Paket	APT-basierte Linux-Distributionen	PostgreSQL Apt Repository
Entwicklungsquelle	Aktueller, noch nicht veröffentlichter Code	darold/pgbadger

Der Dokumentations-Snapshot auf dieser Website basiert auf dem Quellcode der Version 13.2. Prüfen Sie vor dem Herunterladen stets die Releaseseite: Der lokale Snapshot ist bewusst fixiert, während das Originalprojekt weiterhin neue Versionen veröffentlicht.

Anforderungen

Für HTML-Berichte benötigen Sie lediglich:

Kommandozeilenreferenz

Mon, 01 Jan 0001 00:00:00 +0000

Diese Seite enthält die aus dem festgeschriebenen Upstream-Quellstand erzeugte Befehlsreferenz. Optionsnamen und Hilfetexte bleiben unverändert, damit sie sich direkt mit pgbadger --help vergleichen lassen.

Aufruf und Optionen

Aufruf: pgbadger [options] logfile […]

PostgreSQL log analyzer with fully detailed reports and graphs.

Argumente:

logfile can be a single log file, a list of files, or a shell command
returning a list of files. If you want to pass log content from stdin
use - as filename. Note that input from stdin will not work with csvlog.

Optionen:

Konfiguration der PostgreSQL-Protokollierung

Mon, 01 Jan 0001 00:00:00 +0000

pgBadger kann nur Informationen auswerten, die PostgreSQL in das Protokoll schreibt. Beginnen Sie mit einem analysierbaren Präfix und einer gezielt gewählten Richtlinie für die Anweisungsprotokollierung. Fügen Sie anschließend die Betriebsereignisse hinzu, die Sie analysieren möchten.

Mindestkonfiguration für die Abfrageprotokollierung

Um Abfragetext und -dauer zu erfassen, aktivieren Sie die dauerabhängige Protokollierung von Anweisungen:

log_min_duration_statement = 0

0 protokolliert jede abgeschlossene Anweisung. Auf einem stark ausgelasteten Server sollten Sie einen höheren Schwellenwert in Millisekunden wählen, um das Protokollvolumen zu begrenzen. Prüfen Sie den zusätzlichen Aufwand und die Zunahme des Speicherbedarfs, bevor Sie in der Produktion einen niedrigen Schwellenwert aktivieren.

Parallelverarbeitung

Mon, 01 Jan 0001 00:00:00 +0000

pgBadger bietet zwei einander ergänzende Modi für die Parallelverarbeitung. Wählen Sie den Modus anhand der Struktur Ihrer Eingabedaten und nicht allein nach der Anzahl der CPUs.

Option	Parallelitätseinheit	Geeignet für	Wichtigste Einschränkung
`-j N` / `--jobs N`	Abschnitte einer Protokolldatei	eine große Protokolldatei mit wahlfreiem Zugriff	An Abschnittsgrenzen kann eine geringe Anzahl von Abfragen doppelt gezählt oder ausgelassen werden
`-J N` / `--Jobs N`	vollständige Protokolldateien	viele unabhängige Protokolle	nützlich nur, wenn genügend Dateien vorhanden sind, um die Worker auszulasten

Eine große Datei mit `-j` aufteilen

$ pgbadger -j 8 /var/log/postgresql/postgresql.log

Der Algorithmus des Originalprojekts teilt jede Datei in N Bytebereiche auf, startet für jeden Bereich einen eigenen Parser, schreibt temporäre Binärstatistiken und führt diese anschließend zum endgültigen Bericht zusammen.

Inkrementelle Berichte

Mon, 01 Jan 0001 00:00:00 +0000

Im inkrementellen Modus speichert pgBadger die ausgewerteten Statistiken im Binärformat. Daraus erstellt es pro Tag einen HTML-Bericht, pro Woche einen kumulativen Bericht und einen kalenderartigen Index, der diese Berichte miteinander verknüpft. Der Modus ist für die wiederholte Verarbeitung rotierter Protokolle vorgesehen, ohne dieselben Einträge erneut zu zählen.

Tägliche und wöchentliche Berichte erstellen

Führen Sie pgBadger nach der täglichen Protokollrotation aus und geben Sie ein dauerhaftes Ausgabeverzeichnis an:

Ausgabeformate

Mon, 01 Jan 0001 00:00:00 +0000

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:

Beispielberichte

Mon, 01 Jan 0001 00:00:00 +0000

Die Beispielberichte wurden im Mai 2022 mit pgBadger 11.8 erzeugt. Die Originalbeispiele sind lokal auf dieser Website eingebunden. Daher bleiben Berichtsnavigation, Diagramme, Stylesheets und Skripte verfügbar, ohne auf den Server des Originalprojekts zugreifen zu müssen.

Beispiel	Was es zeigt	Lokale Kopie
Vollständiger Bericht	PostgreSQL-Aktivität zusammen mit PgBouncer-Statistiken	Öffnen Sie den vollständigen Bericht
Inkrementeller Bericht	Kalenderindex, wöchentliche Aggregation und tägliche Seiten	Öffnen Sie den inkrementellen Index
Fehler und Ereignisse	Ein Bericht, der auf Fehler und betriebliche Ereignisse beschränkt ist	Öffnen Sie den Fehlerbericht

Vollständiger Bericht

Der vollständige Bericht ist eine in sich geschlossene HTML-Datei. Über die obere Navigationsleiste können Sie globale Statistiken, Abfragen, Sitzungen, Verbindungen, temporäre Dateien, Prüfpunkte, Autovacuum-Aktivität, Sperren und PgBouncer-spezifische Diagramme untersuchen.

Support und Mitwirkung

Mon, 01 Jan 0001 00:00:00 +0000

pgBadger wird als offenes Projekt gepflegt. Fehlerberichte, Funktionsvorschläge, Dokumentationskorrekturen und Patches werden über das Repository des Originalprojekts auf GitHub verwaltet.

Fehler und Funktionswünsche

Aktualisieren Sie pgBadger auf die neueste veröffentlichte Version und prüfen Sie, ob das Verhalten weiterhin auftritt.
Suchen Sie in den offenen Issues und geschlossenen Issues nach einer vorhandenen Lösung.
Reduzieren Sie das Problem auf einen möglichst kleinen, bereinigten Protokollauszug und die kürzeste Befehlszeile, mit denen es sich noch reproduzieren lässt.
Entfernen Sie Anmeldeinformationen, sensible SQL, Bind-Werte, Hostnamen, Adressen und Geschäftsdaten.
Erstellen Sie ein neues Issue und geben Sie die pgBadger-Version, das Betriebssystem, das Eingabeformat, die genauen Optionen sowie das beobachtete und das erwartete Ergebnis an.

Geben Sie bei Abstürzen oder Parserfehlern nur die unbedingt erforderlichen, bereinigten Protokollzeilen an, mit denen sich der Fehler reproduzieren lässt. Ein vollständiges Produktionsprotokoll oder ein erzeugter Bericht eignet sich nur selten für ein öffentliches Issue.

Lizenz und Urhebernachweise

Mon, 01 Jan 0001 00:00:00 +0000

pgBadger ist freie Open-Source-Software, die unter der PostgreSQL-Lizenz verbreitet wird. Sie darf kostenlos genutzt, kopiert, verändert und verteilt werden, sofern die Urheberrechts- und Lizenzhinweise erhalten bleiben.

PostgreSQL-Lizenz

Permission to use, copy, modify, and distribute this software and its documentation for any purpose, without fee, and without a written agreement is hereby granted, provided that the above copyright notice and this paragraph and the following two paragraphs appear in all copies.

Dokumentation zu pgBadger 13.2 on PIG.CENTER

Download und Installation

Verteilungskanal auswählen

Anforderungen

Kommandozeilenreferenz

Aufruf und Optionen

Konfiguration der PostgreSQL-Protokollierung

Mindestkonfiguration für die Abfrageprotokollierung

Parallelverarbeitung

Eine große Datei mit -j aufteilen

Inkrementelle Berichte

Tägliche und wöchentliche Berichte erstellen

Ausgabeformate

HTML und Text

Beispielberichte

Vollständiger Bericht

Support und Mitwirkung

Fehler und Funktionswünsche

Lizenz und Urhebernachweise

PostgreSQL-Lizenz

Eine große Datei mit `-j` aufteilen