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

# Risoluzione dei problemi del cluster PostgreSQL

> **Informazioni**
>
> L'intera procedura deve essere eseguita come `root`. Per elevare i propri privilegi a `root`, è possibile utilizzare il comando `su -`.

> **Attenzione**
>
> Per seguire questa procedura, è necessario aver effettuato le [configurazioni aggiuntive per `patronictl`](https://docs.cyberelements.io/bastion/4.6/it/Installation/Dependencies/PostgreSQLCluster/Installation/Install/#additional-configurations-for-patronictl).

Gli errori di connessione al database del cluster PostgreSQL di CyberElements Bastion possono avere diverse cause. Questa sezione presenta un metodo generale di risoluzione dei problemi, da adattare al proprio caso.

## Verifica dello stato del cluster

> **Informazioni**
>
> La verifica dello stato del cluster permette di individuare rapidamente il nodo o i nodi in errore.

È possibile verificare lo stato del cluster con il comando seguente, da eseguire su ciascun nodo del cluster PostgreSQL:

```
1
```

> **Esempio di risultato su una piattaforma funzionante**
>
> ```
> 1
> 2
> 3
> 4
> 5
> 6
> 7
> ```
>
> Nel risultato qui sopra, tutto indica che il cluster PostgreSQL funziona: il lag è di 0 MB per tutti i nodi `Replica` e tutti i nodi sono presenti nell'elenco, con lo stato `running`. È necessario ottenere questo risultato su tutti i nodi per confermare che `patroni` e `etcd` funzionano.

> **Esempio di risultato in caso di problema di comunicazione tra i nodi**
>
> ```
> 1
> 2
> 3
> 4
> 5
> 6
> 7
> ```
>
> Nel risultato qui sopra, il lag di 230 MB è anomalo: potrebbe indicare un problema di comunicazione tra il nodo 3 e il nodo 1.
> Se il problema persiste dopo diverse ore, ciò lo conferma.

> **Esempio di risultato quando un nodo non è stato avviato o arrestato correttamente**
>
> ```
> 1
> 2
> 3
> 4
> 5
> 6
> 7
> ```
>
> Nel risultato qui sopra, lo stato (colonna `State`) indica che il nodo 1 è in fase di avvio. Se lo stato `started` persiste per diversi minuti, o addirittura ore, potrebbe esserci un problema con `patroni` o `etcd` su quel nodo.
> Il nodo 2 è nello stato `stopped`: è arrestato. Quando un nodo del cluster si guasta, questa informazione viene visualizzata solo temporaneamente, prima che il nodo venga rimosso dall'elenco.

> **Esempio di risultato quando `etcd` non funziona sul nodo corrente**
>
> ```
> 1
> 2
> 3
> ```
>
> Il risultato qui sopra indica un errore di connessione a `etcd`, che impedisce di ottenere lo stato del cluster PostgreSQL.

> **Esempio di risultato quando uno dei nodi è desincronizzato**
>
> ```
> 1
> 2
> 3
> 4
> 5
> 6
> 7
> ```
>
> Nel risultato riportato sopra, il nodo `PSQL_1` non è più sulla stessa `TL` degli altri. Affinché il cluster funzioni, tutti i nodi devono essere sulla stessa `TL`: una differenza indica che uno dei nodi è desincronizzato.
> Per risolvere questo problema, seguire la procedura prevista in caso di [desincronizzazione di un nodo](https://docs.cyberelements.io/bastion/4.6/it/Installation/Dependencies/PostgreSQLCluster/Troubleshooting/PatroniDebug/#node-desynchronization).

## Verifica dello stato dei servizi

Una volta identificato il nodo in errore, è necessario identificare il servizio che non funziona correttamente. I due servizi principali utilizzati sul cluster PostgreSQL sono `patroni` e `etcd`.

> **Informazioni**
>
> Il servizio `patroni` dipende dal servizio `etcd`: se `etcd` non funziona, non funzionerà nemmeno `patroni`.

Per identificare il servizio in errore, è possibile eseguire i comandi seguenti:

```
1
2
```

Questi comandi forniscono lo stato del servizio, insieme alle sue ultime 10 righe di log.

> **Attenzione**
>
> Un servizio con lo stato `active (running)` non funziona necessariamente: può essere in esecuzione pur scrivendo log di errore. È quindi importante leggere i log del servizio per capirne lo stato effettivo.

> **Esempio di risultato per `etcd` quando il servizio funziona**
>
> ```
>  1
>  2
>  3
>  4
>  5
>  6
>  7
>  8
>  9
> 10
> 11
> 12
> 13
> 14
> 15
> 16
> 17
> 18
> 19
> 20
> 21
> 22
> ```

> **Esempio di risultato per `etcd` quando il servizio è in errore**
>
> ```
>  1
>  2
>  3
>  4
>  5
>  6
>  7
>  8
>  9
> 10
> 11
> 12
> 13
> 14
> 15
> 16
> 17
> 18
> 19
> 20
> ```
>
> Nel risultato qui sopra, il servizio `etcd` ha lo stato `failed` e l'errore che ne ha impedito l'avvio è quello alla riga 17: il servizio non riesce a leggere il contenuto della directory `/var/lib/etcd/cleanroom`. In questo caso, [correggere le autorizzazioni della directory](https://docs.cyberelements.io/bastion/4.6/it/Installation/Dependencies/PostgreSQLCluster/Troubleshooting/EtcdDebug/#error-log-explanations).

> **Esempio di risultato per `patroni` quando il servizio funziona**
>
> ```
>  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
> ```

> **Esempio di risultato per `patroni` quando il servizio è in errore**
>
> ```
>  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
> ```
>
> Nel caso qui sopra, il servizio ha lo stato `active (running)` senza funzionare realmente: i log mostrano diversi errori di connessione a `etcd`, di cui `patroni` ha bisogno.
> In questo esempio, `patroni` non è necessariamente responsabile: poiché dipende da `etcd`, correggere prima i problemi di `etcd`, poi verificare di nuovo lo stato di `patroni`.

## Procedure di risoluzione dei problemi dei servizi

Di seguito è riportata una procedura di risoluzione dei problemi per ciascun servizio. Se sia `etcd` sia `patroni` non funzionano correttamente, iniziare da `etcd`.

- **[Risoluzione dei problemi di `etcd`](https://docs.cyberelements.io/bastion/4.6/it/Installation/Dependencies/PostgreSQLCluster/Troubleshooting/EtcdDebug/)**

  ---

  Procedura da seguire quando il servizio `etcd` non funziona correttamente.
- **[Risoluzione dei problemi di `patroni`](https://docs.cyberelements.io/bastion/4.6/it/Installation/Dependencies/PostgreSQLCluster/Troubleshooting/PatroniDebug/)**

  ---

  Procedura da seguire quando il servizio `patroni` non funziona correttamente.
