Aller au contenu

Dépannage de patroni

Information

L'ensemble de la procédure est à suivre en tant que root. Pour élever ses privilèges en root, il est possible d'utiliser la commande su -.

Attention

Pour suivre cette procédure, il est nécessaire d'avoir effectué les configurations supplémentaires pour patronictl.

patroni est un orchestrateur de haute disponibilité pour PostgreSQL. Il automatise la gestion d'un cluster PostgreSQL en assurant l'élection du leader, la bascule (failover) et la synchronisation des nœuds en cas d'incident.

Dans le cluster PostgreSQL de CyberElements Bastion, patroni s'appuie sur etcd pour stocker et partager l'état du cluster. Il surveille en continu l'état des instances PostgreSQL et s'assure qu'un seul nœud est désigné leader à un instant donné.

En cas de défaillance du nœud leader, patroni orchestre automatiquement une élection au moyen du magasin de configuration distribué etcd, afin de promouvoir un nouveau leader et de maintenir la disponibilité du service.

patroni dépend donc de etcd, et ne peut pas fonctionner correctement si etcd n'est pas fonctionnel.

Désynchronisation d'un nœud

Il arrive qu'un nœud du cluster PostgreSQL se désynchronise. La désynchronisation est visible dans le retour de la commande 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 |
+------------------+----------------+---------+---------+----+-----------+

Dans la colonne TL, le nœud PSQL_1 n'est plus sur la même TL que les autres. Pour que le cluster soit fonctionnel, tous les nœuds doivent être sur la même TL : un écart indique une désynchronisation de l'un des nœuds.

Dans ce cas, exécutez la commande suivante sur le nœud désynchronisé :

1
patronictl -c /etc/patroni/config.yml reinit 15-cleanroomvault5 <MEMBER_PATRONI>

Où <MEMBER_PATRONI> est le nom du nœud désynchronisé, tel qu'il apparaît dans la colonne Member de la topologie.

Si plusieurs nœuds sont désynchronisés, resynchronisez tous ceux qui ne sont pas sur la TL la plus élevée.

Attention

Si le nœud désynchronisé est le nœud Leader, il peut y avoir une perte de données. Ce cas ne devrait normalement jamais se présenter : le nœud Leader est censé être sur la TL la plus élevée.

Exemple

Dans le retour de la commande patronictl -c /etc/patroni/config.yml topology ci-dessus, le nœud PSQL_1 est désynchronisé. Pour le resynchroniser, on utilise donc la commande suivante :

1
patronictl -c /etc/patroni/config.yml reinit 15-cleanroomvault5 PSQL_1

Logs

L'ensemble de cette procédure s'appuie sur les logs du service patroni, que l'on obtient avec la commande ci-dessous :

1
journalctl -u patroni

Astuce

Pour consulter les logs en direct, ajoutez l'option -f à la commande :

1
journalctl -fu patroni

Information

Les logs de patroni sont aussi disponibles dans /var/log/syslog.

Explication des logs d'erreur

ERROR: Request to server https://<PSQL_NODE_NAME>:2379 failed: MaxRetryError("HTTPSConnectionPool(host='<PSQL_NODE_NAME>', port=2379)

Lorsque etcd n'est pas fonctionnel ou pas joignable, patroni peut écrire les erreurs suivantes :

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>

Nom de l'un des nœuds du cluster PostgreSQL.

Il est nécessaire dans ce cas de dépanner etcd.