
| Kategorien: | credativ® Inside |
|---|
Eine unterbrochene PostgreSQL-Replikation® gehört zu den kritischsten Situationen im Datenbankbetrieb. Sobald ein Standby-Server nicht mehr mit dem Primary synchronisiert ist, wächst der Rückstand, und im schlimmsten Fall ist ein Failover nicht mehr möglich. Dieser Leitfaden zeigt Ihnen Schritt für Schritt, wie Sie eine unterbrochene Replikation diagnostizieren, reparieren und dauerhaft absichern.
Die folgenden Abschnitte führen Sie von der ersten Fehleranalyse bis zur abschließenden Verifikation. Ob Sie die Streaming-Replikation neu starten oder den Standby-Server vollständig neu aufsetzen müssen, hängt von der Ursache ab. Beginnen Sie daher immer mit der Diagnose, bevor Sie Maßnahmen ergreifen.
Bevor Sie mit der Reparatur beginnen, müssen Sie verstehen, warum die PostgreSQL-Replikation unterbrochen wurde. Die häufigsten Ursachen lassen sich in wenige Kategorien einteilen, die unterschiedliche Lösungswege erfordern.
Prüfen Sie zunächst das PostgreSQL-Logfile auf dem Standby-Server. Typische Fehlermeldungen geben bereits einen klaren Hinweis auf die Ursache:
wal_keep_size-Wert oder ein fehlend konfigurierter Replication Slot.pg_hba.conf wurde geändert.Führen Sie auf dem Primary-Server außerdem die folgende Abfrage aus, um den Replikationsstatus zu prüfen:
SELECT * FROM pg_stat_replication;
Erscheint der Standby dort nicht, ist die Verbindung vollständig unterbrochen. Ist er sichtbar, aber sent_lsn und replay_lsn weichen stark voneinander ab, liegt ein Rückstand vor, der sich möglicherweise noch aufholen lässt.
Bevor Sie in die Reparatur einsteigen, stellen Sie sicher, dass alle notwendigen Zugänge und Informationen vorliegen. Eine unvollständige Vorbereitung führt häufig zu Unterbrechungen mitten im Reparaturprozess.
postgres-Benutzer)postgresql.conf, pg_hba.conf, recovery.conf bzw. standby.signalpg_isready oder telnet)Notieren Sie außerdem den aktuellen LSN-Wert des Primary mit SELECT pg_current_wal_lsn();. Dieser Wert dient später als Referenz, um zu prüfen, ob der Standby nach der Reparatur tatsächlich aufholt.
Wenn die Ursache ein temporärer Verbindungsabbruch oder ein Konfigurationsproblem ist und der Standby noch über alle notwendigen WAL-Segmente verfügt, reicht häufig ein Neustart des PostgreSQL-Dienstes auf dem Standby aus, um die Replikation wieder aufzunehmen.
standby.signal (ab PostgreSQL 12) oder recovery.conf (bis PostgreSQL 11) vorhanden und korrekt konfiguriert ist.primary_conninfo in der Konfiguration die korrekte Adresse, den Port und die Anmeldedaten des Primary enthält.pg_hba.conf auf dem Primary-Server, sodass der Standby-Host die Berechtigung replication besitzt.systemctl restart postgresqljournalctl -u postgresql -f oder die PostgreSQL-Logdatei im Datenverzeichnis.Nach dem Neustart sollte im Log eine Meldung wie „started streaming WAL from primary“ erscheinen. Führen Sie dann erneut SELECT * FROM pg_stat_replication; auf dem Primary aus. Erscheint der Standby dort mit einem aktiven Status und sinkt der Lag, ist die Replikation erfolgreich wiederhergestellt. Wenn diese Meldung ausbleibt oder Fehler auftreten, ist ein vollständiges Neuaufsetzen des Standby erforderlich.
Fehlen auf dem Standby WAL-Segmente, die der Primary bereits nicht mehr vorhält, ist ein vollständiges Neuaufsetzen des Standby-Servers der einzig zuverlässige Weg. pg_basebackup ist das Standardwerkzeug für diesen Vorgang und gehört zum PostgreSQL-Lieferumfang.
Stoppen Sie zunächst den PostgreSQL-Dienst auf dem Standby und sichern Sie das bestehende Datenverzeichnis, falls Sie es später noch benötigen:
systemctl stop postgresqlmv /var/lib/postgresql/data /var/lib/postgresql/data_backupmkdir /var/lib/postgresql/data und stellen Sie sicher, dass der postgres-Benutzer Eigentümer ist.Führen Sie pg_basebackup als postgres-Benutzer auf dem Standby-Server aus:
pg_basebackup -h <primary-ip> -U replicator -D /var/lib/postgresql/data -P -Xs -R-Xs überträgt WAL-Segmente per Streaming während des Backups. -R erstellt automatisch die Datei standby.signal und trägt primary_conninfo in die postgresql.auto.conf ein.Nach Abschluss des Backups starten Sie den PostgreSQL-Dienst auf dem Standby: systemctl start postgresql. Prüfen Sie das Log auf die Meldung, dass der Standby WAL-Segmente vom Primary streamt. Der Standby befindet sich jetzt in einem konsistenten Ausgangszustand und holt den Rückstand gegenüber dem Primary auf.
Nach dem Neustart der Replikation sollten Sie systematisch prüfen, ob die Streaming-Replikation in PostgreSQL wie erwartet funktioniert. Eine schnelle Sichtprüfung reicht hier nicht aus.
SELECT client_addr, state, sent_lsn, write_lsn, flush_lsn, replay_lsn, sync_state FROM pg_stat_replication; und prüfen Sie, ob der Standby mit dem Status streaming erscheint.SELECT pg_wal_lsn_diff(pg_current_wal_lsn(), replay_lsn) AS lag_bytes FROM pg_stat_replication;. Der Wert sollte kontinuierlich sinken und sich Null annähern.SELECT pg_is_in_recovery(); muss true zurückgeben.Sobald lag_bytes bei null liegt und der Standby stabil im Status streaming bleibt, ist die Reparatur erfolgreich abgeschlossen. Dokumentieren Sie die durchgeführten Schritte und die identifizierte Ursache, um bei zukünftigen Vorfällen schneller reagieren zu können.
Die beste Reparatur ist die, die Sie nie durchführen müssen. Mit einigen gezielten Konfigurationsanpassungen und einem durchdachten Monitoring lassen sich die meisten Replikationsfehler in PostgreSQL von vornherein vermeiden.
wal_keep_size auf einen Wert, der dem Standby genug Zeit gibt, WAL-Segmente zu lesen, auch wenn er kurzzeitig zurückfällt. Alternativ bieten Replication Slots eine zuverlässigere Methode, WAL-Segmente zu reservieren.pg_stat_replication kontinuierlich und setzen Sie Alarme, sobald der Replikations-Lag einen definierten Schwellenwert überschreitet. Viele Monitoring-Lösungen wie Prometheus mit dem postgres_exporter bieten hierfür fertige Metriken.Mit einem soliden Monitoring- und Support-Konzept lassen sich Replikationsprobleme oft erkennen, bevor sie zu einem tatsächlichen Ausfall führen.
Replikationsfehler treten häufig zu ungünstigen Zeitpunkten auf und erfordern tiefes Fachwissen, das intern nicht immer verfügbar ist. Unser PostgreSQL® Kompetenz-Center unterstützt Sie in genau diesen Situationen mit erfahrenen Spezialisten und einem strukturierten Vorgehen.
Wenn Sie Unterstützung bei einer laufenden Replikationsstörung benötigen oder Ihre PostgreSQL-Umgebung langfristig absichern möchten, kontaktieren Sie uns direkt. Wir helfen Ihnen schnell und unkompliziert weiter.
PostgreSQL® ist eine Marke der PostgreSQL Global Development Group. credativ® ist Competence Center für PostgreSQL®. Die Nennung dient ausschließlich der sachlichen Beschreibung von Dienstleistungen von credativ®. Es besteht keine geschäftliche Verbindung zu den genannten Markeninhabern über die genannte Beziehung hinaus.
| Kategorien: | credativ® Inside |
|---|
über den Autor
Head of Sales & Marketing
zur Person
Peter Dreuw arbeitet seit 2016 für die credativ GmbH und ist seit 2017 Teamleiter. Seit 2021 ist er Teil des Management-Teams als VP Services der Instaclustr. Mit der Übernahme durch die NetApp wurde seine neue Rolle "Senior Manager Open Source Professional Services". Im Rahmen der Ausgründung wurde er Mitglied der Geschäftsleitung als Prokurist. Sein Aufgabenfeld ist die Leitung des Vertriebs und des Marketings. Er ist Linux-Nutzer der ersten Stunden und betreibt Linux-Systeme seit Kernel 0.97. Trotz umfangreicher Erfahrung im operativen Bereich ist er leidenschaftlicher Softwareentwickler und kennt sich auch mit hardwarenahen Systemen gut aus.
Sie müssen den Inhalt von reCAPTCHA laden, um das Formular abzuschicken. Bitte beachten Sie, dass dabei Daten mit Drittanbietern ausgetauscht werden.
Mehr InformationenSie sehen gerade einen Platzhalterinhalt von Brevo. Um auf den eigentlichen Inhalt zuzugreifen, klicken Sie auf die Schaltfläche unten. Bitte beachten Sie, dass dabei Daten an Drittanbieter weitergegeben werden.
Mehr InformationenSie müssen den Inhalt von reCAPTCHA laden, um das Formular abzuschicken. Bitte beachten Sie, dass dabei Daten mit Drittanbietern ausgetauscht werden.
Mehr InformationenSie müssen den Inhalt von Turnstile laden, um das Formular abzuschicken. Bitte beachten Sie, dass dabei Daten mit Drittanbietern ausgetauscht werden.
Mehr InformationenSie müssen den Inhalt von reCAPTCHA laden, um das Formular abzuschicken. Bitte beachten Sie, dass dabei Daten mit Drittanbietern ausgetauscht werden.
Mehr InformationenSie sehen gerade einen Platzhalterinhalt von Turnstile. Um auf den eigentlichen Inhalt zuzugreifen, klicken Sie auf die Schaltfläche unten. Bitte beachten Sie, dass dabei Daten an Drittanbieter weitergegeben werden.
Mehr Informationen