Ir para o conteúdo

Resolução de problemas do patroni

Informação

Todo o procedimento deve ser realizado como root. Para elevar os seus privilégios a root, pode utilizar o comando su -.

Atenção

Para seguir este procedimento, é necessário ter realizado as configurações adicionais para patronictl.

O patroni é um orquestrador de alta disponibilidade para PostgreSQL. Automatiza a gestão de um cluster PostgreSQL, assegurando a eleição do líder, a comutação por falha (failover) e a sincronização dos nós em caso de incidente.

No cluster PostgreSQL do CyberElements Bastion, o patroni apoia-se no etcd para armazenar e partilhar o estado do cluster. Monitoriza continuamente o estado das instâncias PostgreSQL e garante que apenas um nó é designado líder num dado momento.

Se o nó líder falhar, o patroni orquestra automaticamente uma eleição através do armazenamento de configuração distribuído etcd, a fim de promover um novo líder e manter o serviço disponível.

Por conseguinte, o patroni depende do etcd e não pode funcionar corretamente se o etcd não estiver a funcionar.

Dessincronização de um nó

Por vezes, um nó do cluster PostgreSQL pode ficar dessincronizado. Isto é visível na saída do 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 |
+------------------+----------------+---------+---------+----+-----------+

Na coluna TL, o nó PSQL_1 já não está na mesma TL que os restantes. Para que o cluster funcione, todos os nós devem estar na mesma TL: uma diferença indica que um dos nós está dessincronizado.

Neste caso, execute o seguinte comando no nó dessincronizado:

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

Em que <MEMBER_PATRONI> é o nome do nó dessincronizado, tal como aparece na coluna Member da topologia.

Se vários nós estiverem dessincronizados, ressincronize todos os que não estejam na TL mais alta.

Atenção

Se o nó dessincronizado for o nó Leader, podem perder-se dados. Isto nunca deveria acontecer: o nó Leader deve estar na TL mais alta.

Exemplo

Na saída do comando patronictl -c /etc/patroni/config.yml topology acima, o nó PSQL_1 está dessincronizado. Para o ressincronizar, utilize o seguinte comando:

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

Logs

Todo o procedimento se baseia nos logs do serviço patroni, que obtém com o comando abaixo:

1
journalctl -u patroni

Sugestão

Para acompanhar os logs em tempo real, adicione a opção -f ao comando:

1
journalctl -fu patroni

Informação

Os logs do patroni também estão disponíveis em /var/log/syslog.

Explicação dos logs de erro

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

Quando o etcd não está a funcionar ou não está acessível, o patroni pode escrever os seguintes erros:

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 de um dos nós do cluster PostgreSQL.

Neste caso, é necessário resolver os problemas do etcd.