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

# Rozwiązywanie problemów z `patroni`

> **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).

`patroni` to orkiestrator wysokiej dostępności dla PostgreSQL. Automatyzuje zarządzanie clusterem PostgreSQL, obsługując wybór lidera, przełączanie awaryjne i synchronizację węzłów w razie incydentu.

W clusterze PostgreSQL CyberElements Bastion `patroni` opiera się na `etcd` w celu przechowywania i udostępniania stanu clustera. Stale monitoruje stan instancji PostgreSQL i dba o to, aby w danym momencie tylko jeden węzeł był wyznaczony jako lider.

Jeśli węzeł lidera ulegnie awarii, `patroni` automatycznie przeprowadza wybory za pośrednictwem rozproszonego magazynu konfiguracji `etcd`, aby wyznaczyć nowego lidera i utrzymać dostępność usługi.

`patroni` zależy więc od `etcd` i nie może działać prawidłowo, jeśli `etcd` nie działa.

## Desynchronizacja węzła

Węzeł cluster PostgreSQL może czasem utracić synchronizację. Widać to w wyniku polecenia `patronictl -c /etc/patroni/config.yml topology`:

```
1
2
3
4
5
6
7
```

W kolumnie `TL` 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ę.

W takim przypadku uruchom następujące polecenie na niezsynchronizowanym węźle:

```
1
```

Gdzie `<MEMBER_PATRONI>` to nazwa niezsynchronizowanego węzła, widoczna w kolumnie `Member` topologii.

Jeśli kilka węzłów utraciło synchronizację, zsynchronizuj ponownie wszystkie te, które nie mają najwyższej wartości `TL`.

> **Ostrzeżenie**
>
> Jeśli niezsynchronizowanym węzłem jest węzeł `Leader`, dane mogą zostać utracone. Nie powinno się to nigdy zdarzyć: węzeł `Leader` powinien mieć najwyższą wartość `TL`.

> **Przykład**
>
> W powyższym wyniku polecenia `patronictl -c /etc/patroni/config.yml topology` węzeł `PSQL_1` utracił synchronizację. Aby zsynchronizować go ponownie, użyj następującego polecenia:
>
> ```
> 1
> ```

## Logi

Cała procedura opiera się na logach usługi `patroni`, które uzyskasz za pomocą poniższego polecenia:

```
1
```

> **Wskazówka**
>
> Aby śledzić logi na bieżąco, dodaj do polecenia opcję `-f`:
>
> ```
> 1
> ```

> **Informacja**
>
> Logi `patroni` są również dostępne w `/var/log/syslog`.

## Objaśnienia logów błędów

> **`ERROR: Request to server https://<PSQL_NODE_NAME>:2379 failed: MaxRetryError("HTTPSConnectionPool(host='<PSQL_NODE_NAME>', port=2379)`**
>
> Gdy `etcd` nie działa lub jest nieosiągalny, `patroni` może zapisywać następujące błędy:
>
> ```
> 1
> 2
> 3
> 4
> 5
> 6
> 7
> 8
> ```
>
> **`<PSQL_NODE_NAME>`**
>
> Nazwa jednego z węzłów clustera PostgreSQL.
>
> W takim przypadku [rozwiąż problemy z `etcd`](https://docs.cyberelements.io/bastion/4.6/pl/Installation/Dependencies/PostgreSQLCluster/Troubleshooting/EtcdDebug/).
