Komponenten der PostgreSQL-Community on PGSQL.CC

pgBadger 13.x – Versionshinweise

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

Diese Einträge geben den vollständigen Upstream-Änderungsverlauf für pgBadger 13.x wieder, beginnend mit der neuesten Version.

v13.2 · 2025-12-29

Dieses Wartungsrelease von pgBadger behebt Probleme und enthält Patches, die Benutzer seit dem letzten Release gemeldet beziehungsweise eingereicht haben.

Korrigiert die Normalisierung von Zeichenfolgen mit korrekt gepaarten einfachen Anführungszeichen und darin enthaltenen maskierten Anführungszeichen. Dank an Bertrand Bourgier für die Meldung.
Korrigiert die Dokumentation zu den Anforderungen an Platzhalter.
Korrigiert einen Fall, in dem keine Beispiel-Protokolleinträge für Fehler gemeldet wurden. Dank an john doe für die Meldung.
Behebt ein mögliches Problem mit der Operatorrangfolge zwischen ! und %s. Dank an Luca Santarelli und Philipp Trulson für die Meldung.
Aktualisiert den pgFormatter-Code auf v5.9.
Fügt eine GitHub-CI-Aktion hinzu, die bei jedem Commit-Push Tests ausführt.
Korrigiert das Parsen des Platzhalters %r in log_line_prefix. Dank an nike7o0 für die Meldung.
Beseitigt eine Warnung wegen eines nicht initialisierten Werts. Dank an Ales Zeleny für die Meldung.
Erweitert die Dokumentation der ssh-options für das Parsen von PostgreSQL-Protokollen um Beispiele. Dank an Ulrich Konrad für den Patch.
Fügt die Option –ssh-sudo hinzu, um Befehle über SSH mit sudo auszuführen. Dank an Andrew Jackson für den Patch.
Behebt ein mögliches Problem mit der Operatorrangfolge zwischen ! und dem Stringvergleich eq. Dank an Adrien Nayrat für die Meldung.
Korrigiert das Parsen von PgBouncer-Statistiken. Dank an mrgtt für die Meldung.

v13.1 · 2025-03-16

Dieses Wartungsrelease von pgBadger behebt seit dem letzten Release von Benutzern gemeldete Probleme und fügt einige neue Funktionen hinzu:

Funktionen

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

Mehrere Pooling-Modi mit unterschiedlich restriktiver Verbindungszuweisung:

Sitzungs-Pooling

Die am wenigsten restriktive Methode. Wenn ein Client eine Verbindung herstellt, wird ihm für die gesamte Dauer der Clientverbindung eine Serververbindung zugewiesen. Trennt der Client die Verbindung, wird die Serververbindung wieder in den Pool zurückgegeben. Dieser Modus unterstützt sämtliche PostgreSQL-Funktionen.

Transaktions-Pooling

Eine Serververbindung wird einem Client nur für die Dauer einer Transaktion zugewiesen. Sobald PgBouncer erkennt, dass die Transaktion beendet ist, wird die Serververbindung wieder in den Pool zurückgegeben. Dieser Modus ist mit einigen sitzungsbezogenen Funktionen von PostgreSQL nicht kompatibel. Er kann nur eingesetzt werden, wenn die Anwendung darauf abgestimmt ist und keine inkompatiblen Funktionen verwendet. Die folgende Tabelle führt diese Funktionen auf.

Statement-Pooling

Die restriktivste Methode. Sie entspricht dem Transaktions-Pooling, lässt jedoch keine Transaktionen mit mehreren Anweisungen zu. Damit wird auf der Clientseite der „Autocommit“-Modus erzwungen; der Modus ist vor allem für PL/Proxy vorgesehen.
Geringer Speicherbedarf (standardmäßig 2 kB pro Verbindung), da PgBouncer vollständige Pakete nicht auf einmal einlesen muss.

pgBadger 12.x – Versionshinweise

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

Diese Einträge geben den vollständigen Upstream-Änderungsverlauf für pgBadger 12.x wieder, beginnend mit der neuesten Version.

v12.4 · 2023-12-25

Dieses Wartungsrelease von pgBadger behebt Probleme, die Benutzer seit dem letzten Release gemeldet haben.

