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

# Fabhtcheartú `patroni`

> **Faisnéis**
>
> Ní mór an nós imeachta ar fad a leanúint mar `root`. Chun do phribhléidí a ardú go `root`, is féidir leat an t-ordú `su -` a úsáid.

> **Rabhadh**
>
> Chun an nós imeachta seo a leanúint, ní mór duit na [cumraíochtaí breise do `patronictl`](https://docs.cyberelements.io/bastion/4.6/ga/Installation/Dependencies/PostgreSQLCluster/Installation/Install/#additional-configurations-for-patronictl) a bheith déanta agat.

Is ceolfhoirneoir ardinfhaighteachta do PostgreSQL é `patroni`. Uathoibríonn sé bainistíocht braisle PostgreSQL trí thoghchán an cheannaire, an cliseadh thar agus sioncrónú na nód a láimhseáil nuair a tharlaíonn teagmhas.

Sa bhraisle PostgreSQL de chuid CyberElements Bastion, braitheann `patroni` ar `etcd` chun staid na braisle a stóráil agus a chomhroinnt. Déanann sé monatóireacht leanúnach ar staid na n-áscanna PostgreSQL agus cinntíonn sé nach n-ainmnítear ach nód amháin mar cheannaire ag aon am ar leith.

Má theipeann ar an nód ceannaire, eagraíonn `patroni` toghchán go huathoibríoch tríd an stór cumraíochta dáilte `etcd`, chun ceannaire nua a ardú céime agus an tseirbhís a choinneáil ar fáil.

Braitheann `patroni` ar `etcd` dá bhrí sin, agus ní féidir leis oibriú i gceart mura bhfuil `etcd` ag obair.

## Díshioncrónú nóid

Uaireanta, is féidir le nód den bhraisle PostgreSQL éirí díshioncrónaithe. Tá sé seo le feiceáil in aschur an ordaithe `patronictl -c /etc/patroni/config.yml topology`:

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

Sa cholún `TL`, níl an nód `PSQL_1` ar an `TL` céanna leis na nóid eile a thuilleadh. Le go n-oibreoidh an bhraisle, ní mór do gach nód a bheith ar an `TL` céanna: léiríonn difríocht go bhfuil ceann de na nóid díshioncrónaithe.

Sa chás seo, rith an t-ordú seo a leanas ar an nód díshioncrónaithe:

```
1
```

Is é `<MEMBER_PATRONI>` ainm an nóid dhíshioncrónaithe, mar a thaispeántar é i gcolún `Member` na topeolaíochta.

Má tá roinnt nód díshioncrónaithe, athshioncrónaigh na nóid uile nach bhfuil ar an `TL` is airde.

> **Rabhadh**
>
> Más é an nód `Leader` an nód díshioncrónaithe, d'fhéadfaí sonraí a chailleadh. Níor cheart go dtarlódh sé seo riamh: táthar ag súil go mbeidh an nód `Leader` ar an `TL` is airde.

> **Sampla**
>
> In aschur an ordaithe `patronictl -c /etc/patroni/config.yml topology` thuas, tá an nód `PSQL_1` díshioncrónaithe. Chun é a athshioncrónú, úsáid an t-ordú seo a leanas:
>
> ```
> 1
> ```

## Logs

Braitheann an nós imeachta ar fad ar logaí na seirbhíse `patroni`, a fhaigheann tú leis an ordú thíos:

```
1
```

> **Leid**
>
> Chun na logaí a leanúint i bhfíor-am, cuir an rogha `-f` leis an ordú:
>
> ```
> 1
> ```

> **Faisnéis**
>
> Tá logaí `patroni` ar fáil in `/var/log/syslog` freisin.

## Mínithe ar logaí earráide

> **`ERROR: Request to server https://<PSQL_NODE_NAME>:2379 failed: MaxRetryError("HTTPSConnectionPool(host='<PSQL_NODE_NAME>', port=2379)`**
>
> Nuair nach bhfuil `etcd` ag obair nó nach féidir teacht air, is féidir le `patroni` na hearráidí seo a leanas a scríobh:
>
> ```
> 1
> 2
> 3
> 4
> 5
> 6
> 7
> 8
> ```
>
> **`<PSQL_NODE_NAME>`**
>
> Ainm nóid de chuid na braisle PostgreSQL.
>
> Sa chás seo, ní mór duit [fabhtcheartú a dhéanamh ar `etcd`](https://docs.cyberelements.io/bastion/4.6/ga/Installation/Dependencies/PostgreSQLCluster/Troubleshooting/EtcdDebug/).
