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

# Risoluzione dei problemi di `patroni`

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

`patroni` è un orchestratore di alta disponibilità per PostgreSQL. Automatizza la gestione di un cluster PostgreSQL occupandosi dell'elezione del leader, del failover e della sincronizzazione dei nodi in caso di incidente.

Nel cluster PostgreSQL di CyberElements Bastion, `patroni` si basa su `etcd` per archiviare e condividere lo stato del cluster. Monitora costantemente lo stato delle istanze PostgreSQL e si assicura che un solo nodo sia designato leader in un dato momento.

Se il nodo leader si guasta, `patroni` orchestra automaticamente un'elezione tramite l'archivio di configurazione distribuito `etcd`, al fine di promuovere un nuovo leader e mantenere la disponibilità del servizio.

`patroni` dipende quindi da `etcd` e non può funzionare correttamente se `etcd` non funziona.

## Desincronizzazione di un nodo

Un nodo del cluster PostgreSQL può talvolta desincronizzarsi. Ciò è visibile nel risultato del comando `patronictl -c /etc/patroni/config.yml topology`:

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

Nella colonna `TL`, 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.

In questo caso, eseguire il comando seguente sul nodo desincronizzato:

```
1
```

Dove `<MEMBER_PATRONI>` è il nome del nodo desincronizzato, come indicato nella colonna `Member` della topologia.

Se più nodi sono desincronizzati, risincronizzare tutti quelli che non sono sulla `TL` più alta.

> **Attenzione**
>
> Se il nodo desincronizzato è il nodo `Leader`, possono verificarsi perdite di dati. Ciò non dovrebbe mai accadere: il nodo `Leader` deve trovarsi sulla `TL` più alta.

> **Esempio**
>
> Nel risultato del comando `patronictl -c /etc/patroni/config.yml topology` riportato sopra, il nodo `PSQL_1` è desincronizzato. Per risincronizzarlo, utilizzare il comando seguente:
>
> ```
> 1
> ```

## Log

L'intera procedura si basa sui log del servizio `patroni`, che si ottengono con il comando seguente:

```
1
```

> **Suggerimento**
>
> Per seguire i log in tempo reale, aggiungere l'opzione `-f` al comando:
>
> ```
> 1
> ```

> **Informazioni**
>
> I log di `patroni` sono disponibili anche in `/var/log/syslog`.

## Spiegazione dei log di errore

> **`ERROR: Request to server https://<PSQL_NODE_NAME>:2379 failed: MaxRetryError("HTTPSConnectionPool(host='<PSQL_NODE_NAME>', port=2379)`**
>
> Quando `etcd` non funziona o non è raggiungibile, `patroni` può scrivere gli errori seguenti:
>
> ```
> 1
> 2
> 3
> 4
> 5
> 6
> 7
> 8
> ```
>
> **`<PSQL_NODE_NAME>`**
>
> Nome di uno dei nodi del cluster PostgreSQL.
>
> In questo caso, è necessario [risolvere i problemi di `etcd`](https://docs.cyberelements.io/bastion/4.6/it/Installation/Dependencies/PostgreSQLCluster/Troubleshooting/EtcdDebug/).
