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

# Odpravljanje težav z gručo PostgreSQL

> **Informacije**
>
> Celoten postopek je treba izvesti kot `root`. Za dvig privilegijev na raven `root` lahko uporabite ukaz `su -`.

> **Opozorilo**
>
> Za izvedbo tega postopka morate predhodno izvesti [dodatne konfiguracije za `patronictl`](https://docs.cyberelements.io/bastion/4.6/sl/Installation/Dependencies/PostgreSQLCluster/Installation/Install/#additional-configurations-for-patronictl).

Napake pri povezovanju z zbirko podatkov gruče PostgreSQL za CyberElements Bastion imajo lahko različne vzroke. To poglavje predstavlja splošen postopek odpravljanja težav, ki ga prilagodite svojemu primeru.

## Preverjanje stanja gruče

> **Informacije**
>
> S preverjanjem stanja gruče hitro najdete vozlišče ali vozlišča, ki ne delujejo.

Stanje gruče lahko preverite z naslednjim ukazom, ki ga zaženete na vsakem vozlišču gruče PostgreSQL:

```
1
```

> **Primer izpisa na delujoči platformi**
>
> ```
> 1
> 2
> 3
> 4
> 5
> 6
> 7
> ```
>
> V zgornjem izpisu vse kaže, da gruča PostgreSQL deluje: zaostanek je 0 MB za vsa vozlišča `Replica`, vsa vozlišča pa so na seznamu s stanjem `running`. Ta izpis morate dobiti na vseh vozliščih, da potrdite, da `patroni` in `etcd` delujeta.

> **Primer izpisa ob težavi s komunikacijo med vozlišči**
>
> ```
> 1
> 2
> 3
> 4
> 5
> 6
> 7
> ```
>
> V zgornjem izpisu je zaostanek 230 MB nenormalen: lahko kaže na težavo s komunikacijo med vozliščem 3 in vozliščem 1.
> Če težava ostane tudi po več urah, je to potrjeno.

> **Primer izpisa, ko vozlišče ni pravilno zagnano ali ustavljeno**
>
> ```
> 1
> 2
> 3
> 4
> 5
> 6
> 7
> ```
>
> V zgornjem izpisu stanje (stolpec `State`) kaže, da se vozlišče 1 zaganja. Če stanje `started` traja več minut ali celo ur, je morda težava s `patroni` ali `etcd` na tem vozlišču.
> Vozlišče 2 je v stanju `stopped`: je ustavljeno. Ob okvari vozlišča gruče je ta informacija prikazana le začasno, preden je vozlišče odstranjeno s seznama.

> **Primer izpisa, ko `etcd` odpove na trenutnem vozlišču**
>
> ```
> 1
> 2
> 3
> ```
>
> Zgornji izpis kaže napako pri povezovanju z `etcd`, ki preprečuje pridobivanje stanja gruče PostgreSQL.

> **Primer izpisa, ko eno od vozlišč ni sinhronizirano**
>
> ```
> 1
> 2
> 3
> 4
> 5
> 6
> 7
> ```
>
> V zgornjem izpisu vozlišče `PSQL_1` nima več enake vrednosti `TL` kot ostala. Za delovanje gruče morajo imeti vsa vozlišča enako vrednost `TL`: razlika pomeni, da eno od vozlišč ni sinhronizirano.
> Težavo odpravite po postopku [desinhronizacije vozlišča](https://docs.cyberelements.io/bastion/4.6/sl/Installation/Dependencies/PostgreSQLCluster/Troubleshooting/PatroniDebug/#node-desynchronization).

## Preverjanje stanja storitev

Ko ugotovite, katero vozlišče ne deluje, morate ugotoviti, katera storitev ne deluje pravilno. Glavni storitvi, ki se uporabljata v gruči PostgreSQL, sta `patroni` in `etcd`.

> **Informacije**
>
> Storitev `patroni` je odvisna od storitve `etcd`: če `etcd` ne deluje, tudi `patroni` ne bo deloval.

Za ugotovitev storitve, ki ne deluje, lahko zaženete naslednje ukaze:

```
1
2
```

Ti ukazi prikažejo stanje storitve skupaj z zadnjimi 10 vrsticami njenega dnevnika.

> **Opozorilo**
>
> Storitev s stanjem `active (running)` ne deluje nujno pravilno: lahko se izvaja in hkrati zapisuje dnevnike napak. Zato je pomembno prebrati dnevnike storitve, da razumete njeno dejansko stanje.

> **Primer izpisa za `etcd`, ko storitev deluje**
>
> ```
>  1
>  2
>  3
>  4
>  5
>  6
>  7
>  8
>  9
> 10
> 11
> 12
> 13
> 14
> 15
> 16
> 17
> 18
> 19
> 20
> 21
> 22
> ```

> **Primer izpisa za `etcd`, ko je storitev v stanju napake**
>
> ```
>  1
>  2
>  3
>  4
>  5
>  6
>  7
>  8
>  9
> 10
> 11
> 12
> 13
> 14
> 15
> 16
> 17
> 18
> 19
> 20
> ```
>
> V zgornjem izpisu ima storitev `etcd` stanje `failed`, napaka, ki je preprečila njen zagon, pa je v vrstici 17: storitev ne more prebrati vsebine mape `/var/lib/etcd/cleanroom`. V tem primeru [prilagodite dovoljenja za mapo](https://docs.cyberelements.io/bastion/4.6/sl/Installation/Dependencies/PostgreSQLCluster/Troubleshooting/EtcdDebug/#error-log-explanations).

> **Primer izpisa za `patroni`, ko storitev deluje**
>
> ```
>  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
> ```

> **Primer izpisa za `patroni`, ko je storitev v stanju napake**
>
> ```
>  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
> ```
>
> V zgornjem primeru ima storitev stanje `active (running)`, čeprav dejansko ne deluje: dnevniki kažejo različne napake pri povezovanju z `etcd`, ki ga `patroni` potrebuje.
> V tem primeru `patroni` ni nujno vzrok težave: ker je odvisen od `etcd`, najprej odpravite težave z `etcd` in nato znova preverite stanje `patroni`.

## Postopki odpravljanja težav s storitvami

Spodaj je za vsako storitev po en postopek odpravljanja težav. Če nepravilno delujeta tako `etcd` kot `patroni`, začnite z `etcd`.

- **[Odpravljanje težav z `etcd`](https://docs.cyberelements.io/bastion/4.6/sl/Installation/Dependencies/PostgreSQLCluster/Troubleshooting/EtcdDebug/)**

  ---

  Postopek, ki ga izvedete, ko storitev `etcd` ne deluje pravilno.
- **[Odpravljanje težav s `patroni`](https://docs.cyberelements.io/bastion/4.6/sl/Installation/Dependencies/PostgreSQLCluster/Troubleshooting/PatroniDebug/)**

  ---

  Postopek, ki ga izvedete, ko storitev `patroni` ne deluje pravilno.
