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

# Probleemoplossing voor `patroni`

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

`patroni` is een orchestrator voor hoge beschikbaarheid voor PostgreSQL. Het automatiseert het beheer van een PostgreSQL-cluster door bij een incident de verkiezing van de leader, de failover en de synchronisatie van de nodes af te handelen.

In de PostgreSQL-cluster van CyberElements Bastion steunt `patroni` op `etcd` om de status van de cluster op te slaan en te delen. Het bewaakt voortdurend de status van de PostgreSQL-instanties en zorgt ervoor dat er op elk moment slechts één node als leader is aangewezen.

Als de leader-node uitvalt, orkestreert `patroni` automatisch een verkiezing via de gedistribueerde configuratieopslag `etcd`, om een nieuwe leader te promoveren en de service beschikbaar te houden.

`patroni` is dus afhankelijk van `etcd` en kan niet correct werken als `etcd` niet werkt.

## Desynchronisatie van een node

Een node van de PostgreSQL-cluster kan soms gedesynchroniseerd raken. Dit is zichtbaar in de uitvoer van de opdracht `patronictl -c /etc/patroni/config.yml topology`:

```
1
2
3
4
5
6
7
```

In de kolom `TL` 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.

Voer in dat geval de volgende opdracht uit op de gedesynchroniseerde node:

```
1
```

Waarbij `<MEMBER_PATRONI>` de naam is van de gedesynchroniseerde node, zoals weergegeven in de kolom `Member` van de topologie.

Als meerdere nodes gedesynchroniseerd zijn, resynchroniseer dan alle nodes die niet op de hoogste `TL` staan.

> **Waarschuwing**
>
> Als de gedesynchroniseerde node de node `Leader` is, kunnen er gegevens verloren gaan. Dit zou nooit mogen gebeuren: de node `Leader` hoort op de hoogste `TL` te staan.

> **Voorbeeld**
>
> In de uitvoer van de bovenstaande opdracht `patronictl -c /etc/patroni/config.yml topology` is de node `PSQL_1` gedesynchroniseerd. Gebruik de volgende opdracht om deze te resynchroniseren:
>
> ```
> 1
> ```

## Logs

De volledige procedure steunt op de logs van de service `patroni`, die u met de onderstaande opdracht opvraagt:

```
1
```

> **Tip**
>
> Voeg de optie `-f` aan de opdracht toe om de logs live te volgen:
>
> ```
> 1
> ```

> **Informatie**
>
> De logs van `patroni` zijn ook beschikbaar in `/var/log/syslog`.

## Uitleg bij de foutlogs

> **`ERROR: Request to server https://<PSQL_NODE_NAME>:2379 failed: MaxRetryError("HTTPSConnectionPool(host='<PSQL_NODE_NAME>', port=2379)`**
>
> Wanneer `etcd` niet werkt of niet bereikbaar is, kan `patroni` de volgende fouten schrijven:
>
> ```
> 1
> 2
> 3
> 4
> 5
> 6
> 7
> 8
> ```
>
> **`<PSQL_NODE_NAME>`**
>
> Naam van een van de nodes van de PostgreSQL-cluster.
>
> In dit geval moet u [de problemen met `etcd` oplossen](https://docs.cyberelements.io/bastion/4.6/nl/Installation/Dependencies/PostgreSQLCluster/Troubleshooting/EtcdDebug/).