Korrigiert den PgBouncer-Bericht für Version 1.21. Dank an Ales Zeleny für den Patch.
Verhindert, dass die Parallelität pro Datei die Anzahl der Dateien übersteigt. Dank an maliangzhu für die Meldung.
Behebt den seit v12.3 fehlerhaften Regressionstest. Dank an ieshin für die Meldung.
Korrigiert Fälle, in denen Einträge der Ebene LOG als Einträge der Ebene ERROR gezählt wurden. Dank an Matti Linnanvuori für die Meldung.

v12.3 · 2023-11-27

Dieses Wartungsrelease von pgBadger behebt Probleme, die Benutzer seit dem letzten Release gemeldet haben. Es fügt außerdem einige neue Funktionen hinzu:

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:

pgBadger 11.x Versionshinweise

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

Diese Einträge bewahren den vollständigen Änderungsverlauf des Originalprojekts für pgBadger 11.x; die neuesten Änderungen stehen zuerst.

v11.8 · 2022-04-08

Diese pgBadger-Version behebt einige Probleme, die Benutzer in den vergangenen drei Monaten gemeldet haben. Dazu gehören insbesondere zwei Korrekturen an der Erkennung neuer Protokolleinträge im inkrementellen Modus.

Erkennung neuer Protokolleinträge mit Zeitstempel korrigiert, wenn in log_line_prefix Millisekunden (%m) oder die Unix-Epoche (%n) verwendet werden.
Erkennung neuer Protokolleinträge in lokalen Dateien korrigiert, wenn keine Mehrprozessverarbeitung eingesetzt wird.

Vollständige Liste der Änderungen und Danksagungen:

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:

Verwendung: pgbouncer-Befehl

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

Zusammenfassung

pgbouncer [-d][-R][-v][-u user] <pgbouncer.ini>
pgbouncer -V|-h

Unter Windows stehen folgende Optionen zur Verfügung:

pgbouncer.exe [-v][-u user] <pgbouncer.ini>
pgbouncer.exe -V|-h

Zusätzliche Optionen zur Einrichtung eines Windows-Dienstes:

pgbouncer.exe --regservice   <pgbouncer.ini>
pgbouncer.exe --unregservice <pgbouncer.ini>

Beschreibung

pgbouncer ist ein PostgreSQL-Verbindungspooler. Jede Zielanwendung kann sich mit pgbouncer verbinden, als wäre PgBouncer ein PostgreSQL-Server. pgbouncer stellt dann eine Verbindung zum tatsächlichen Server her oder verwendet eine bereits vorhandene Verbindung wieder.

pgBadger 10.x – Versionshinweise

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

Diese Einträge geben den vollständigen Upstream-Änderungsverlauf für pgBadger 10.x wieder, beginnend mit der neuesten Version.

v10.3 · 2019-02-14

Dieses Wartungsrelease von pgBadger behebt einige Probleme bei der automatischen Erkennung des Logformats sowie ein weiteres, von Benutzern gemeldetes Problem beim Parsen von PgBouncer-Logs. Es enthält außerdem eine neue Funktion:

Die Option -o | --outfile kann nun mehrfach verwendet werden, um
Ausgaben mit einem einzigen Befehl in mehreren Formaten zu erzeugen. Beispiel:
    pgbadger -o out.html -o out.json /log/pgsql-11.log
Dadurch entstehen zwei Berichte im HTML- und JSON-Format, die in den
beiden entsprechenden Dateien gespeichert werden.

Darüber hinaus enthält das Release Fehlerkorrekturen und Funktionsverbesserungen.

PgBouncer kompilieren und installieren

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

Kompilieren

Für das Kompilieren von PgBouncer werden einige Komponenten benötigt:

GNU Make 3.81+
Libevent 2.0+
pkg-config
OpenSSL 1.0.1+ für TLS-Unterstützung
(optional) c-ares als Alternative zu evdns von Libevent
(optional) LDAP-Bibliotheken
(optional) PAM-Bibliotheken

Wenn alle Abhängigkeiten installiert sind, führen Sie folgende Befehle aus:

$ ./configure --prefix=/usr/local
$ make
$ make install

Wenn Sie PgBouncer direkt aus dem Git-Repository oder für Windows kompilieren, beachten Sie die entsprechenden Anleitungen weiter unten.

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.

pgBadger 9.x – Versionshinweise

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

