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

# A PostgreSQL-fürt hibaelhárítása

> **Információ**
>
> A teljes eljárást `root` felhasználóként kell végrehajtani. A jogosultságai `root` szintre emeléséhez használhatja a `su -` parancsot.

> **Figyelmeztetés**
>
> Az eljárás követéséhez el kell végeznie [a `patronictl` kiegészítő konfigurációit](https://docs.cyberelements.io/bastion/4.6/hu/Installation/Dependencies/PostgreSQLCluster/Installation/Install/#additional-configurations-for-patronictl).

A CyberElements Bastion PostgreSQL-fürtjének adatbázisához való csatlakozási hibáknak különböző okai lehetnek. Ez a fejezet egy általános hibaelhárítási módszert mutat be, amelyet az adott esethez kell igazítania.

## A fürt állapotának ellenőrzése

> **Információ**
>
> A fürt állapotának ellenőrzésével gyorsan megtalálható a meghibásodott csomópont vagy csomópontok.

A fürt állapotát a következő paranccsal ellenőrizheti, amelyet a PostgreSQL-fürt minden csomópontján futtatni kell:

```
1
```

> **Példa kimenet működő platformon**
>
> ```
> 1
> 2
> 3
> 4
> 5
> 6
> 7
> ```
>
> A fenti kimenetben minden arra utal, hogy a PostgreSQL-fürt működik: a lemaradás minden `Replica` csomópontnál 0 MB, és minden csomópont szerepel a listában `running` állapottal. Ezt a kimenetet kell kapnia minden csomóponton ahhoz, hogy megerősítse a `patroni` és az `etcd` működését.

> **Példa kimenet a csomópontok közötti kommunikációs probléma esetén**
>
> ```
> 1
> 2
> 3
> 4
> 5
> 6
> 7
> ```
>
> A fenti kimenetben a 230 MB-os lemaradás rendellenes: a 3-as és az 1-es csomópont közötti kommunikációs problémára utalhat.
> Ha a probléma több óra elteltével is fennáll, ez megerősíti a gyanút.

> **Példa kimenet arra az esetre, ha egy csomópont nem megfelelően indult el vagy állt le**
>
> ```
> 1
> 2
> 3
> 4
> 5
> 6
> 7
> ```
>
> A fenti kimenetben az állapot (`State` oszlop) azt jelzi, hogy az 1-es csomópont éppen indul. Ha a `started` állapot több percig vagy akár órákig is fennmarad, lehet, hogy probléma van az adott csomóponton a `patroni` vagy az `etcd` szolgáltatással.
> A 2-es csomópont `stopped` állapotban van: le van állítva. Ha a fürt egyik csomópontja meghibásodik, ez az információ csak ideiglenesen jelenik meg, mielőtt a csomópont lekerül a listáról.

> **Példa kimenet arra az esetre, ha az `etcd` meghibásodik az aktuális csomóponton**
>
> ```
> 1
> 2
> 3
> ```
>
> A fenti kimenet az `etcd` szolgáltatáshoz való csatlakozási hibát jelez, amely megakadályozza a PostgreSQL-fürt állapotának lekérését.

> **Példa kimenet arra az esetre, ha az egyik csomópont kiesett a szinkronból**
>
> ```
> 1
> 2
> 3
> 4
> 5
> 6
> 7
> ```
>
> A fenti kimenetben a `PSQL_1` csomópont már nem ugyanazon a `TL` értéken van, mint a többi. A fürt működéséhez minden csomópontnak ugyanazon a `TL` értéken kell lennie: az eltérés azt jelzi, hogy az egyik csomópont kiesett a szinkronból.
> A probléma megoldásához kövesse a [csomópont szinkronizációjának elvesztésére](https://docs.cyberelements.io/bastion/4.6/hu/Installation/Dependencies/PostgreSQLCluster/Troubleshooting/PatroniDebug/#node-desynchronization) vonatkozó eljárást.

## A szolgáltatások állapotának ellenőrzése

A meghibásodott csomópont azonosítása után meg kell határoznia a hibásan működő szolgáltatást. A PostgreSQL-fürtön használt két fő szolgáltatás a `patroni` és az `etcd`.

> **Információ**
>
> A `patroni` szolgáltatás az `etcd` szolgáltatástól függ: ha az `etcd` nem működik, a `patroni` sem fog működni.

A meghibásodott szolgáltatás azonosításához a következő parancsokat futtathatja:

```
1
2
```

Ezek a parancsok megjelenítik a szolgáltatás állapotát, valamint az utolsó 10 naplósorát.

> **Figyelmeztetés**
>
> Az `active (running)` állapotú szolgáltatás nem feltétlenül működik: futhat úgy is, hogy közben hibanaplókat ír. Ezért fontos elolvasni a szolgáltatás naplóit, hogy megértse annak tényleges állapotát.

> **Példa kimenet az `etcd` esetében, amikor a szolgáltatás működik**
>
> ```
>  1
>  2
>  3
>  4
>  5
>  6
>  7
>  8
>  9
> 10
> 11
> 12
> 13
> 14
> 15
> 16
> 17
> 18
> 19
> 20
> 21
> 22
> ```

> **Példa kimenet az `etcd` esetében, amikor a szolgáltatás hibás állapotban van**
>
> ```
>  1
>  2
>  3
>  4
>  5
>  6
>  7
>  8
>  9
> 10
> 11
> 12
> 13
> 14
> 15
> 16
> 17
> 18
> 19
> 20
> ```
>
> A fenti kimenetben az `etcd` szolgáltatás `failed` állapotú, és az indítását megakadályozó hiba a 17. sorban látható: a szolgáltatás nem tudja olvasni a `/var/lib/etcd/cleanroom` könyvtár tartalmát. Ebben az esetben [módosítsa a könyvtár engedélyeit](https://docs.cyberelements.io/bastion/4.6/hu/Installation/Dependencies/PostgreSQLCluster/Troubleshooting/EtcdDebug/#error-log-explanations).

> **Példa kimenet a `patroni` esetében, amikor a szolgáltatás működik**
>
> ```
>  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
> ```

> **Példa kimenet a `patroni` esetében, amikor a szolgáltatás hibás állapotban van**
>
> ```
>  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
> ```
>
> A fenti esetben a szolgáltatás `active (running)` állapotú, de valójában nem működik: a naplók különböző csatlakozási hibákat mutatnak az `etcd` felé, amelyre a `patroni` szolgáltatásnak szüksége van.
> Ebben a példában nem feltétlenül a `patroni` a hibás: mivel az `etcd` szolgáltatástól függ, először hárítsa el az `etcd` problémáit, majd ellenőrizze újra a `patroni` állapotát.

## Hibaelhárítási eljárások szolgáltatásonként

Az alábbiakban szolgáltatásonként egy-egy hibaelhárítási eljárás található. Ha az `etcd` és a `patroni` is hibásan működik, kezdje az `etcd` szolgáltatással.

- **[Az `etcd` hibaelhárítása](https://docs.cyberelements.io/bastion/4.6/hu/Installation/Dependencies/PostgreSQLCluster/Troubleshooting/EtcdDebug/)**

  ---

  Követendő eljárás, ha az `etcd` szolgáltatás hibásan működik.
- **[A `patroni` hibaelhárítása](https://docs.cyberelements.io/bastion/4.6/hu/Installation/Dependencies/PostgreSQLCluster/Troubleshooting/PatroniDebug/)**

  ---

  Követendő eljárás, ha a `patroni` szolgáltatás hibásan működik.
