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

# 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`](https://docs.cyberelements.io/bastion/4.6/pt/Installation/Dependencies/PostgreSQLCluster/Installation/Install/#additional-configurations-for-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
```

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
```

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
> ```

## Logs

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

```
1
```

> **Sugestão**
>
> Para acompanhar os logs em tempo real, adicione a opção `-f` ao comando:
>
> ```
> 1
> ```

> **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
> ```
>
> **`<PSQL_NODE_NAME>`**
>
> Nome de um dos nós do cluster PostgreSQL.
>
> Neste caso, é necessário [resolver os problemas do `etcd`](https://docs.cyberelements.io/bastion/4.6/pt/Installation/Dependencies/PostgreSQLCluster/Troubleshooting/EtcdDebug/).