Diese Einträge geben das vollständige Änderungsprotokoll der pgBadger-9.x-Reihe wieder, beginnend mit der neuesten Version.

v9.2 · 2017-07-27

Bei dieser pgBadger-Version handelt es sich um eine Wartungsversion, die einige neue Funktionen ergänzt.

Bericht über Checkpoint-Abstand und -Schätzung hinzugefügt.
Unterstützung für Schlüsselwörter von AWS Redshift im SQL-Codeformatierer hinzugefügt.
Automatische Erkennung des Logformats im Remote-Modus hinzugefügt, damit pgbouncer-Logdateien gemeinsam mit PostgreSQL-Logdateien remote analysiert werden können.

Darüber hinaus wurden einige Fehler behoben und Funktionen verbessert.

Quellcode-Releases zum Download

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

PgBouncer 1.25

Datei	Datum	Größe	SHA256-Prüfsumme
pgbouncer-1.25.2.tar.gz	2026-05-08	865371 Bytes	SHA256-Prüfsumme
pgbouncer-1.25.1.tar.gz	2025-12-03	864801 Bytes	SHA256-Prüfsumme
pgbouncer-1.25.0.tar.gz	2025-11-09	863322 Bytes	SHA256-Prüfsumme

PgBouncer 1.24

Datei	Datum	Größe	SHA256-Prüfsumme
pgbouncer-1.24.1.tar.gz	2025-04-16	717796 Bytes	SHA256-Prüfsumme
pgbouncer-1.24.0.tar.gz	2025-01-10	706573 Bytes	SHA256-Prüfsumme

PgBouncer 1.23

Datei	Datum	Größe	SHA256-Prüfsumme
pgbouncer-1.23.1.tar.gz	2024-08-02	700025 Bytes	SHA256-Prüfsumme
pgbouncer-1.23.0.tar.gz	2024-07-03	694845 Bytes	SHA256-Prüfsumme

PgBouncer 1.22

Datei	Datum	Größe	SHA256-Prüfsumme
pgbouncer-1.22.1.tar.gz	2024-03-04	677351 Bytes	SHA256-Prüfsumme
pgbouncer-1.22.0.tar.gz	2024-01-31	670589 Bytes	SHA256-Prüfsumme

PgBouncer 1.21

Datei	Datum	Größe	SHA256-Prüfsumme
pgbouncer-1.21.0.tar.gz	2023-10-16	668211 Bytes	SHA256-Prüfsumme

PgBouncer 1.20

Datei	Datum	Größe	SHA256-Prüfsumme
pgbouncer-1.20.1.tar.gz	2023-08-09	638844 Bytes	SHA256-Prüfsumme
pgbouncer-1.20.0.tar.gz	2023-07-20	638020 Bytes	SHA256-Prüfsumme

PgBouncer 1.19

Datei	Datum	Größe	SHA256-Prüfsumme
pgbouncer-1.19.1.tar.gz	2023-05-31	623569 Bytes	SHA256-Prüfsumme
pgbouncer-1.19.0.tar.gz	2023-05-04	616947 Bytes	SHA256-Prüfsumme

PgBouncer 1.18

Datei	Datum	Größe	SHA256-Prüfsumme
pgbouncer-1.18.0.tar.gz	2022-12-12	600825 Bytes	SHA256-Prüfsumme

PgBouncer 1.17

Datei	Datum	Größe	SHA256-Prüfsumme
pgbouncer-1.17.0.tar.gz	2022-03-23	598294 Bytes	SHA256-Prüfsumme

PgBouncer 1.16

Datei	Datum	Größe	SHA256-Prüfsumme
pgbouncer-1.16.1.tar.gz	2021-11-11	591450 Bytes	SHA256-Prüfsumme
pgbouncer-1.16.0.tar.gz	2021-08-09	592136 Bytes	SHA256-Prüfsumme

PgBouncer 1.15

Datei	Datum	Größe	SHA256-Prüfsumme
pgbouncer-1.15.0.tar.gz	2020-11-19	588042 Bytes	SHA256-Prüfsumme

PgBouncer 1.14

Datei	Datum	Größe	SHA256-Prüfsumme
pgbouncer-1.14.0.tar.gz	2020-06-11	578955 Bytes	SHA256-Prüfsumme

PgBouncer 1.13

