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

# Отстраняване на неизправности в клъстера PostgreSQL

> **Информация**
>
> Цялата процедура трябва да се изпълни като `root`. За да повишите привилегиите си до `root`, можете да използвате командата `su -`.

> **Предупреждение**
>
> За да следвате тази процедура, трябва да сте изпълнили [допълнителните конфигурации за `patronictl`](https://docs.cyberelements.io/bastion/4.6/bg/Installation/Dependencies/PostgreSQLCluster/Installation/Install/#additional-configurations-for-patronictl).

Грешките при свързване с базата данни на клъстера PostgreSQL на CyberElements Bastion може да имат различни причини. Тази част представя общ метод за отстраняване на неизправности, който трябва да адаптирате към вашия случай.

## Проверка на състоянието на клъстера

> **Информация**
>
> Проверката на състоянието на клъстера позволява бързо да се открие отказалият възел или възли.

Можете да проверите състоянието на клъстера със следната команда, която трябва да се изпълни на всеки възел на клъстера PostgreSQL:

```
1
```

> **Пример за резултат на работеща платформа**
>
> ```
> 1
> 2
> 3
> 4
> 5
> 6
> 7
> ```
>
> В резултата по-горе всичко показва, че клъстерът PostgreSQL работи: забавянето е 0 MB за всички възли `Replica` и всички възли са в списъка със състояние `running`. Трябва да получите този резултат на всички възли, за да потвърдите, че `patroni` и `etcd` работят.

> **Пример за резултат при проблем с комуникацията между възлите**
>
> ```
> 1
> 2
> 3
> 4
> 5
> 6
> 7
> ```
>
> В резултата по-горе забавянето от 230 MB е необичайно: то може да показва проблем с комуникацията между възел 3 и възел 1.
> Ако проблемът продължава след няколко часа, това го потвърждава.

> **Пример за резултат, когато даден възел не е правилно стартиран или спрян**
>
> ```
> 1
> 2
> 3
> 4
> 5
> 6
> 7
> ```
>
> В резултата по-горе състоянието (колона `State`) показва, че възел 1 се стартира. Ако състоянието `started` се запази няколко минути или дори часове, може да има проблем с `patroni` или `etcd` на този възел.
> Възел 2 е в състояние `stopped`: той е спрян. Когато възел на клъстера откаже, тази информация се показва само временно, преди възелът да бъде премахнат от списъка.

> **Пример за резултат, когато `etcd` откаже на текущия възел**
>
> ```
> 1
> 2
> 3
> ```
>
> Резултатът по-горе показва грешка при свързване с `etcd`, която не позволява извличането на състоянието на клъстера PostgreSQL.

> **Пример за резултат, когато един от възлите е излязъл от синхрон**
>
> ```
> 1
> 2
> 3
> 4
> 5
> 6
> 7
> ```
>
> В резултата по-горе възелът `PSQL_1` вече не е на същата стойност `TL` като останалите. За да работи клъстерът, всички възли трябва да са на една и съща стойност `TL`: разлика показва, че един от възлите е излязъл от синхрон.
> За да решите този проблем, следвайте процедурата за [десинхронизация на възел](https://docs.cyberelements.io/bastion/4.6/bg/Installation/Dependencies/PostgreSQLCluster/Troubleshooting/PatroniDebug/#node-desynchronization).

## Проверка на състоянието на услугите

След като отказалият възел бъде идентифициран, трябва да идентифицирате неправилно работещата услуга. Двете основни услуги, използвани в клъстера PostgreSQL, са `patroni` и `etcd`.

> **Информация**
>
> Услугата `patroni` зависи от услугата `etcd`: ако `etcd` не работи, `patroni` също няма да работи.

За да идентифицирате отказалата услуга, можете да изпълните следните команди:

```
1
2
```

Тези команди показват състоянието на услугата заедно с последните ѝ 10 реда от дневника.

> **Предупреждение**
>
> Услуга със състояние `active (running)` не работи непременно правилно: тя може да е стартирана, докато записва грешки в дневника. Затова е важно да прочетете дневниците на услугата, за да разберете действителното ѝ състояние.

> **Пример за резултат за `etcd`, когато услугата работи**
>
> ```
>  1
>  2
>  3
>  4
>  5
>  6
>  7
>  8
>  9
> 10
> 11
> 12
> 13
> 14
> 15
> 16
> 17
> 18
> 19
> 20
> 21
> 22
> ```

> **Пример за резултат за `etcd`, когато услугата е в състояние на грешка**
>
> ```
>  1
>  2
>  3
>  4
>  5
>  6
>  7
>  8
>  9
> 10
> 11
> 12
> 13
> 14
> 15
> 16
> 17
> 18
> 19
> 20
> ```
>
> В резултата по-горе услугата `etcd` е със състояние `failed`, а грешката, която ѝ е попречила да стартира, е тази на ред 17: услугата не може да прочете съдържанието на директорията `/var/lib/etcd/cleanroom`. В този случай [коригирайте разрешенията за директорията](https://docs.cyberelements.io/bastion/4.6/bg/Installation/Dependencies/PostgreSQLCluster/Troubleshooting/EtcdDebug/#error-log-explanations).

> **Пример за резултат за `patroni`, когато услугата работи**
>
> ```
>  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`, когато услугата е в състояние на грешка**
>
> ```
>  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
> ```
>
> В случая по-горе услугата е със състояние `active (running)`, без в действителност да работи: дневниците показват различни грешки при свързване с `etcd`, от който `patroni` се нуждае.
> В този пример `patroni` не е непременно виновникът: тъй като зависи от `etcd`, първо отстранете проблемите с `etcd`, след което проверете отново състоянието на `patroni`.

## Процедури за отстраняване на неизправности в услугите

По-долу е дадена по една процедура за отстраняване на неизправности за всяка услуга. Ако и `etcd`, и `patroni` не работят правилно, започнете с `etcd`.

- **[Отстраняване на неизправности в `etcd`](https://docs.cyberelements.io/bastion/4.6/bg/Installation/Dependencies/PostgreSQLCluster/Troubleshooting/EtcdDebug/)**

  ---

  Процедура, която да следвате, когато услугата `etcd` не работи правилно.
- **[Отстраняване на неизправности в `patroni`](https://docs.cyberelements.io/bastion/4.6/bg/Installation/Dependencies/PostgreSQLCluster/Troubleshooting/PatroniDebug/)**

  ---

  Процедура, която да следвате, когато услугата `patroni` не работи правилно.
