Fehlerbehebung bei patroni¶
Hinweis
Das gesamte Verfahren muss als root durchgeführt werden. Um Ihre Berechtigungen auf root zu erhöhen, können Sie den Befehl su - verwenden.
Achtung
Um dieses Verfahren durchzuführen, müssen Sie die zusätzlichen Konfigurationen für patronictl vorgenommen haben.
patroni ist ein Hochverfügbarkeits-Orchestrator für PostgreSQL. Er automatisiert die Verwaltung eines PostgreSQL-Clusters, indem er bei einem Vorfall die Wahl des Leaders, das Failover und die Synchronisierung der Knoten übernimmt.
Im PostgreSQL-Cluster von CyberElements Bastion stützt sich patroni auf etcd, um den Zustand des Clusters zu speichern und bereitzustellen. Er überwacht kontinuierlich den Zustand der PostgreSQL-Instanzen und stellt sicher, dass zu jedem Zeitpunkt nur ein Knoten als Leader bestimmt ist.
Fällt der Leader-Knoten aus, orchestriert patroni über den verteilten Konfigurationsspeicher etcd automatisch eine Wahl, um einen neuen Leader hochzustufen und die Verfügbarkeit des Dienstes aufrechtzuerhalten.
patroni hängt daher von etcd ab und kann nicht ordnungsgemäß funktionieren, wenn etcd nicht funktioniert.
Desynchronisierung eines Knotens¶
Ein Knoten des PostgreSQL-Clusters kann manchmal aus der Synchronisation geraten. Dies ist in der Ausgabe des Befehls patronictl -c /etc/patroni/config.yml topology sichtbar:
1 2 3 4 5 6 7 | |
In der Spalte TL befindet sich der Knoten PSQL_1 nicht mehr auf derselben TL wie die anderen. Damit der Cluster funktioniert, müssen sich alle Knoten auf derselben TL befinden: Eine Abweichung zeigt an, dass einer der Knoten desynchronisiert ist.
Führen Sie in diesem Fall den folgenden Befehl auf dem desynchronisierten Knoten aus:
1 | |
Dabei ist <MEMBER_PATRONI> der Name des desynchronisierten Knotens, wie er in der Spalte Member der Topologie angezeigt wird.
Wenn mehrere Knoten desynchronisiert sind, synchronisieren Sie alle Knoten neu, die sich nicht auf der höchsten TL befinden.
Achtung
Wenn der desynchronisierte Knoten der Knoten Leader ist, können Daten verloren gehen. Dies sollte nie vorkommen: Der Knoten Leader sollte sich stets auf der höchsten TL befinden.
Beispiel
In der obigen Ausgabe des Befehls patronictl -c /etc/patroni/config.yml topology ist der Knoten PSQL_1 desynchronisiert. Um ihn neu zu synchronisieren, verwenden Sie den folgenden Befehl:
1 | |
Protokolle¶
Das gesamte Verfahren stützt sich auf die Protokolle des Dienstes patroni, die Sie mit dem folgenden Befehl abrufen:
1 | |
Tipp
Um die Protokolle live zu verfolgen, fügen Sie dem Befehl die Option -f hinzu:
1 | |
Hinweis
Die Protokolle von patroni sind auch in /var/log/syslog verfügbar.
Erläuterungen zu Fehlerprotokollen¶
ERROR: Request to server https://<PSQL_NODE_NAME>:2379 failed: MaxRetryError("HTTPSConnectionPool(host='<PSQL_NODE_NAME>', port=2379)
Wenn etcd nicht funktioniert oder nicht erreichbar ist, kann patroni die folgenden Fehler schreiben:
1 2 3 4 5 6 7 8 | |
<PSQL_NODE_NAME>-
Name eines der Knoten des PostgreSQL-Clusters.
In diesem Fall müssen Sie eine Fehlerbehebung bei etcd durchführen.