Datei	Datum	Größe	SHA256-Prüfsumme
pgbouncer-1.13.0.tar.gz	2020-04-27	574955 Bytes	SHA256-Prüfsumme

PgBouncer 1.12

Datei	Datum	Größe	SHA256-Prüfsumme
pgbouncer-1.12.0.tar.gz	2019-10-17	567465 Bytes	SHA256-Prüfsumme

PgBouncer 1.11

Datei	Datum	Größe	SHA256-Prüfsumme
pgbouncer-1.11.0.tar.gz	2019-08-27	571414 Bytes	SHA256-Prüfsumme

PgBouncer 1.10

Datei	Datum	Größe	SHA256-Prüfsumme
pgbouncer-1.10.0.tar.gz	2019-07-01	480571 Bytes	SHA256-Prüfsumme

PgBouncer 1.9

Datei	Datum	Größe	SHA256-Prüfsumme
pgbouncer-1.9.0.tar.gz	2018-08-13	469300 Bytes	SHA256-Prüfsumme

PgBouncer 1.8

Datei	Datum	Größe	SHA256-Prüfsumme
pgbouncer-1.8.1.tar.gz	2017-12-20	465930 Bytes	SHA256-Prüfsumme
pgbouncer-1.8.tar.gz	2017-12-19	465612 Bytes	SHA256-Prüfsumme

PgBouncer 1.7

Datei	Datum	Größe	SHA256-Prüfsumme
pgbouncer-1.7.2.tar.gz	2016-02-26	462374 Bytes	SHA256-Prüfsumme
pgbouncer-1.7.1.tar.gz	2016-02-18	461903 Bytes	SHA256-Prüfsumme
pgbouncer-1.7.tar.gz	2015-12-18	459080 Bytes	SHA256-Prüfsumme

PgBouncer 1.6

Datei	Datum	Größe	SHA256-Prüfsumme
pgbouncer-1.6.1.tar.gz	2015-09-03	431076 Bytes	SHA256-Prüfsumme
pgbouncer-1.6.tar.gz	2015-08-01	412700 Bytes	SHA256-Prüfsumme

PgBouncer 1.5

Datei	Datum	Größe	SHA256-Prüfsumme
pgbouncer-1.5.5.tar.gz	2015-04-09	336145 Bytes	SHA256-Prüfsumme
pgbouncer-1.5.4.tar.gz	2012-11-28	339610 Bytes	SHA256-Prüfsumme
pgbouncer-1.5.3.tar.gz	2012-09-12	339013 Bytes	SHA256-Prüfsumme
pgbouncer-1.5.2.tar.gz	2012-05-29	335338 Bytes	SHA256-Prüfsumme
pgbouncer-1.5.1.tar.gz	2012-04-17	334413 Bytes	SHA256-Prüfsumme
pgbouncer-1.5.tar.gz	2012-01-05	411488 Bytes	SHA256-Prüfsumme

PgBouncer 1.4

Datei	Datum	Größe	SHA256-Prüfsumme
pgbouncer-1.4.2.tgz	2011-06-16	283204 Bytes	SHA256-Prüfsumme
pgbouncer-1.4.1.tgz	2011-04-01	282728 Bytes	SHA256-Prüfsumme
pgbouncer-1.4.tgz	2011-01-11	231691 Bytes	SHA256-Prüfsumme

PgBouncer 1.3

Datei	Datum	Größe	SHA256-Prüfsumme
pgbouncer-1.3.4.tgz	2010-09-09	167957 Bytes	SHA256-Prüfsumme
pgbouncer-1.3.3.tgz	2010-05-10	167476 Bytes	SHA256-Prüfsumme
pgbouncer-1.3.2.tgz	2010-03-15	166756 Bytes	SHA256-Prüfsumme
pgbouncer-1.3.1.tgz	2009-07-06	161518 Bytes	SHA256-Prüfsumme
pgbouncer-1.3.tgz	2009-02-18	160154 Bytes	SHA256-Prüfsumme

PgBouncer 1.2

Datei	Datum	Größe	SHA256-Prüfsumme
pgbouncer-1.2.3.tgz	2008-08-08	145372 Bytes	SHA256-Prüfsumme
pgbouncer-1.2.2.tgz	2008-08-06	145017 Bytes	SHA256-Prüfsumme
pgbouncer-1.2.1.tgz	2008-08-04	144903 Bytes	SHA256-Prüfsumme
pgbouncer-1.2.tgz	2008-07-29	143915 Bytes	SHA256-Prüfsumme

