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

# Depanare `patroni`

> **Informație**
>
> Întreaga procedură trebuie efectuată ca `root`. Pentru a vă ridica privilegiile la `root`, puteți utiliza comanda `su -`.

> **Avertisment**
>
> Pentru a urma această procedură, trebuie să fi efectuat [configurările suplimentare pentru `patronictl`](https://docs.cyberelements.io/bastion/4.6/ro/Installation/Dependencies/PostgreSQLCluster/Installation/Install/#additional-configurations-for-patronictl).

`patroni` este un orchestrator de înaltă disponibilitate pentru PostgreSQL. Automatizează gestionarea unui cluster PostgreSQL, asigurând alegerea liderului, comutarea în caz de defecțiune și sincronizarea nodurilor atunci când survine un incident.

În clusterul PostgreSQL al CyberElements Bastion, `patroni` se bazează pe `etcd` pentru a stoca și a partaja starea clusterului. Monitorizează în permanență starea instanțelor PostgreSQL și se asigură că un singur nod este desemnat lider la un moment dat.

Dacă nodul lider se defectează, `patroni` orchestrează automat o alegere prin intermediul depozitului de configurare distribuit `etcd`, pentru a promova un nou lider și a menține disponibilitatea serviciului.

Prin urmare, `patroni` depinde de `etcd` și nu poate funcționa corect dacă `etcd` nu funcționează.

## Desincronizarea unui nod

Un nod al clusterului PostgreSQL se poate desincroniza uneori. Acest lucru este vizibil în rezultatul comenzii `patronictl -c /etc/patroni/config.yml topology`:

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

În coloana `TL`, nodul `PSQL_1` nu mai este pe același `TL` ca celelalte. Pentru ca clusterul să funcționeze, toate nodurile trebuie să fie pe același `TL`: o diferență indică faptul că unul dintre noduri este desincronizat.

În acest caz, rulați următoarea comandă pe nodul desincronizat:

```
1
```

Unde `<MEMBER_PATRONI>` este numele nodului desincronizat, așa cum apare în coloana `Member` a topologiei.

Dacă mai multe noduri sunt desincronizate, resincronizați toate nodurile care nu se află pe cel mai mare `TL`.

> **Avertisment**
>
> Dacă nodul desincronizat este nodul `Leader`, se pot pierde date. Acest lucru nu ar trebui să se întâmple niciodată: nodul `Leader` trebuie să se afle pe cel mai mare `TL`.

> **Exemplu**
>
> În rezultatul comenzii `patronictl -c /etc/patroni/config.yml topology` de mai sus, nodul `PSQL_1` este desincronizat. Pentru a-l resincroniza, utilizați următoarea comandă:
>
> ```
> 1
> ```

## Loguri

Întreaga procedură se bazează pe logurile serviciului `patroni`, pe care le obțineți cu comanda de mai jos:

```
1
```

> **Sfat**
>
> Pentru a urmări logurile în timp real, adăugați opțiunea `-f` la comandă:
>
> ```
> 1
> ```

> **Informație**
>
> Logurile `patroni` sunt disponibile și în `/var/log/syslog`.

## Explicarea logurilor de eroare

> **`ERROR: Request to server https://<PSQL_NODE_NAME>:2379 failed: MaxRetryError("HTTPSConnectionPool(host='<PSQL_NODE_NAME>', port=2379)`**
>
> Atunci când `etcd` nu funcționează sau nu poate fi accesat, `patroni` poate scrie următoarele erori:
>
> ```
> 1
> 2
> 3
> 4
> 5
> 6
> 7
> 8
> ```
>
> **`<PSQL_NODE_NAME>`**
>
> Numele unuia dintre nodurile clusterului PostgreSQL.
>
> În acest caz, trebuie să [depanați `etcd`](https://docs.cyberelements.io/bastion/4.6/ro/Installation/Dependencies/PostgreSQLCluster/Troubleshooting/EtcdDebug/).
