Gå till innehållet

Felsökning av patroni

Information

Hela proceduren ska utföras som root. För att höja dina privilegier till root kan du använda kommandot su -.

Varning

För att kunna följa denna procedur måste du ha utfört de ytterligare konfigurationerna för patronictl.

patroni är en orkestrerare för hög tillgänglighet för PostgreSQL. Den automatiserar hanteringen av ett PostgreSQL-cluster genom att sköta val av ledare, redundansväxling (failover) och synkronisering av noderna när en incident inträffar.

I PostgreSQL-clustret för CyberElements Bastion förlitar sig patroni på etcd för att lagra och dela clustrets tillstånd. Den övervakar kontinuerligt tillståndet för PostgreSQL-instanserna och säkerställer att endast en nod är utsedd till ledare vid varje given tidpunkt.

Om ledarnoden slutar fungera orkestrerar patroni automatiskt ett val via det distribuerade konfigurationslagret etcd, för att befordra en ny ledare och hålla tjänsten tillgänglig.

patroni är därför beroende av etcd och kan inte fungera korrekt om etcd inte fungerar.

Desynkronisering av en nod

En nod i PostgreSQL-clustret kan ibland bli osynkroniserad. Det syns i utdata från kommandot 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 |
+------------------+----------------+---------+---------+----+-----------+

I kolumnen TL ligger noden PSQL_1 inte längre på samma TL som de andra. För att clustret ska fungera måste alla noder ligga på samma TL: en skillnad visar att en av noderna är osynkroniserad.

Kör i så fall följande kommando på den osynkroniserade noden:

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

Där <MEMBER_PATRONI> är namnet på den osynkroniserade noden, så som det visas i kolumnen Member i topologin.

Om flera noder är osynkroniserade ska du synkronisera om alla som inte ligger på den högsta TL.

Varning

Om den osynkroniserade noden är noden Leader kan data gå förlorade. Detta ska aldrig inträffa: noden Leader förväntas ligga på den högsta TL.

Exempel

I utdata från kommandot patronictl -c /etc/patroni/config.yml topology ovan är noden PSQL_1 osynkroniserad. Använd följande kommando för att synkronisera om den:

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

Loggar

Hela proceduren bygger på loggarna för tjänsten patroni, som du hämtar med kommandot nedan:

1
journalctl -u patroni

Tips

Lägg till alternativet -f i kommandot för att följa loggarna i realtid:

1
journalctl -fu patroni

Information

Loggarna för patroni finns också i /var/log/syslog.

Förklaring av felloggar

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

När etcd inte fungerar eller inte kan nås kan patroni skriva följande fel:

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>

Namnet på en av noderna i PostgreSQL-clustret.

I så fall behöver du felsöka etcd.