PgBouncer 1.1

Datei	Datum	Größe	SHA256-Prüfsumme
pgbouncer-1.1.2.tgz	2007-12-10	122054 Bytes	SHA256-Prüfsumme
pgbouncer-1.1.1.tgz	2007-10-26	121042 Bytes	SHA256-Prüfsumme
pgbouncer-1.1.tgz	2007-10-09	120462 Bytes	SHA256-Prüfsumme

PgBouncer 1.0

Datei	Datum	Größe	SHA256-Prüfsumme
pgbouncer-1.0.8.tgz	2007-06-18	93636 Bytes	SHA256-Prüfsumme
pgbouncer-1.0.7.tgz	2007-04-19	93086 Bytes	SHA256-Prüfsumme
pgbouncer-1.0.6.tgz	2007-04-12	92244 Bytes	SHA256-Prüfsumme
pgbouncer-1.0.5.tgz	2007-04-11	91934 Bytes	SHA256-Prüfsumme
pgbouncer-1.0.4.tgz	2007-04-11	91889 Bytes	SHA256-Prüfsumme
pgbouncer-1.0.3.tgz	2007-04-11	91489 Bytes	SHA256-Prüfsumme
pgbouncer-1.0.2.tgz	2007-03-28	90555 Bytes	SHA256-Prüfsumme
pgbouncer-1.0.1.tgz	2007-03-15	89609 Bytes	SHA256-Prüfsumme
pgbouncer-1.0.tgz	2007-03-13	88587 Bytes	SHA256-Prüfsumme

Binärpakete

Viele Betriebssystemdistributionen stellen ein eigenes natives PgBouncer-Paket beziehungsweise einen Port bereit. Prüfen Sie daher zunächst, ob PgBouncer bereits für Ihr Betriebssystem verfügbar ist.

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.

Community

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

Tutorials

So konfigurieren Sie PgBouncer für Postgres Plus Standard Server

Gute Übersicht über PgBouncer-Konzepte.
Wozu dient das „Bouncing“?

Beschreibt die Unterschiede zwischen den Pooling-Modi.

Support

Projektseite auf GitHub
Issue-Tracker auf GitHub
PgBouncer-Themenbereich auf Stack Overflow
Community-Diskussionen auf GitHub

Häufig gestellte Fragen

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

Wie stelle ich eine Verbindung zu PgBouncer her?

PgBouncer verhält sich wie ein PostgreSQL-Server. Richten Sie Ihren Client daher einfach auf den PgBouncer-Port.

Wie lassen sich Abfragen auf mehrere Server verteilen?

PgBouncer bietet keine interne Multi-Host-Konfiguration. Die Verteilung ist jedoch mit externen Werkzeugen möglich:

DNS-Round-Robin. Hinterlegen Sie mehrere IP-Adressen für einen DNS-Namen. PgBouncer führt nicht bei jeder neuen Verbindung eine DNS-Abfrage durch. Stattdessen speichert es alle IP-Adressen im Cache und verteilt die Verbindungen intern per Round-Robin. Hinweis: Sind einem Namen mehr als 8 IP-Adressen zugeordnet, muss das DNS-Backend das EDNS0-Protokoll unterstützen. Einzelheiten finden Sie in der README-Datei.

Watchdog-Unterstützung

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

Das gleichzeitige Ausführen mehrerer PostgreSQL-Server als primäre Server kann zu Datenverlusten aufgrund von unterschiedlichen Zeitlinien führen. Diese Situation wird auch als “Split-Brain”-Problem bezeichnet. Um das Split-Brain-Problem zu vermeiden, muss Patroni sicherstellen, dass PostgreSQL keine Transaktionsbestätigungen akzeptiert, nachdem der Schlüssel für den primären Server in der DCS abgelaufen ist. Unter normalen Umständen versucht Patroni, dies durch das Stoppen von PostgreSQL zu erreichen, falls der Update-Vorgang für den primären Schlüssel aus irgendeinem Grund fehlschlägt. Dies kann jedoch aus verschiedenen Gründen fehlschlagen:

Pausen/fortsetzen-Modus für den_Cluster

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

Das Ziel

