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

# PostgreSQL klasterio trikčių šalinimas

> **Informacija**
>
> Visą procedūrą reikia atlikti kaip `root`. Norėdami padidinti savo teises iki `root`, galite naudoti komandą `su -`.

> **Perspėjimas**
>
> Norėdami atlikti šią procedūrą, turite būti atlikę [papildomas `patronictl` konfigūracijas](https://docs.cyberelements.io/bastion/4.6/lt/Installation/Dependencies/PostgreSQLCluster/Installation/Install/#additional-configurations-for-patronictl).

Ryšio su CyberElements Bastion PostgreSQL klasterio duomenų baze klaidos gali turėti įvairių priežasčių. Šiame skyriuje pateikiamas bendras trikčių šalinimo metodas, kurį reikia pritaikyti savo atvejui.

## Klasterio būsenos tikrinimas

> **Informacija**
>
> Patikrinus klasterio būseną, galima greitai rasti sugedusį mazgą ar mazgus.

Klasterio būseną galite patikrinti šia komanda, kurią reikia paleisti kiekviename PostgreSQL klasterio mazge:

```
1
```

> **Veikiančios platformos išvesties pavyzdys**
>
> ```
> 1
> 2
> 3
> 4
> 5
> 6
> 7
> ```
>
> Aukščiau pateiktoje išvestyje viskas rodo, kad PostgreSQL klasteris veikia: visų `Replica` mazgų atsilikimas yra 0 MB, o visi mazgai yra sąraše su būsena `running`. Tokią išvestį turite gauti visuose mazguose, kad įsitikintumėte, jog `patroni` ir `etcd` veikia.

> **Išvesties pavyzdys, kai kyla ryšio tarp mazgų problema**
>
> ```
> 1
> 2
> 3
> 4
> 5
> 6
> 7
> ```
>
> Aukščiau pateiktoje išvestyje 230 MB atsilikimas yra neįprastas: jis gali rodyti ryšio tarp mazgo 3 ir mazgo 1 problemą.
> Jei problema neišnyksta po kelių valandų, tai patvirtina šią prielaidą.

> **Išvesties pavyzdys, kai mazgas netinkamai paleistas arba sustabdytas**
>
> ```
> 1
> 2
> 3
> 4
> 5
> 6
> 7
> ```
>
> Aukščiau pateiktoje išvestyje būsena (stulpelis `State`) rodo, kad mazgas 1 paleidžiamas. Jei būsena `started` išlieka kelias minutes ar net valandas, gali būti, kad tame mazge kilo `patroni` arba `etcd` problema.
> Mazgo 2 būsena yra `stopped`: jis sustabdytas. Sugedus klasterio mazgui, ši informacija rodoma tik laikinai, kol mazgas pašalinamas iš sąrašo.

> **Išvesties pavyzdys, kai dabartiniame mazge sugenda `etcd`**
>
> ```
> 1
> 2
> 3
> ```
>
> Aukščiau pateiktoje išvestyje rodoma ryšio su `etcd` klaida, dėl kurios negalima gauti PostgreSQL klasterio būsenos.

> **Išvesties pavyzdys, kai vienas iš mazgų nesinchronizuotas**
>
> ```
> 1
> 2
> 3
> 4
> 5
> 6
> 7
> ```
>
> Aukščiau pateiktoje išvestyje mazgas `PSQL_1` nebėra tame pačiame `TL` kaip kiti. Kad klasteris veiktų, visi mazgai turi būti tame pačiame `TL`: skirtumas rodo, kad vienas iš mazgų yra nesinchronizuotas.
> Norėdami išspręsti šią problemą, atlikite [mazgo desinchronizacijos](https://docs.cyberelements.io/bastion/4.6/lt/Installation/Dependencies/PostgreSQLCluster/Troubleshooting/PatroniDebug/#node-desynchronization) procedūrą.

## Paslaugų būsenos tikrinimas

Nustačius sugedusį mazgą, reikia nustatyti netinkamai veikiančią paslaugą. Dvi pagrindinės PostgreSQL klasteryje naudojamos paslaugos yra `patroni` ir `etcd`.

> **Informacija**
>
> Paslauga `patroni` priklauso nuo paslaugos `etcd`: jei `etcd` neveikia, neveiks ir `patroni`.

Norėdami nustatyti sugedusią paslaugą, galite paleisti šias komandas:

```
1
2
```

Šios komandos pateikia paslaugos būseną ir paskutines 10 jos žurnalo eilučių.

> **Perspėjimas**
>
> Paslauga, kurios būsena yra `active (running)`, nebūtinai veikia: ji gali būti vykdoma ir kartu rašyti klaidų žurnalo įrašus. Todėl svarbu perskaityti paslaugos žurnalus, kad suprastumėte tikrąją jos būseną.

> **`etcd` išvesties pavyzdys, kai paslauga veikia**
>
> ```
>  1
>  2
>  3
>  4
>  5
>  6
>  7
>  8
>  9
> 10
> 11
> 12
> 13
> 14
> 15
> 16
> 17
> 18
> 19
> 20
> 21
> 22
> ```

> **`etcd` išvesties pavyzdys, kai paslaugoje įvyko klaida**
>
> ```
>  1
>  2
>  3
>  4
>  5
>  6
>  7
>  8
>  9
> 10
> 11
> 12
> 13
> 14
> 15
> 16
> 17
> 18
> 19
> 20
> ```
>
> Aukščiau pateiktoje išvestyje paslaugos `etcd` būsena yra `failed`, o klaida, sutrukdžiusi jai pasileisti, yra 17 eilutėje: paslauga negali perskaityti katalogo `/var/lib/etcd/cleanroom` turinio. Tokiu atveju [pakoreguokite katalogo leidimus](https://docs.cyberelements.io/bastion/4.6/lt/Installation/Dependencies/PostgreSQLCluster/Troubleshooting/EtcdDebug/#error-log-explanations).

> **`patroni` išvesties pavyzdys, kai paslauga veikia**
>
> ```
>  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
> ```

> **`patroni` išvesties pavyzdys, kai paslaugoje įvyko klaida**
>
> ```
>  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
> ```
>
> Aukščiau pateiktu atveju paslaugos būsena yra `active (running)`, nors ji iš tikrųjų neveikia: žurnaluose matyti įvairios ryšio su `etcd`, kurios reikia `patroni`, klaidos.
> Šiame pavyzdyje `patroni` nebūtinai kaltas: kadangi jis priklauso nuo `etcd`, pirmiausia išspręskite `etcd` problemas, tada dar kartą patikrinkite `patroni` būseną.

## Paslaugų trikčių šalinimo procedūros

Toliau pateikiama po vieną trikčių šalinimo procedūrą kiekvienai paslaugai. Jei netinkamai veikia ir `etcd`, ir `patroni`, pradėkite nuo `etcd`.

- **[`etcd` trikčių šalinimas](https://docs.cyberelements.io/bastion/4.6/lt/Installation/Dependencies/PostgreSQLCluster/Troubleshooting/EtcdDebug/)**

  ---

  Procedūra, kurią reikia atlikti, kai paslauga `etcd` veikia netinkamai.
- **[`patroni` trikčių šalinimas](https://docs.cyberelements.io/bastion/4.6/lt/Installation/Dependencies/PostgreSQLCluster/Troubleshooting/PatroniDebug/)**

  ---

  Procedūra, kurią reikia atlikti, kai paslauga `patroni` veikia netinkamai.
