Vai al contenuto

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.

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
+ Cluster: 15-cleanroomvault5 ------+---------+---------+----+-----------+
| Member           | Host           | Role    | State   | TL | Lag in MB |
+------------------+----------------+---------+---------+----+-----------+
| PSQL_3           | psql_3         | Leader  | running | 3  |           |
| + PSQL_1         | psql_1         | Replica | running | 2  |       230 |
| + PSQL_2         | psql_2         | Replica | running | 3  |         0 |
+------------------+----------------+---------+---------+----+-----------+

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
patronictl -c /etc/patroni/config.yml reinit 15-cleanroomvault5 <MEMBER_PATRONI>

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
patronictl -c /etc/patroni/config.yml reinit 15-cleanroomvault5 PSQL_1

Log

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

1
journalctl -u patroni

Suggerimento

Per seguire i log in tempo reale, aggiungere l'opzione -f al comando:

1
journalctl -fu patroni

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
patroni[1812916]: 2026-04-17 15:23:51,431 INFO: Retrying on https://<PSQL_NODE_NAME>:2379
patroni[1812916]: 2026-04-17 15:23:51,434 ERROR: Request to server https://<PSQL_NODE_NAME>:2379 failed: MaxRetryError("HTTPSConnectionPool(host='<PSQL_NODE_NAME>', port=2379): Max retries exceeded with url: /v3/lease/keepalive (Caused by NewConnectionError('<urllib3.connection.HTTPSConnection object at 0x7f8924a49fd0>: Failed to establish a new connection: [Errno 111] Connection refused'))")
patroni[1812916]: 2026-04-17 15:23:51,434 INFO: Reconnection allowed, looking for another server.
patroni[1812916]: 2026-04-17 15:23:51,434 INFO: Retrying on https://<PSQL_NODE_NAME>:2379
patroni[1812916]: 2026-04-17 15:23:51,438 ERROR: Request to server https://<PSQL_NODE_NAME>:2379 failed: MaxRetryError("HTTPSConnectionPool(host='<PSQL_NODE_NAME>', port=2379): Max retries exceeded with url: /v3/lease/keepalive (Caused by NewConnectionError('<urllib3.connection.HTTPSConnection object at 0x7f8924a48c50>: Failed to establish a new connection: [Errno 111] Connection refused'))")
patroni[1812916]: 2026-04-17 15:23:51,438 INFO: Reconnection allowed, looking for another server.
patroni[1812916]: 2026-04-17 15:23:53,940 ERROR: Request to server https://<PSQL_NODE_NAME>:2379 failed: ReadTimeoutError("HTTPSConnectionPool(host='<PSQL_NODE_NAME>', port=2379): Read timed out. (read timeout=2.0772262712319693)")
patroni[1812916]: 2026-04-17 15:23:53,940 INFO: Reconnection allowed, looking for another server.
<PSQL_NODE_NAME>

Nome di uno dei nodi del cluster PostgreSQL.

In questo caso, è necessario risolvere i problemi di etcd.