Unter bestimmten Umständen muss Patroni vorübergehend die Verwaltung des Clusters aufgeben, während der Clusterstatus in DCS erhalten bleibt. Mögliche Anwendungsfälle sind ungewöhnliche Aktivitäten im Cluster, wie z. B. größere Versions-Upgrades oder die Wiederherstellung von Daten. Während dieser Aktivitäten werden die Knoten oft gestartet und gestoppt, aus Gründen, die Patroni nicht kennt. Einige Knoten können sogar vorübergehend als primäre Knoten fungieren, was die Annahme verletzt, dass nur ein primärer Knoten aktiv ist. Daher muss Patroni in der Lage sein, sich vom laufenden Cluster zu trennen und eine ähnliche Funktion wie der Wartigungsmodus in Pacemaker zu implementieren.

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.

Integration mit anderen Tools

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

Patroni kann sich in andere Tools in Ihrer Umgebung integrieren. In diesem Abschnitt finden Sie eine Liste von Beispielen, die zwar keine vollständige Liste darstellen, aber Ihnen Ideen geben können, wie Patroni mit anderen Tools zusammenarbeiten kann.

Barman

Patroni liefert eine Anwendung namens patroni_barman, die über Logik verfügt, um mit pg-backup-api zu kommunizieren, sodass Sie Barman-Operationen entfernt durchführen können.

Diese Anwendung verfügt derzeit über mehrere Unterkommandos: recover und config-switch.

Sicherheitshinweise

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

Ein Patroni-Cluster verfügt über zwei Schnittstellen, die vor unbefugtem Zugriff geschützt werden müssen: das verteilte Konfigurationsspeicher (DCS) und die Patroni REST-API.

Schutz des DCS

Sowohl Patroni als auch patronictl speichern und abrufen Daten von/zum DCS.

Obwohl der DCS keine sensiblen Informationen enthält, ermöglicht er die Änderung einiger Konfigurationen von Patroni/Postgres. Daher sollte der DCS selbst daher als erstes geschützt werden.

Die Details zum Schutz hängen vom verwendeten Typ des DCS ab. Die Authentifizierungs- und Verschlüsselungsparameter (Token/Basic-Auth/Client-Zertifikate) für die unterstützten DCS-Typen sind in den Einstellungen beschrieben.

HA-Multi-Datacenter

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

Die Hochverfügbarkeit eines PostgreSQL-Clusters, der in mehreren Rechenzentren bereitgestellt wird, basiert auf Replikation, die synchron oder asynchron erfolgen kann (siehe Replikationsmodi ).

In beiden Fällen ist es wichtig, die folgenden Konzepte klar zu verstehen:

PostgreSQL kann nur als primärer oder sekundärer Knoten betrieben werden, wenn es den Schlüssel besitzt und diesen aktualisieren kann.
Sie sollten eine ungerade Anzahl von etcd-, ZooKeeper- oder Consul-Knoten betreiben: 3 oder 5!

Synchrones Replikation

Um einen mehrere Rechenzentrum (DC) umfassenden Cluster zu haben, der automatisch einen Ausfall einer Zone tolerieren kann, sind mindestens 3 erforderlich.

1. Voraussetzungen

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

Dieses Dokument erläutert, wie Sie HAProxy starten, stoppen und verwalten sowie Störungen diagnostizieren. Darüber hinaus behandelt es einige bekannte Einschränkungen und Fallstricke. Die Konfiguration von HAProxy ist nicht Gegenstand dieses Dokuments (lesen Sie dazu configuration.txt ).

Das Dokument setzt voraus, dass Sie über ausreichende Kenntnisse in der Administration UNIX-ähnlicher Betriebssysteme verfügen, täglich mit der Shell arbeiten und mit Werkzeugen zur Fehlerdiagnose wie strace und tcpdump vertraut sind.

Schlüssel anhand eines Präfixes abrufen

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

Voraussetzungen

Schlüssel anhand eines Präfixes abrufen

$ etcdctl --endpoints=$ENDPOINTS get PREFIX --prefix

Globale Optionen

--endpoints=[127.0.0.1:2379], gRPC endpoints

Optionen

--prefix, get a range of keys with matching prefix

Beispiel

etcdctl --endpoints=$ENDPOINTS put web1 value1
etcdctl --endpoints=$ENDPOINTS put web2 value2
etcdctl --endpoints=$ENDPOINTS put web3 value3

