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

# Depanarea clusterului PostgreSQL

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

Erorile de conexiune la baza de date a clusterului PostgreSQL al CyberElements Bastion pot avea diverse cauze. Această secțiune prezintă o metodă generală de depanare, care trebuie adaptată la cazul dumneavoastră.

## Verificarea stării clusterului

> **Informație**
>
> Verificarea stării clusterului permite localizarea rapidă a nodului sau a nodurilor defecte.

Puteți verifica starea clusterului cu următoarea comandă, care trebuie executată pe fiecare nod al clusterului PostgreSQL:

```
1
```

> **Exemplu de rezultat pe o platformă funcțională**
>
> ```
> 1
> 2
> 3
> 4
> 5
> 6
> 7
> ```
>
> În rezultatul de mai sus, totul indică faptul că clusterul PostgreSQL funcționează: decalajul (lag) este de 0 MB pentru toate nodurile `Replica`, iar toate nodurile figurează în listă, cu starea `running`. Trebuie să obțineți acest rezultat pe toate nodurile pentru a confirma că `patroni` și `etcd` funcționează.

> **Exemplu de rezultat atunci când există o problemă de comunicare între noduri**
>
> ```
> 1
> 2
> 3
> 4
> 5
> 6
> 7
> ```
>
> În rezultatul de mai sus, decalajul de 230 MB este anormal: ar putea indica o problemă de comunicare între nodul 3 și nodul 1.
> Dacă problema persistă după câteva ore, acest lucru o confirmă.

> **Exemplu de rezultat atunci când un nod nu este pornit sau oprit corect**
>
> ```
> 1
> 2
> 3
> 4
> 5
> 6
> 7
> ```
>
> În rezultatul de mai sus, starea (coloana `State`) indică faptul că nodul 1 este în curs de pornire. Dacă starea `started` persistă mai multe minute, sau chiar ore, poate exista o problemă cu `patroni` sau `etcd` pe acel nod.
> Nodul 2 este în starea `stopped`: este oprit. Atunci când un nod al clusterului se defectează, această informație este afișată doar temporar, înainte ca nodul să fie eliminat din listă.

> **Exemplu de rezultat atunci când `etcd` se defectează pe nodul curent**
>
> ```
> 1
> 2
> 3
> ```
>
> Rezultatul de mai sus indică o eroare de conexiune la `etcd`, care împiedică obținerea stării clusterului PostgreSQL.

> **Exemplu de rezultat atunci când unul dintre noduri este desincronizat**
>
> ```
> 1
> 2
> 3
> 4
> 5
> 6
> 7
> ```
>
> În rezultatul de mai sus, 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.
> Pentru a rezolva această problemă, urmați procedura descrisă în [desincronizarea unui nod](https://docs.cyberelements.io/bastion/4.6/ro/Installation/Dependencies/PostgreSQLCluster/Troubleshooting/PatroniDebug/#node-desynchronization).

## Verificarea stării serviciilor

Odată identificat nodul defect, trebuie să identificați serviciul care funcționează defectuos. Cele două servicii principale utilizate în clusterul PostgreSQL sunt `patroni` și `etcd`.

> **Informație**
>
> Serviciul `patroni` depinde de serviciul `etcd`: dacă `etcd` nu funcționează, nici `patroni` nu va funcționa.

Pentru a identifica serviciul defect, puteți executa următoarele comenzi:

```
1
2
```

Aceste comenzi afișează starea serviciului, împreună cu ultimele sale 10 linii de log.

> **Avertisment**
>
> Un serviciu cu starea `active (running)` nu funcționează neapărat: poate rula în timp ce scrie loguri de eroare. Este deci important să citiți logurile serviciului pentru a înțelege starea sa reală.

> **Exemplu de rezultat pentru `etcd` atunci când serviciul funcționează**
>
> ```
>  1
>  2
>  3
>  4
>  5
>  6
>  7
>  8
>  9
> 10
> 11
> 12
> 13
> 14
> 15
> 16
> 17
> 18
> 19
> 20
> 21
> 22
> ```

> **Exemplu de rezultat pentru `etcd` atunci când serviciul este în eroare**
>
> ```
>  1
>  2
>  3
>  4
>  5
>  6
>  7
>  8
>  9
> 10
> 11
> 12
> 13
> 14
> 15
> 16
> 17
> 18
> 19
> 20
> ```
>
> În rezultatul de mai sus, serviciul `etcd` are starea `failed`, iar eroarea care l-a împiedicat să pornească este cea de pe linia 17: serviciul nu poate citi conținutul directorului `/var/lib/etcd/cleanroom`. În acest caz, [ajustați permisiunile directorului](https://docs.cyberelements.io/bastion/4.6/ro/Installation/Dependencies/PostgreSQLCluster/Troubleshooting/EtcdDebug/#error-log-explanations).

> **Exemplu de rezultat pentru `patroni` atunci când serviciul funcționează**
>
> ```
>  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
> ```

> **Exemplu de rezultat pentru `patroni` atunci când serviciul este în eroare**
>
> ```
>  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
> ```
>
> În cazul de mai sus, serviciul are starea `active (running)` fără a funcționa efectiv: logurile arată diverse erori de conexiune la `etcd`, de care `patroni` are nevoie.
> În acest exemplu, `patroni` nu este neapărat cauza: deoarece depinde de `etcd`, remediați mai întâi problemele legate de `etcd`, apoi verificați din nou starea serviciului `patroni`.

## Proceduri de depanare a serviciilor

Mai jos găsiți câte o procedură de depanare pentru fiecare serviciu. Dacă atât `etcd`, cât și `patroni` funcționează defectuos, începeți cu `etcd`.

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

  ---

  Procedura de urmat atunci când serviciul `etcd` funcționează defectuos.
- **[Depanare `patroni`](https://docs.cyberelements.io/bastion/4.6/ro/Installation/Dependencies/PostgreSQLCluster/Troubleshooting/PatroniDebug/)**

  ---

  Procedura de urmat atunci când serviciul `patroni` funcționează defectuos.
