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

# Řešení potíží s clusterem PostgreSQL

> **Informace**
>
> Celý postup je nutné provádět jako `root`. Ke zvýšení oprávnění na úroveň `root` můžete použít příkaz `su -`.

> **Upozornění**
>
> Před provedením tohoto postupu musíte provést [doplňující konfigurace pro `patronictl`](https://docs.cyberelements.io/bastion/4.6/cs/Installation/Dependencies/PostgreSQLCluster/Installation/Install/#additional-configurations-for-patronictl).

Chyby připojení k databázi clusteru PostgreSQL platformy CyberElements Bastion mohou mít různé příčiny. Tato část představuje obecný postup řešení potíží, který je třeba přizpůsobit vašemu případu.

## Kontrola stavu clusteru

> **Informace**
>
> Kontrola stavu clusteru umožňuje rychle najít selhávající uzel nebo uzly.

Stav clusteru můžete zkontrolovat následujícím příkazem, který spusťte na každém uzlu clusteru PostgreSQL:

```
1
```

> **Příklad výstupu na funkční platformě**
>
> ```
> 1
> 2
> 3
> 4
> 5
> 6
> 7
> ```
>
> Ve výše uvedeném výstupu vše ukazuje na to, že cluster PostgreSQL funguje: zpoždění je u všech uzlů `Replica` 0 MB a všechny uzly jsou v seznamu se stavem `running`. Tento výstup musíte získat na všech uzlech, abyste potvrdili, že služby `patroni` a `etcd` fungují.

> **Příklad výstupu při problému s komunikací mezi uzly**
>
> ```
> 1
> 2
> 3
> 4
> 5
> 6
> 7
> ```
>
> Ve výše uvedeném výstupu je zpoždění 230 MB neobvyklé: mohlo by ukazovat na problém s komunikací mezi uzlem 3 a uzlem 1.
> Pokud problém přetrvává i po několika hodinách, potvrzuje to tento předpoklad.

> **Příklad výstupu, když uzel není správně spuštěn nebo zastaven**
>
> ```
> 1
> 2
> 3
> 4
> 5
> 6
> 7
> ```
>
> Ve výše uvedeném výstupu stav (sloupec `State`) ukazuje, že se uzel 1 spouští. Pokud stav `started` přetrvává několik minut, nebo dokonce hodin, může být na tomto uzlu problém se službou `patroni` nebo `etcd`.
> Uzel 2 je ve stavu `stopped`: je zastavený. Při selhání uzlu clusteru se tato informace zobrazí jen dočasně, než bude uzel ze seznamu odebrán.

> **Příklad výstupu při selhání `etcd` na aktuálním uzlu**
>
> ```
> 1
> 2
> 3
> ```
>
> Výše uvedený výstup ukazuje chybu připojení ke službě `etcd`, která brání získání stavu clusteru PostgreSQL.

> **Příklad výstupu, když je jeden z uzlů desynchronizovaný**
>
> ```
> 1
> 2
> 3
> 4
> 5
> 6
> 7
> ```
>
> Ve výše uvedeném výstupu už uzel `PSQL_1` nemá stejnou hodnotu `TL` jako ostatní. Aby cluster fungoval, musí mít všechny uzly stejnou hodnotu `TL`: rozdíl ukazuje, že jeden z uzlů je desynchronizovaný.
> Chcete-li tento problém vyřešit, proveďte postup popsaný v části [Desynchronizace uzlu](https://docs.cyberelements.io/bastion/4.6/cs/Installation/Dependencies/PostgreSQLCluster/Troubleshooting/PatroniDebug/#node-desynchronization).

## Kontrola stavu služeb

Po určení selhávajícího uzlu je nutné zjistit, která služba nefunguje správně. Dvě hlavní služby používané v clusteru PostgreSQL jsou `patroni` a `etcd`.

> **Informace**
>
> Služba `patroni` závisí na službě `etcd`: pokud `etcd` nefunguje, nebude fungovat ani `patroni`.

Chcete-li zjistit, která služba selhává, můžete spustit následující příkazy:

```
1
2
```

Tyto příkazy zobrazí stav služby spolu s jejími posledními 10 řádky logu.

> **Upozornění**
>
> Služba se stavem `active (running)` nemusí nutně fungovat: může běžet a přitom zapisovat chybové logy. Proto je důležité číst logy služby, abyste pochopili její skutečný stav.

> **Příklad výstupu pro `etcd`, když 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
> ```

> **Příklad výstupu pro `etcd`, když je služba v chybovém stavu**
>
> ```
>  1
>  2
>  3
>  4
>  5
>  6
>  7
>  8
>  9
> 10
> 11
> 12
> 13
> 14
> 15
> 16
> 17
> 18
> 19
> 20
> ```
>
> Ve výše uvedeném výstupu má služba `etcd` stav `failed` a chyba, která zabránila jejímu spuštění, je na řádku 17: služba nemůže číst obsah adresáře `/var/lib/etcd/cleanroom`. V takovém případě [upravte oprávnění k adresáři](https://docs.cyberelements.io/bastion/4.6/cs/Installation/Dependencies/PostgreSQLCluster/Troubleshooting/EtcdDebug/#error-log-explanations).

> **Příklad výstupu pro `patroni`, když 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
> ```

> **Příklad výstupu pro `patroni`, když je služba v chybovém stavu**
>
> ```
>  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
> ```
>
> Ve výše uvedeném případě má služba stav `active (running)`, aniž by skutečně fungovala: logy ukazují různé chyby připojení ke službě `etcd`, kterou služba `patroni` potřebuje.
> V tomto příkladu nemusí být chyba nutně na straně služby `patroni`: protože závisí na `etcd`, nejprve vyřešte problémy s `etcd` a poté znovu zkontrolujte stav služby `patroni`.

## Postupy řešení potíží se službami

Níže najdete pro každou službu jeden postup řešení potíží. Pokud nefungují správně `etcd` i `patroni`, začněte službou `etcd`.

- **[Řešení potíží s `etcd`](https://docs.cyberelements.io/bastion/4.6/cs/Installation/Dependencies/PostgreSQLCluster/Troubleshooting/EtcdDebug/)**

  ---

  Postup, který je třeba použít, když služba `etcd` nefunguje správně.
- **[Řešení potíží s `patroni`](https://docs.cyberelements.io/bastion/4.6/cs/Installation/Dependencies/PostgreSQLCluster/Troubleshooting/PatroniDebug/)**

  ---

  Postup, který je třeba použít, když služba `patroni` nefunguje správně.