etcdctl --endpoints=$ENDPOINTS get web --prefix

Schnellstart

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

Befolgen Sie diese Anweisungen, um einen lokalen Ein-Mitglied-Cluster mit etcd zu installieren, zu starten und zu testen:

Installieren Sie etcd aus vorkompilierten Binärdateien oder aus dem Quellcode. Weitere Einzelheiten finden Sie in der Installationsanleitung .

Warnung

Wichtig: Führen Sie unbedingt den letzten Schritt der Installationsanleitung aus, um zu prüfen, ob etcd über Ihren Suchpfad aufrufbar ist.
Starten Sie etcd:
```
$ etcd
{"level":"info","ts":"2021-09-17T09:19:32.783-0400","caller":"etcdmain/etcd.go:72","msg":... }
⋮
```
Hinweis

Hinweis: Die Ausgabe von etcd enthält Protokolle — Protokolle auf Info-Ebene können ignoriert werden.

Quellenangaben und Lizenzierung

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

pgsql.cc veröffentlicht Dokumentationen von sechs Upstream-Projekten erneut. Jede Dokumentationsseite endet mit einer einzeiligen Quellenangabe. Sie nennt das Werk, auf dem die Seite basiert, dessen Urheberrechtsinhaber und Lizenz und verweist auf den zugehörigen Abschnitt dieser Seite.

Diese Seite dient als entsprechendes Verzeichnis. Sie dokumentiert, welche Inhalte wann aus welcher festgeschriebenen Revision unter welcher Lizenz importiert wurden und wo der vollständige Upstream-Hinweis aufbewahrt wird.

Hinweis

Die deutsche Ausgabe enthält die vollständige pgBadger-Sammlung sowie bereits übersetzte Seiten aus Patroni, PgBouncer, HAProxy und etcd. Für pgBackRest und noch fehlende Einzelseiten führen die Links zur entsprechenden englischen Seite.

Suche

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

Komponenten der PostgreSQL-Community on PGSQL.CC

pgBadger 13.x – Versionshinweise

v13.2 · 2025-12-29

v13.1 · 2025-03-16

Funktionen

pgBadger 12.x – Versionshinweise

v12.4 · 2023-12-25

v12.3 · 2023-11-27

Download und Installation

Verteilungskanal auswählen

Anforderungen

pgBadger 11.x Versionshinweise

v11.8 · 2022-04-08

Kommandozeilenreferenz

Aufruf und Optionen

Verwendung: pgbouncer-Befehl

Zusammenfassung

Beschreibung

pgBadger 10.x – Versionshinweise

v10.3 · 2019-02-14

PgBouncer kompilieren und installieren

Kompilieren

Konfiguration der PostgreSQL-Protokollierung

Mindestkonfiguration für die Abfrageprotokollierung

pgBadger 9.x – Versionshinweise

v9.2 · 2017-07-27

Quellcode-Releases zum Download

PgBouncer 1.25

PgBouncer 1.24

PgBouncer 1.23

PgBouncer 1.22

PgBouncer 1.21

PgBouncer 1.20

PgBouncer 1.19

PgBouncer 1.18

PgBouncer 1.17

PgBouncer 1.16

PgBouncer 1.15

PgBouncer 1.14

PgBouncer 1.13

PgBouncer 1.12

PgBouncer 1.11

PgBouncer 1.10

PgBouncer 1.9

PgBouncer 1.8

PgBouncer 1.7

PgBouncer 1.6

PgBouncer 1.5

PgBouncer 1.4

PgBouncer 1.3

PgBouncer 1.2

PgBouncer 1.1

PgBouncer 1.0

Binärpakete

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

Community

Tutorials

Support

Häufig gestellte Fragen

Wie stelle ich eine Verbindung zu PgBouncer her?

Wie lassen sich Abfragen auf mehrere Server verteilen?

Watchdog-Unterstützung

Pausen/fortsetzen-Modus für den_Cluster

Das Ziel

Support und Mitwirkung

Fehler und Funktionswünsche

Lizenz und Urhebernachweise

PostgreSQL-Lizenz

Integration mit anderen Tools

Barman

Sicherheitshinweise

Schutz des DCS

HA-Multi-Datacenter

Eine große Datei mit `-j` aufteilen