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

# Fehlerbehebung beim PostgreSQL-Cluster

> **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.

Verbindungsfehler zur Datenbank des PostgreSQL-Clusters von CyberElements Bastion können verschiedene Ursachen haben. Dieser Abschnitt stellt eine allgemeine Methode zur Fehlerbehebung vor, die Sie an Ihren Fall anpassen müssen.

## Den Status des Clusters überprüfen

> **Hinweis**
>
> Durch die Überprüfung des Cluster-Status lassen sich der oder die ausgefallenen Knoten schnell ermitteln.

Sie können den Status des Clusters mit dem folgenden Befehl überprüfen, der auf jedem Knoten des PostgreSQL-Clusters auszuführen ist:

```
1
```

> **Beispiel einer Ausgabe auf einer funktionierenden Plattform**
>
> ```
> 1
> 2
> 3
> 4
> 5
> 6
> 7
> ```
>
> In der obigen Ausgabe deutet alles darauf hin, dass der PostgreSQL-Cluster funktioniert: Der Lag beträgt bei allen `Replica`-Knoten 0 MB, und alle Knoten stehen mit dem Status `running` in der Liste. Sie müssen diese Ausgabe auf allen Knoten erhalten, um zu bestätigen, dass `patroni` und `etcd` funktionieren.

> **Beispiel einer Ausgabe bei einem Kommunikationsproblem zwischen den Knoten**
>
> ```
> 1
> 2
> 3
> 4
> 5
> 6
> 7
> ```
>
> In der obigen Ausgabe ist der Lag von 230 MB ungewöhnlich: Er könnte auf ein Kommunikationsproblem zwischen Knoten 3 und Knoten 1 hindeuten.
> Besteht das Problem nach mehreren Stunden weiterhin, bestätigt sich dies.

> **Beispiel einer Ausgabe, wenn ein Knoten nicht ordnungsgemäß gestartet oder gestoppt wurde**
>
> ```
> 1
> 2
> 3
> 4
> 5
> 6
> 7
> ```
>
> In der obigen Ausgabe zeigt der Zustand (Spalte `State`) an, dass Knoten 1 gerade startet. Bleibt der Status `started` mehrere Minuten oder sogar Stunden bestehen, liegt möglicherweise ein Problem mit `patroni` oder `etcd` auf diesem Knoten vor.
> Knoten 2 befindet sich im Zustand `stopped`: Er ist gestoppt. Fällt ein Cluster-Knoten aus, wird diese Information nur vorübergehend angezeigt, bevor der Knoten aus der Liste entfernt wird.

> **Beispiel einer Ausgabe, wenn `etcd` auf dem aktuellen Knoten ausfällt**
>
> ```
> 1
> 2
> 3
> ```
>
> Die obige Ausgabe zeigt einen Verbindungsfehler zu `etcd`, der das Abrufen des Status des PostgreSQL-Clusters verhindert.

