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

# `patroni`-palvelun vianmääritys

> **Tietoa**
>
> Koko toimenpide on suoritettava `root`-käyttäjänä. Voit korottaa oikeutesi `root`-tasolle komennolla `su -`.

> **Varoitus**
>
> Tämän toimenpiteen noudattaminen edellyttää, että olet tehnyt [`patronictl`-työkalun lisämääritykset](https://docs.cyberelements.io/bastion/4.6/fi/Installation/Dependencies/PostgreSQLCluster/Installation/Install/#additional-configurations-for-patronictl).

`patroni` on PostgreSQL:n korkean käytettävyyden orkestrointityökalu. Se automatisoi PostgreSQL-klusterin hallinnan huolehtimalla johtajan valinnasta, vikasietosiirrosta (*failover*) ja solmujen synkronoinnista häiriön sattuessa.

CyberElements Bastion -järjestelmän PostgreSQL-klusterissa `patroni` tukeutuu `etcd`-palveluun klusterin tilan tallentamisessa ja jakamisessa. Se valvoo jatkuvasti PostgreSQL-instanssien tilaa ja varmistaa, että vain yksi solmu on kerrallaan nimetty johtajaksi.

Jos johtajasolmu vikaantuu, `patroni` järjestää automaattisesti valinnan hajautetun määrityssäilön `etcd` kautta ylentääkseen uuden johtajan ja pitääkseen palvelun käytettävissä.

`patroni` on siis riippuvainen `etcd`-palvelusta eikä voi toimia oikein, jos `etcd` ei toimi.

## Solmun epäsynkronoituminen

PostgreSQL-klusterin solmu voi joskus joutua epäsynkroniin. Tämä näkyy komennon `patronictl -c /etc/patroni/config.yml topology` tulosteessa:

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

Sarakkeessa `TL` näkyy, ettei solmu `PSQL_1` ole enää samalla `TL`-aikajanalla kuin muut. Jotta klusteri toimisi, kaikkien solmujen on oltava samalla `TL`-aikajanalla: ero osoittaa, että yksi solmuista on epäsynkronissa.

Suorita tässä tapauksessa seuraava komento epäsynkronissa olevassa solmussa:

```
1
```

Tässä `<MEMBER_PATRONI>` on epäsynkronissa olevan solmun nimi sellaisena kuin se näkyy topologian sarakkeessa `Member`.

Jos useampi solmu on epäsynkronissa, synkronoi uudelleen kaikki ne, jotka eivät ole korkeimmalla `TL`-aikajanalla.

> **Varoitus**
>
> Jos epäsynkronissa oleva solmu on `Leader`-solmu, tietoja voi kadota. Näin ei pitäisi koskaan käydä: `Leader`-solmun oletetaan olevan korkeimmalla `TL`-aikajanalla.

> **Esimerkki**
>
> Yllä olevan komennon `patronictl -c /etc/patroni/config.yml topology` tulosteessa solmu `PSQL_1` on epäsynkronissa. Synkronoi se uudelleen seuraavalla komennolla:
>
> ```
> 1
> ```

## Lokit

Koko toimenpide perustuu `patroni`-palvelun lokeihin, jotka saat alla olevalla komennolla:

```
1
```

> **Vihje**
>
> Jos haluat seurata lokeja reaaliajassa, lisää komentoon valitsin `-f`:
>
> ```
> 1
> ```

> **Tietoa**
>
> `patroni`-palvelun lokit ovat saatavilla myös tiedostossa `/var/log/syslog`.

## Virhelokien selitykset

> **`ERROR: Request to server https://<PSQL_NODE_NAME>:2379 failed: MaxRetryError("HTTPSConnectionPool(host='<PSQL_NODE_NAME>', port=2379)`**
>
> Kun `etcd` ei toimi tai siihen ei saada yhteyttä, `patroni` voi kirjoittaa seuraavat virheet:
>
> ```
> 1
> 2
> 3
> 4
> 5
> 6
> 7
> 8
> ```
>
> **`<PSQL_NODE_NAME>`**
>
> PostgreSQL-klusterin jonkin solmun nimi.
>
> Tässä tapauksessa sinun on [tehtävä `etcd`-palvelun vianmääritys](https://docs.cyberelements.io/bastion/4.6/fi/Installation/Dependencies/PostgreSQLCluster/Troubleshooting/EtcdDebug/).
