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

# PostgreSQL-i klastri tõrkeotsing

> **Teave**
>
> Kogu protseduur tuleb läbi viia kasutajana `root`. Oma privileegide tõstmiseks `root`-i tasemele saate kasutada käsku `su -`.

> **Hoiatus**
>
> Selle protseduuri järgimiseks peate olema teinud [`patronictl`-i lisakonfiguratsioonid](https://docs.cyberelements.io/bastion/4.6/et/Installation/Dependencies/PostgreSQLCluster/Installation/Install/#additional-configurations-for-patronictl).

CyberElements Bastion lahenduse PostgreSQL-i klastri andmebaasiga ühenduse loomise tõrgetel võib olla mitmesuguseid põhjusi. Selles peatükis esitatakse üldine tõrkeotsingu meetod, mida tuleb kohandada teie olukorrale.

## Klastri oleku kontrollimine

> **Teave**
>
> Klastri oleku kontrollimine aitab kiiresti leida tõrkuva sõlme või sõlmed.

Klastri olekut saate kontrollida järgmise käsuga, mis tuleb käivitada PostgreSQL-i klastri igas sõlmes:

```
1
```

> **Väljundi näide toimival platvormil**
>
> ```
> 1
> 2
> 3
> 4
> 5
> 6
> 7
> ```
>
> Ülaltoodud väljundis viitab kõik sellele, et PostgreSQL-i klaster töötab: mahajäämus on kõigi `Replica`-sõlmede puhul 0 MB ja kõik sõlmed on loendis olekuga `running`. Selle väljundi peate saama kõigis sõlmedes, et kinnitada, et `patroni` ja `etcd` töötavad.

> **Väljundi näide, kui sõlmede vahel on sideprobleem**
>
> ```
> 1
> 2
> 3
> 4
> 5
> 6
> 7
> ```
>
> Ülaltoodud väljundis on 230 MB mahajäämus ebanormaalne: see võib viidata sideprobleemile sõlme 3 ja sõlme 1 vahel.
> Kui probleem püsib ka mitme tunni pärast, kinnitab see seda.

> **Väljundi näide, kui sõlm pole korralikult käivitatud või peatatud**
>
> ```
> 1
> 2
> 3
> 4
> 5
> 6
> 7
> ```
>
> Ülaltoodud väljundis näitab olek (veerg `State`), et sõlm 1 on käivitumas. Kui olek `started` püsib mitu minutit või isegi tunde, võib selle sõlme teenusega `patroni` või `etcd` olla probleem.
> Sõlm 2 on olekus `stopped`: see on peatatud. Kui klastri sõlm tõrgub, kuvatakse seda teavet vaid ajutiselt, enne kui sõlm loendist eemaldatakse.

> **Väljundi näide, kui `etcd` tõrgub praeguses sõlmes**
>
> ```
> 1
> 2
> 3
> ```
>
> Ülaltoodud väljund näitab ühendusetõrget teenusega `etcd`, mis takistab PostgreSQL-i klastri oleku hankimist.

> **Väljundi näide, kui üks sõlmedest on sünkroonist väljas**
>
> ```
> 1
> 2
> 3
> 4
> 5
> 6
> 7
> ```
>
> Ülaltoodud väljundis pole sõlm `PSQL_1` enam samal `TL`-ajateljel kui teised. Klastri toimimiseks peavad kõik sõlmed olema samal `TL`-ajateljel: erinevus näitab, et üks sõlmedest on sünkroonist väljas.
> Selle probleemi lahendamiseks järgige [sõlme sünkroonist väljumise](https://docs.cyberelements.io/bastion/4.6/et/Installation/Dependencies/PostgreSQLCluster/Troubleshooting/PatroniDebug/#node-desynchronization) protseduuri.

## Teenuste oleku kontrollimine

Kui tõrkuv sõlm on tuvastatud, peate tuvastama valesti töötava teenuse. PostgreSQL-i klastris kasutatavad kaks peamist teenust on `patroni` ja `etcd`.

> **Teave**
>
> Teenus `patroni` sõltub teenusest `etcd`: kui `etcd` ei tööta, ei tööta ka `patroni`.

Tõrkuva teenuse tuvastamiseks saate käivitada järgmised käsud:

```
1
2
```

Need käsud näitavad teenuse olekut koos selle viimase 10 logireaga.

> **Hoiatus**
>
> Teenus olekuga `active (running)` ei pruugi tegelikult töötada: see võib olla käimas ja samal ajal tõrkelogisid kirjutada. Seetõttu on oluline lugeda teenuse logisid, et mõista selle tegelikku olekut.

> **Teenuse `etcd` väljundi näide, kui teenus töötab**
>
> ```
>  1
>  2
>  3
>  4
>  5
>  6
>  7
>  8
>  9
> 10
> 11
> 12
> 13
> 14
> 15
> 16
> 17
> 18
> 19
> 20
> 21
> 22
> ```

> **Teenuse `etcd` väljundi näide, kui teenuses on tõrge**
>
> ```
>  1
>  2
>  3
>  4
>  5
>  6
>  7
>  8
>  9
> 10
> 11
> 12
> 13
> 14
> 15
> 16
> 17
> 18
> 19
> 20
> ```
>
> Ülaltoodud väljundis on teenuse `etcd` olek `failed` ja selle käivitumist takistanud tõrge on real 17: teenus ei saa lugeda kataloogi `/var/lib/etcd/cleanroom` sisu. Sel juhul [kohandage kataloogi lubasid](https://docs.cyberelements.io/bastion/4.6/et/Installation/Dependencies/PostgreSQLCluster/Troubleshooting/EtcdDebug/#error-log-explanations).

> **Teenuse `patroni` väljundi näide, kui teenus töötab**
>
> ```
>  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
> ```

> **Teenuse `patroni` väljundi näide, kui teenuses on tõrge**
>
> ```
>  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
> ```
>
> Ülaltoodud juhul on teenuse olek `active (running)`, kuigi see tegelikult ei tööta: logid näitavad mitmesuguseid ühendusetõrkeid teenusega `etcd`, mida `patroni` vajab.
> Selles näites ei pruugi süü olla teenusel `patroni`: kuna see sõltub teenusest `etcd`, parandage esmalt teenuse `etcd` probleemid ja seejärel kontrollige uuesti teenuse `patroni` olekut.

## Teenuste tõrkeotsingu protseduurid

Allpool on iga teenuse jaoks üks tõrkeotsingu protseduur. Kui nii `etcd` kui ka `patroni` töötavad valesti, alustage teenusest `etcd`.

- **[Teenuse `etcd` tõrkeotsing](https://docs.cyberelements.io/bastion/4.6/et/Installation/Dependencies/PostgreSQLCluster/Troubleshooting/EtcdDebug/)**

  ---

  Protseduur, mida järgida, kui teenus `etcd` töötab valesti.
- **[Teenuse `patroni` tõrkeotsing](https://docs.cyberelements.io/bastion/4.6/et/Installation/Dependencies/PostgreSQLCluster/Troubleshooting/PatroniDebug/)**

  ---

  Protseduur, mida järgida, kui teenus `patroni` töötab valesti.
