> Source: https://docs.cyberelements.io/bastion/4.6/de/Installation/Dependencies/PostgreSQLCluster/Troubleshooting/PatroniDebug/

# 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`](https://docs.cyberelements.io/bastion/4.6/de/Installation/Dependencies/PostgreSQLCluster/Installation/Install/#additional-configurations-for-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`](https://docs.cyberelements.io/bastion/4.6/de/Installation/Dependencies/PostgreSQLCluster/Troubleshooting/EtcdDebug/) durchführen.
