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

# Riešenie problémov s clusterom PostgreSQL

> **Informácie**
>
> Celý postup je potrebné vykonať ako `root`. Na zvýšenie oprávnení na úroveň `root` môžete použiť príkaz `su -`.

> **Upozornenie**
>
> Na vykonanie tohto postupu musíte mať vykonané [dodatočné konfigurácie pre `patronictl`](https://docs.cyberelements.io/bastion/4.6/sk/Installation/Dependencies/PostgreSQLCluster/Installation/Install/#additional-configurations-for-patronictl).

Chyby pripojenia k databáze clustera PostgreSQL CyberElements Bastion môžu mať rôzne príčiny. Táto časť predstavuje všeobecný postup riešenia problémov, ktorý treba prispôsobiť vášmu prípadu.

## Kontrola stavu clustera

> **Informácie**
>
> Kontrola stavu clustera umožňuje rýchlo nájsť zlyhávajúci uzol alebo uzly.

Stav clustera môžete skontrolovať nasledujúcim príkazom, ktorý treba spustiť na každom uzle clustera PostgreSQL:

```
1
```

> **Príklad výstupu na funkčnej platforme**
>
> ```
> 1
> 2
> 3
> 4
> 5
> 6
> 7
> ```
>
> Vo výstupe vyššie všetko naznačuje, že cluster PostgreSQL funguje: oneskorenie je 0 MB pre všetky uzly `Replica` a všetky uzly sú v zozname so stavom `running`. Tento výstup musíte dostať na všetkých uzloch, aby ste potvrdili, že `patroni` a `etcd` fungujú.

> **Príklad výstupu pri probléme s komunikáciou medzi uzlami**
>
> ```
> 1
> 2
> 3
> 4
> 5
> 6
> 7
> ```
>
> Vo výstupe vyššie je oneskorenie 230 MB abnormálne: mohlo by naznačovať problém s komunikáciou medzi uzlom 3 a uzlom 1.
> Ak problém pretrváva aj po niekoľkých hodinách, potvrdzuje to túto domnienku.

> **Príklad výstupu, keď uzol nie je správne spustený alebo zastavený**
>
> ```
> 1
> 2
> 3
> 4
> 5
> 6
> 7
> ```
>
> Vo výstupe vyššie stav (stĺpec `State`) uvádza, že uzol 1 sa spúšťa. Ak stav `started` pretrváva niekoľko minút alebo dokonca hodín, na tomto uzle môže byť problém s `patroni` alebo `etcd`.
> Uzol 2 je v stave `stopped`: je zastavený. Keď uzol clustera zlyhá, táto informácia sa zobrazí len dočasne, kým sa uzol neodstráni zo zoznamu.

> **Príklad výstupu, keď na aktuálnom uzle zlyhá `etcd`**
>
> ```
> 1
> 2
> 3
> ```
>
> Výstup vyššie uvádza chybu pripojenia k `etcd`, ktorá znemožňuje získať stav clustera PostgreSQL.

> **Príklad výstupu, keď jeden z uzlov nie je synchronizovaný**
>
> ```
> 1
> 2
> 3
> 4
> 5
> 6
> 7
> ```
>
> Vo výstupe vyššie uzol `PSQL_1` už nie je na rovnakej hodnote `TL` ako ostatné. Aby cluster fungoval, všetky uzly musia byť na rovnakej hodnote `TL`: rozdiel naznačuje, že jeden z uzlov nie je synchronizovaný.
> Na vyriešenie tohto problému použite postup opísaný v časti [Desynchronizácia uzla](https://docs.cyberelements.io/bastion/4.6/sk/Installation/Dependencies/PostgreSQLCluster/Troubleshooting/PatroniDebug/#node-desynchronization).

## Kontrola stavu služieb

Po identifikácii zlyhávajúceho uzla musíte identifikovať nesprávne fungujúcu službu. Dve hlavné služby používané v clusteri PostgreSQL sú `patroni` a `etcd`.

> **Informácie**
>
> Služba `patroni` závisí od služby `etcd`: ak `etcd` nefunguje, nebude fungovať ani `patroni`.

Na identifikáciu zlyhávajúcej služby môžete spustiť nasledujúce príkazy:

```
1
2
```

Tieto príkazy uvádzajú stav služby spolu s jej poslednými 10 riadkami logu.

> **Upozornenie**
>
> Služba so stavom `active (running)` nemusí nevyhnutne fungovať: môže byť spustená a pritom zapisovať chybové logy. Preto je dôležité prečítať si logy služby, aby ste pochopili jej skutočný stav.

> **Príklad výstupu pre `etcd`, keď služba funguje**
>
> ```
>  1
>  2
>  3
>  4
>  5
>  6
>  7
>  8
>  9
> 10
> 11
> 12
> 13
> 14
> 15
> 16
> 17
> 18
> 19
> 20
> 21
> 22
> ```

> **Príklad výstupu pre `etcd`, keď je služba v chybovom stave**
>
> ```
>  1
>  2
>  3
>  4
>  5
>  6
>  7
>  8
>  9
> 10
> 11
> 12
> 13
> 14
> 15
> 16
> 17
> 18
> 19
> 20
> ```
>
> Vo výstupe vyššie má služba `etcd` stav `failed` a chyba, ktorá zabránila jej spusteniu, je na riadku 17: služba nemôže čítať obsah adresára `/var/lib/etcd/cleanroom`. V takom prípade [upravte povolenia adresára](https://docs.cyberelements.io/bastion/4.6/sk/Installation/Dependencies/PostgreSQLCluster/Troubleshooting/EtcdDebug/#error-log-explanations).

> **Príklad výstupu pre `patroni`, keď služba funguje**
>
> ```
>  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
> ```

> **Príklad výstupu pre `patroni`, keď je služba v chybovom stave**
>
> ```
>  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 uvedenom prípade má služba stav `active (running)`, no v skutočnosti nefunguje: logy ukazujú rôzne chyby pripojenia k `etcd`, ktorý `patroni` potrebuje.
> V tomto príklade nemusí byť chyba nevyhnutne v `patroni`: keďže závisí od `etcd`, najprv vyriešte problémy s `etcd` a potom znova skontrolujte stav `patroni`.

## Postupy riešenia problémov so službami

Nižšie nájdete pre každú službu jeden postup riešenia problémov. Ak nesprávne fungujú `etcd` aj `patroni`, začnite s `etcd`.

- **[Riešenie problémov s `etcd`](https://docs.cyberelements.io/bastion/4.6/sk/Installation/Dependencies/PostgreSQLCluster/Troubleshooting/EtcdDebug/)**

  ---

  Postup, ktorý treba použiť, keď služba `etcd` nefunguje správne.
- **[Riešenie problémov s `patroni`](https://docs.cyberelements.io/bastion/4.6/sk/Installation/Dependencies/PostgreSQLCluster/Troubleshooting/PatroniDebug/)**

  ---

  Postup, ktorý treba použiť, keď služba `patroni` nefunguje správne.