> **Beispiel einer Ausgabe, wenn einer der Knoten desynchronisiert ist**
>
> ```
> 1
> 2
> 3
> 4
> 5
> 6
> 7
> ```
>
> In der obigen Ausgabe 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.
> Um dieses Problem zu beheben, folgen Sie dem Verfahren [Desynchronisierung eines Knotens](https://docs.cyberelements.io/bastion/4.6/de/Installation/Dependencies/PostgreSQLCluster/Troubleshooting/PatroniDebug/#node-desynchronization).

## Den Status der Dienste überprüfen

Nachdem der ausgefallene Knoten ermittelt wurde, müssen Sie den fehlerhaften Dienst ermitteln. Die beiden wichtigsten Dienste des PostgreSQL-Clusters sind `patroni` und `etcd`.

> **Hinweis**
>
> Der Dienst `patroni` hängt vom Dienst `etcd` ab: Wenn `etcd` nicht funktioniert, funktioniert auch `patroni` nicht.

Um den ausgefallenen Dienst zu ermitteln, können Sie die folgenden Befehle ausführen:

```
1
2
```

Diese Befehle zeigen den Status des Dienstes sowie seine letzten 10 Protokollzeilen an.

> **Achtung**
>
> Ein Dienst mit dem Status `active (running)` funktioniert nicht unbedingt: Er kann laufen und dabei Fehlerprotokolle schreiben. Daher ist es wichtig, die Protokolle des Dienstes zu lesen, um seinen tatsächlichen Zustand zu verstehen.

> **Beispiel einer Ausgabe für `etcd`, wenn der Dienst funktioniert**
>
> ```
>  1
>  2
>  3
>  4
>  5
>  6
>  7
>  8
>  9
> 10
> 11
> 12
> 13
> 14
> 15
> 16
> 17
> 18
> 19
> 20
> 21
> 22
> ```

> **Beispiel einer Ausgabe für `etcd`, wenn der Dienst fehlerhaft ist**
>
> ```
>  1
>  2
>  3
>  4
>  5
>  6
>  7
>  8
>  9
> 10
> 11
> 12
> 13
> 14
> 15
> 16
> 17
> 18
> 19
> 20
> ```
>
> In der obigen Ausgabe hat der Dienst `etcd` den Status `failed`, und der Fehler, der seinen Start verhindert hat, steht in Zeile 17: Der Dienst kann den Inhalt des Verzeichnisses `/var/lib/etcd/cleanroom` nicht lesen. [Passen Sie in diesem Fall die Berechtigungen für das Verzeichnis an](https://docs.cyberelements.io/bastion/4.6/de/Installation/Dependencies/PostgreSQLCluster/Troubleshooting/EtcdDebug/#error-log-explanations).

> **Beispiel einer Ausgabe für `patroni`, wenn der Dienst funktioniert**
>
> ```
>  1
>  2
>  3
>  4
>  5
>  6
>  7
>  8
>  9
> 10
> 11
> 12
> 13
> 14
> 15
> 16
> 17
> 18
> 19
> 20
> 21
> 22
> 23
> 24
> 25
> 26
> 27
> 28
> 29
> ```

> **Beispiel einer Ausgabe für `patroni`, wenn der Dienst fehlerhaft ist**
>
> ```
>  1
>  2
>  3
>  4
>  5
>  6
>  7
>  8
>  9
> 10
> 11
> 12
> 13
> 14
> 15
> 16
> 17
> 18
> 19
> 20
> 21
> 22
> 23
> 24
> 25
> 26
> 27
> 28
> 29
> ```
>
> Im obigen Fall hat der Dienst den Status `active (running)`, ohne tatsächlich zu funktionieren: Die Protokolle zeigen verschiedene Verbindungsfehler zu `etcd`, auf den `patroni` angewiesen ist.
> In diesem Beispiel liegt der Fehler nicht unbedingt bei `patroni`: Da er von `etcd` abhängt, beheben Sie zuerst die Probleme mit `etcd` und überprüfen Sie anschließend erneut den Status von `patroni`.

## Verfahren zur Fehlerbehebung für die Dienste

Im Folgenden finden Sie ein Verfahren zur Fehlerbehebung pro Dienst. Wenn sowohl `etcd` als auch `patroni` fehlerhaft sind, beginnen Sie mit `etcd`.

- **[Fehlerbehebung bei `etcd`](https://docs.cyberelements.io/bastion/4.6/de/Installation/Dependencies/PostgreSQLCluster/Troubleshooting/EtcdDebug/)**

  ---

  Verfahren, das anzuwenden ist, wenn der Dienst `etcd` nicht ordnungsgemäß funktioniert.
- **[Fehlerbehebung bei `patroni`](https://docs.cyberelements.io/bastion/4.6/de/Installation/Dependencies/PostgreSQLCluster/Troubleshooting/PatroniDebug/)**

  ---

  Verfahren, das anzuwenden ist, wenn der Dienst `patroni` nicht ordnungsgemäß funktioniert.
