Dokumentation zu pgBadger 13.2
pgBadger ist ein schnelles, eigenständiges und in Perl geschriebenes Analyseprogramm für PostgreSQL-Protokolle. Es liest PostgreSQL- oder PgBouncer-Protokolle und erzeugt detaillierte Ausgaben als HTML, Text, Binärdaten, JSON oder Roh-CSV. Die HTML-Berichte sind in sich geschlossen, interaktiv und zoombar; zur Anzeige genügt ein Webbrowser.
Warum pgBadger
pgBadger ist für große Protokolle und den betrieblichen Einsatz konzipiert:
- ein einziges Perl-Programm ohne obligatorische Module außerhalb der Perl-Standardbibliothek;
- automatische Erkennung von
stderr,syslog,csvlog,jsonlog, RDS, Cloud SQL, logplex, Redshift und PgBouncer-Eingabe; - direktes Lesen lokaler Dateien, der Standardeingabe, entfernter Dateien über SSH sowie von HTTP-, FTP- oder SFTP-URLs;
- mit gzip, bzip2, lz4, xz, zip oder zstd komprimierte Eingaben;
- parallele Analyse einer großen Datei oder vieler kleiner Dateien;
- tägliche und wöchentliche inkrementelle Berichte sowie monatliche Berichte auf Abruf;
- Filter nach Zeit, Datenbank, Benutzer, Client, Anwendung, Prozess, Sitzung und Abfragemuster.
Was die Berichte enthalten
Die PostgreSQL-Berichte umfassen:
- Gesamtaktivität und Abfragestatistiken;
- langsame, häufige, besonders zeitintensive, wartende und abgebrochene Abfragen;
- temporäre Dateien, Prüfpunkte, Sperren, Sitzungen und Verbindungen;
- Autovacuum- und Autoanalyze-Aktivität nach Tabelle;
- Fehler und Ereignisse nach Schweregrad und Kategorie;
- Verteilungen nach Datenbank, Benutzer, Client, Anwendung und Anweisungstyp.
Für PgBouncer-Eingaben kommen Durchsatz, durchschnittliche Abfragedauer, gleichzeitige Sitzungen, die Verteilung von Verbindungen und Sitzungen, die Nutzung des reservierten Pools sowie Berichte zu häufigen Fehlern und Ereignissen hinzu.
Dokumentationsübersicht
Lesen Sie die Dokumentation in dieser Reihenfolge, oder verwenden Sie die Seitenleiste, um direkt zu einer Aufgabe zu springen:
- Laden Sie pgBadger samt seinen optionalen Modulen herunter und installieren Sie es .
- Überprüfen Sie die vollständige Befehlszeilenreferenz .
- Konfigurieren Sie die PostgreSQL-Protokollierung mit einem analysierbaren Präfix.
- Wählen Sie den geeigneten Modus für die Parallelverarbeitung .
- Erstellen Sie inkrementelle Berichte sicher.
- Wählen Sie ein Ausgabeformat und sehen Sie sich die lokalen Beispiele an.
- Informieren Sie sich über die Versionsgeschichte , Support und Mitwirkung sowie die Lizenz .
Links zum Originalprojekt
Offizielle Releases, Pakete, Anforderungen und Installation aus dem Quellcode
Vollständige pgBadger-Befehlssyntax, Optionen, Remote-Eingabe, Rückgabecodes und Beispiele
Abfrageprotokollierung, log_line_prefix, Locale und ergänzende Statistikdaten für pgBadger konfigurieren
Zwischen der abschnittsweisen Parallelverarbeitung einer einzelnen Protokolldatei und der parallelen Verarbeitung vieler Protokolle wählen
Tägliche und wöchentliche Berichte erstellen, die Aufbewahrung steuern, Ausgaben neu erstellen und monatliche Zusammenfassungen hinzufügen
HTML, Text, Binärdaten, JSON oder Roh-CSV als Ausgabeformat wählen und Zwischendateien zusammenführen
Vollständige, auf Fehler beschränkte und inkrementelle pgBadger-Berichte aus dem lokalen Website-Snapshot öffnen
Vollständige Versionshinweise von pgBadger 9.x bis 13.x, normalisiert aus dem ursprünglichen Änderungsprotokoll
Fehler melden, Funktionswünsche einreichen, Patches beisteuern und professionellen PostgreSQL-Support finden
Bedingungen der PostgreSQL-Lizenz, Urheberschaft und eingebundene Drittanbieterkomponenten