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

# Rozwiązywanie problemów z clusterem PostgreSQL

> **Informacja**
>
> Całą procedurę wykonuj jako `root`. Aby podnieść swoje uprawnienia do poziomu `root`, możesz użyć polecenia `su -`.

> **Ostrzeżenie**
>
> Aby wykonać tę procedurę, musisz wcześniej przeprowadzić [dodatkowe konfiguracje dla `patronictl`](https://docs.cyberelements.io/bastion/4.6/pl/Installation/Dependencies/PostgreSQLCluster/Installation/Install/#additional-configurations-for-patronictl).

Błędy połączenia z bazą danych clustera PostgreSQL CyberElements Bastion mogą mieć różne przyczyny. Ta sekcja przedstawia ogólną metodę rozwiązywania problemów — dostosuj ją do swojego przypadku.

## Sprawdzanie stanu clustera

> **Informacja**
>
> Sprawdzenie stanu clustera pozwala szybko zlokalizować węzeł lub węzły, które uległy awarii.

Stan clustera możesz sprawdzić za pomocą następującego polecenia, uruchamiając je na każdym węźle clustera PostgreSQL:

```
1
```

> **Przykład wyniku na działającej platformie**
>
> ```
> 1
> 2
> 3
> 4
> 5
> 6
> 7
> ```
>
> W powyższym wyniku wszystko wskazuje na to, że cluster PostgreSQL działa: lag wynosi 0 MB dla wszystkich węzłów `Replica`, a wszystkie węzły są na liście ze stanem `running`. Musisz uzyskać taki wynik na wszystkich węzłach, aby potwierdzić, że `patroni` i `etcd` działają.

> **Przykład wyniku w przypadku problemu z komunikacją między węzłami**
>
> ```
> 1
> 2
> 3
> 4
> 5
> 6
> 7
> ```
>
> W powyższym wyniku lag 230 MB jest nieprawidłowy: może wskazywać na problem z komunikacją między węzłem 3 a węzłem 1.
> Jeśli problem utrzymuje się po kilku godzinach, potwierdza to tę hipotezę.

> **Przykład wyniku, gdy węzeł nie został poprawnie uruchomiony lub zatrzymany**
>
> ```
> 1
> 2
> 3
> 4
> 5
> 6
> 7
> ```
>
> W powyższym wyniku stan (kolumna `State`) wskazuje, że węzeł 1 się uruchamia. Jeśli stan `started` utrzymuje się przez kilka minut, a nawet godzin, może występować problem z `patroni` lub `etcd` na tym węźle.
> Węzeł 2 jest w stanie `stopped`: jest zatrzymany. Gdy węzeł clustera ulegnie awarii, ta informacja jest wyświetlana tylko tymczasowo, zanim węzeł zostanie usunięty z listy.

> **Przykład wyniku, gdy `etcd` ulega awarii na bieżącym węźle**
>
> ```
> 1
> 2
> 3
> ```
>
> Powyższy wynik wskazuje na błąd połączenia z `etcd`, który uniemożliwia pobranie stanu clustera PostgreSQL.

> **Przykład wyniku, gdy jeden z węzłów utracił synchronizację**
>
> ```
> 1
> 2
> 3
> 4
> 5
> 6
> 7
> ```
>
> W powyższym wyniku węzeł `PSQL_1` nie ma już tej samej wartości `TL` co pozostałe. Aby cluster działał, wszystkie węzły muszą mieć tę samą wartość `TL`: różnica oznacza, że jeden z węzłów utracił synchronizację.
> Aby rozwiązać ten problem, wykonaj procedurę opisaną w sekcji [Desynchronizacja węzła](https://docs.cyberelements.io/bastion/4.6/pl/Installation/Dependencies/PostgreSQLCluster/Troubleshooting/PatroniDebug/#node-desynchronization).

## Sprawdzanie stanu usług

Po zidentyfikowaniu węzła, który uległ awarii, musisz zidentyfikować usługę działającą nieprawidłowo. Dwie główne usługi używane w clusterze PostgreSQL to `patroni` i `etcd`.

> **Informacja**
>
> Usługa `patroni` zależy od usługi `etcd`: jeśli `etcd` nie działa, `patroni` również nie będzie działać.

Aby zidentyfikować usługę, która uległa awarii, możesz uruchomić następujące polecenia:

```
1
2
```

Te polecenia podają stan usługi wraz z jej 10 ostatnimi wierszami logów.

> **Ostrzeżenie**
>
> Usługa ze stanem `active (running)` niekoniecznie działa prawidłowo: może być uruchomiona i jednocześnie zapisywać logi błędów. Dlatego ważne jest odczytanie logów usługi, aby zrozumieć jej rzeczywisty stan.

> **Przykład wyniku dla `etcd`, gdy usługa działa**
>
> ```
>  1
>  2
>  3
>  4
>  5
>  6
>  7
>  8
>  9
> 10
> 11
> 12
> 13
> 14
> 15
> 16
> 17
> 18
> 19
> 20
> 21
> 22
> ```

> **Przykład wyniku dla `etcd`, gdy usługa jest w stanie błędu**
>
> ```
>  1
>  2
>  3
>  4
>  5
>  6
>  7
>  8
>  9
> 10
> 11
> 12
> 13
> 14
> 15
> 16
> 17
> 18
> 19
> 20
> ```
>
> W powyższym wyniku usługa `etcd` ma stan `failed`, a błąd, który uniemożliwił jej uruchomienie, znajduje się w wierszu 17: usługa nie może odczytać zawartości katalogu `/var/lib/etcd/cleanroom`. W takim przypadku [dostosuj uprawnienia do katalogu](https://docs.cyberelements.io/bastion/4.6/pl/Installation/Dependencies/PostgreSQLCluster/Troubleshooting/EtcdDebug/#error-log-explanations).

> **Przykład wyniku dla `patroni`, gdy usługa działa**
>
> ```
>  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
> ```

> **Przykład wyniku dla `patroni`, gdy usługa jest w stanie błędu**
>
> ```
>  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
> ```
>
> W powyższym przypadku usługa ma stan `active (running)`, choć w rzeczywistości nie działa: logi pokazują różne błędy połączenia z `etcd`, którego potrzebuje `patroni`.
> W tym przykładzie `patroni` niekoniecznie jest przyczyną: ponieważ zależy od `etcd`, najpierw rozwiąż problemy z `etcd`, a następnie ponownie sprawdź stan `patroni`.

## Procedury rozwiązywania problemów z usługami

Poniżej znajdziesz po jednej procedurze rozwiązywania problemów dla każdej usługi. Jeśli nieprawidłowo działają zarówno `etcd`, jak i `patroni`, zacznij od `etcd`.

- **[Rozwiązywanie problemów z `etcd`](https://docs.cyberelements.io/bastion/4.6/pl/Installation/Dependencies/PostgreSQLCluster/Troubleshooting/EtcdDebug/)**

  ---

  Procedura do wykonania, gdy usługa `etcd` działa nieprawidłowo.
- **[Rozwiązywanie problemów z `patroni`](https://docs.cyberelements.io/bastion/4.6/pl/Installation/Dependencies/PostgreSQLCluster/Troubleshooting/PatroniDebug/)**

  ---

  Procedura do wykonania, gdy usługa `patroni` działa nieprawidłowo.
