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

# Probleemoplossing voor de PostgreSQL-cluster

> **Informatie**
>
> De volledige procedure moet als `root` worden uitgevoerd. Om uw bevoegdheden naar `root` te verhogen, kunt u de opdracht `su -` gebruiken.

> **Waarschuwing**
>
> Om deze procedure te volgen, moet u de [aanvullende configuraties voor `patronictl`](https://docs.cyberelements.io/bastion/4.6/nl/Installation/Dependencies/PostgreSQLCluster/Installation/Install/#additional-configurations-for-patronictl) hebben uitgevoerd.

Verbindingsfouten met de database van de PostgreSQL-cluster van CyberElements Bastion kunnen verschillende oorzaken hebben. Deze sectie beschrijft een algemene methode voor probleemoplossing, die u aan uw situatie moet aanpassen.

## De status van de cluster controleren

> **Informatie**
>
> Door de status van de cluster te controleren, vindt u snel de defecte node of nodes.

U kunt de status van de cluster controleren met de volgende opdracht, die op elke node van de PostgreSQL-cluster moet worden uitgevoerd:

```
1
```

> **Voorbeeld van uitvoer op een werkend platform**
>
> ```
> 1
> 2
> 3
> 4
> 5
> 6
> 7
> ```
>
> In de bovenstaande uitvoer wijst alles erop dat de PostgreSQL-cluster werkt: de lag is 0 MB voor alle `Replica`-nodes, en alle nodes staan in de lijst, met de status `running`. U moet deze uitvoer op alle nodes krijgen om te bevestigen dat `patroni` en `etcd` werken.

> **Voorbeeld van uitvoer bij een communicatieprobleem tussen de nodes**
>
> ```
> 1
> 2
> 3
> 4
> 5
> 6
> 7
> ```
>
> In de bovenstaande uitvoer is de lag van 230 MB abnormaal: dit kan wijzen op een communicatieprobleem tussen node 3 en node 1.
> Als het probleem na enkele uren blijft bestaan, bevestigt dit het.

> **Voorbeeld van uitvoer wanneer een node niet correct is gestart of gestopt**
>
> ```
> 1
> 2
> 3
> 4
> 5
> 6
> 7
> ```
>
> In de bovenstaande uitvoer geeft de status (kolom `State`) aan dat node 1 aan het starten is. Als de status `started` enkele minuten of zelfs uren blijft bestaan, kan er een probleem zijn met `patroni` of `etcd` op die node.
> Node 2 heeft de status `stopped`: de node is gestopt. Wanneer een node van de cluster uitvalt, wordt deze informatie slechts tijdelijk weergegeven, voordat de node uit de lijst wordt verwijderd.

> **Voorbeeld van uitvoer wanneer `etcd` uitvalt op de huidige node**
>
> ```
> 1
> 2
> 3
> ```
>
> De bovenstaande uitvoer geeft een verbindingsfout met `etcd` aan, waardoor de status van de PostgreSQL-cluster niet kan worden opgehaald.

> **Voorbeeld van uitvoer wanneer een van de nodes gedesynchroniseerd is**
>
> ```
> 1
> 2
> 3
> 4
> 5
> 6
> 7
> ```
>
> In de bovenstaande uitvoer staat de node `PSQL_1` niet meer op dezelfde `TL` als de andere. Voor de werking van de cluster moeten alle nodes op dezelfde `TL` staan: een verschil geeft aan dat een van de nodes gedesynchroniseerd is.
> Volg de procedure [desynchronisatie van een node](https://docs.cyberelements.io/bastion/4.6/nl/Installation/Dependencies/PostgreSQLCluster/Troubleshooting/PatroniDebug/#node-desynchronization) om dit probleem op te lossen.

## De status van de services controleren

Zodra de defecte node is geïdentificeerd, moet u de service identificeren die niet goed werkt. De twee belangrijkste services op de PostgreSQL-cluster zijn `patroni` en `etcd`.

> **Informatie**
>
> De service `patroni` is afhankelijk van de service `etcd`: als `etcd` niet werkt, werkt `patroni` ook niet.

U kunt de volgende opdrachten uitvoeren om de defecte service te identificeren:

```
1
2
```

Deze opdrachten geven de status van de service weer, samen met de laatste 10 logregels.

> **Waarschuwing**
>
> Een service met de status `active (running)` werkt niet noodzakelijk: de service kan actief zijn en tegelijk foutlogs schrijven. Het is daarom belangrijk de logs van de service te lezen om de werkelijke status ervan te begrijpen.

> **Voorbeeld van uitvoer voor `etcd` wanneer de service werkt**
>
> ```
>  1
>  2
>  3
>  4
>  5
>  6
>  7
>  8
>  9
> 10
> 11
> 12
> 13
> 14
> 15
> 16
> 17
> 18
> 19
> 20
> 21
> 22
> ```

> **Voorbeeld van uitvoer voor `etcd` wanneer de service in een foutstatus is**
>
> ```
>  1
>  2
>  3
>  4
>  5
>  6
>  7
>  8
>  9
> 10
> 11
> 12
> 13
> 14
> 15
> 16
> 17
> 18
> 19
> 20
> ```
>
> In de bovenstaande uitvoer heeft de service `etcd` de status `failed`, en de fout die het starten verhinderde, staat op regel 17: de service kan de inhoud van de map `/var/lib/etcd/cleanroom` niet lezen. Pas in dat geval [de machtigingen van de map](https://docs.cyberelements.io/bastion/4.6/nl/Installation/Dependencies/PostgreSQLCluster/Troubleshooting/EtcdDebug/#error-log-explanations) aan.

> **Voorbeeld van uitvoer voor `patroni` wanneer de service werkt**
>
> ```
>  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
> ```

> **Voorbeeld van uitvoer voor `patroni` wanneer de service in een foutstatus is**
>
> ```
>  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
> ```
>
> In het bovenstaande geval heeft de service de status `active (running)` zonder echt te werken: de logs tonen verschillende verbindingsfouten met `etcd`, dat `patroni` nodig heeft.
> In dit voorbeeld ligt de oorzaak niet noodzakelijk bij `patroni`, dat van `etcd` afhangt: los eerst de problemen met `etcd` op en controleer daarna opnieuw de status van `patroni`.

## Procedures voor probleemoplossing per service

Hieronder vindt u per service een procedure voor probleemoplossing. Als zowel `etcd` als `patroni` niet goed werken, begin dan met `etcd`.

- **[Probleemoplossing voor `etcd`](https://docs.cyberelements.io/bastion/4.6/nl/Installation/Dependencies/PostgreSQLCluster/Troubleshooting/EtcdDebug/)**

  ---

  Procedure die moet worden gevolgd wanneer de service `etcd` niet goed werkt.
- **[Probleemoplossing voor `patroni`](https://docs.cyberelements.io/bastion/4.6/nl/Installation/Dependencies/PostgreSQLCluster/Troubleshooting/PatroniDebug/)**

  ---

  Procedure die moet worden gevolgd wanneer de service `patroni` niet goed werkt.
