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

# PostgreSQL klastera problēmu novēršana

> **Informācija**
>
> Visa procedūra jāveic kā `root`. Lai paaugstinātu savas privilēģijas līdz `root`, varat izmantot komandu `su -`.

> **Brīdinājums**
>
> Lai veiktu šo procedūru, iepriekš ir jāveic [`patronictl` papildu konfigurācijas](https://docs.cyberelements.io/bastion/4.6/lv/Installation/Dependencies/PostgreSQLCluster/Installation/Install/#additional-configurations-for-patronictl).

Savienojuma kļūdām ar CyberElements Bastion PostgreSQL klastera datu bāzi var būt dažādi iemesli. Šajā nodaļā aprakstīta vispārīga problēmu novēršanas metode, kas jāpielāgo jūsu situācijai.

## Klastera statusa pārbaude

> **Informācija**
>
> Klastera statusa pārbaude ļauj ātri atrast kļūmi piedzīvojušo mezglu vai mezglus.

Klastera statusu varat pārbaudīt ar šo komandu, kas jāizpilda katrā PostgreSQL klastera mezglā:

```
1
```

> **Izvades piemērs darbojošā platformā**
>
> ```
> 1
> 2
> 3
> 4
> 5
> 6
> 7
> ```
>
> Iepriekš redzamajā izvadē viss liecina, ka PostgreSQL klasteris darbojas: visiem `Replica` mezgliem aizkave ir 0 MB, un visi mezgli ir sarakstā ar statusu `running`. Šāda izvade jāiegūst visos mezglos, lai apstiprinātu, ka `patroni` un `etcd` darbojas.

> **Izvades piemērs, ja starp mezgliem ir saziņas problēma**
>
> ```
> 1
> 2
> 3
> 4
> 5
> 6
> 7
> ```
>
> Iepriekš redzamajā izvadē 230 MB aizkave ir neparasta: tā var norādīt uz saziņas problēmu starp mezglu 3 un mezglu 1.
> Ja problēma saglabājas arī pēc vairākām stundām, tas to apstiprina.

> **Izvades piemērs, ja mezgls nav pareizi startēts vai apturēts**
>
> ```
> 1
> 2
> 3
> 4
> 5
> 6
> 7
> ```
>
> Iepriekš redzamajā izvadē stāvoklis (kolonna `State`) norāda, ka mezgls 1 tiek startēts. Ja statuss `started` saglabājas vairākas minūtes vai pat stundas, iespējams, šajā mezglā ir problēma ar `patroni` vai `etcd`.
> Mezgls 2 ir stāvoklī `stopped`: tas ir apturēts. Ja klastera mezglam rodas kļūme, šī informācija tiek rādīta tikai īslaicīgi, pirms mezgls tiek noņemts no saraksta.

> **Izvades piemērs, ja pašreizējā mezglā rodas `etcd` kļūme**
>
> ```
> 1
> 2
> 3
> ```
>
> Iepriekš redzamā izvade norāda uz savienojuma kļūdu ar `etcd`, kas neļauj izgūt PostgreSQL klastera statusu.

> **Izvades piemērs, ja kāds no mezgliem nav sinhronizēts**
>
> ```
> 1
> 2
> 3
> 4
> 5
> 6
> 7
> ```
>
> Iepriekš redzamajā izvadē mezgls `PSQL_1` vairs nav tajā pašā `TL` kā pārējie. Lai klasteris darbotos, visiem mezgliem jābūt tajā pašā `TL`: atšķirība norāda, ka kāds no mezgliem nav sinhronizēts.
> Lai novērstu šo problēmu, izpildiet [mezgla desinhronizācijas](https://docs.cyberelements.io/bastion/4.6/lv/Installation/Dependencies/PostgreSQLCluster/Troubleshooting/PatroniDebug/#node-desynchronization) procedūru.

## Pakalpojumu statusa pārbaude

Kad kļūmi piedzīvojušais mezgls ir identificēts, ir jāidentificē nepareizi strādājošais pakalpojums. Divi galvenie PostgreSQL klasterī izmantotie pakalpojumi ir `patroni` un `etcd`.

> **Informācija**
>
> Pakalpojums `patroni` ir atkarīgs no pakalpojuma `etcd`: ja `etcd` nedarbojas, nedarbosies arī `patroni`.

Lai identificētu kļūdaino pakalpojumu, varat izpildīt šīs komandas:

```
1
2
```

Šīs komandas parāda pakalpojuma statusu, kā arī tā pēdējās 10 žurnāla rindas.

> **Brīdinājums**
>
> Pakalpojums ar statusu `active (running)` ne vienmēr darbojas pareizi: tas var darboties, vienlaikus ierakstot kļūdu žurnālus. Tāpēc ir svarīgi izlasīt pakalpojuma žurnālus, lai izprastu tā faktisko stāvokli.

> **Izvades piemērs pakalpojumam `etcd`, ja tas darbojas**
>
> ```
>  1
>  2
>  3
>  4
>  5
>  6
>  7
>  8
>  9
> 10
> 11
> 12
> 13
> 14
> 15
> 16
> 17
> 18
> 19
> 20
> 21
> 22
> ```

> **Izvades piemērs pakalpojumam `etcd`, ja tajā ir kļūda**
>
> ```
>  1
>  2
>  3
>  4
>  5
>  6
>  7
>  8
>  9
> 10
> 11
> 12
> 13
> 14
> 15
> 16
> 17
> 18
> 19
> 20
> ```
>
> Iepriekš redzamajā izvadē pakalpojumam `etcd` ir statuss `failed`, un kļūda, kas neļāva tam startēt, ir 17. rindā: pakalpojums nevar nolasīt direktorija `/var/lib/etcd/cleanroom` saturu. Šādā gadījumā [pielāgojiet direktorija atļaujas](https://docs.cyberelements.io/bastion/4.6/lv/Installation/Dependencies/PostgreSQLCluster/Troubleshooting/EtcdDebug/#error-log-explanations).

> **Izvades piemērs pakalpojumam `patroni`, ja tas darbojas**
>
> ```
>  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
> ```

> **Izvades piemērs pakalpojumam `patroni`, ja tajā ir kļūda**
>
> ```
>  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
> ```
>
> Iepriekš redzamajā gadījumā pakalpojumam ir statuss `active (running)`, lai gan tas faktiski nedarbojas: žurnālos redzamas dažādas savienojuma kļūdas ar `etcd`, kas ir nepieciešams `patroni`.
> Šajā piemērā vaina ne vienmēr ir `patroni`: tā kā tas ir atkarīgs no `etcd`, vispirms novērsiet `etcd` problēmas un pēc tam vēlreiz pārbaudiet `patroni` statusu.

## Pakalpojumu problēmu novēršanas procedūras

Tālāk ir sniegta viena problēmu novēršanas procedūra katram pakalpojumam. Ja nepareizi darbojas gan `etcd`, gan `patroni`, sāciet ar `etcd`.

- **[`etcd` problēmu novēršana](https://docs.cyberelements.io/bastion/4.6/lv/Installation/Dependencies/PostgreSQLCluster/Troubleshooting/EtcdDebug/)**

  ---

  Procedūra, kas jāveic, ja pakalpojums `etcd` darbojas nepareizi.
- **[`patroni` problēmu novēršana](https://docs.cyberelements.io/bastion/4.6/lv/Installation/Dependencies/PostgreSQLCluster/Troubleshooting/PatroniDebug/)**

  ---

  Procedūra, kas jāveic, ja pakalpojums `patroni` darbojas nepareizi.
