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

# Resolução de problemas do cluster PostgreSQL

> **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).

Os erros de ligação à base de dados do cluster PostgreSQL do CyberElements Bastion podem ter várias causas. Esta secção apresenta um método geral de resolução de problemas, a adaptar ao seu caso.

## Verificar o estado do cluster

> **Informação**
>
> Verificar o estado do cluster permite localizar rapidamente o nó ou os nós em falha.

Pode verificar o estado do cluster com o seguinte comando, a executar em cada nó do cluster PostgreSQL:

```
1
```

> **Exemplo de resultado numa plataforma funcional**
>
> ```
> 1
> 2
> 3
> 4
> 5
> 6
> 7
> ```
>
> No resultado acima, tudo indica que o cluster PostgreSQL está a funcionar: o lag é de 0 MB em todos os nós `Replica` e todos os nós constam da lista, com o estado `running`. É necessário obter este resultado em todos os nós para confirmar que o `patroni` e o `etcd` estão a funcionar.

> **Exemplo de resultado quando existe um problema de comunicação entre os nós**
>
> ```
> 1
> 2
> 3
> 4
> 5
> 6
> 7
> ```
>
> No resultado acima, o lag de 230 MB é anómalo: pode indicar um problema de comunicação entre o nó 3 e o nó 1.
> Se o problema persistir após várias horas, tal confirma-o.

> **Exemplo de resultado quando um nó não foi corretamente iniciado ou parado**
>
> ```
> 1
> 2
> 3
> 4
> 5
> 6
> 7
> ```
>
> No resultado acima, o estado (coluna `State`) indica que o nó 1 está a iniciar. Se o estado `started` persistir durante vários minutos, ou mesmo horas, pode existir um problema com o `patroni` ou o `etcd` nesse nó.
> O nó 2 está no estado `stopped`: está parado. Quando um nó do cluster falha, esta informação só é apresentada temporariamente, antes de o nó ser removido da lista.

> **Exemplo de resultado quando o `etcd` falha no nó atual**
>
> ```
> 1
> 2
> 3
> ```
>
> O resultado acima indica um erro de ligação ao `etcd`, que impede a obtenção do estado do cluster PostgreSQL.

> **Exemplo de saída quando um dos nós está dessincronizado**
>
> ```
> 1
> 2
> 3
> 4
> 5
> 6
> 7
> ```
>
> Na saída acima, 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.
> Para resolver este problema, siga o procedimento de [dessincronização de um nó](https://docs.cyberelements.io/bastion/4.6/pt/Installation/Dependencies/PostgreSQLCluster/Troubleshooting/PatroniDebug/#node-desynchronization).

## Verificar o estado dos serviços

Depois de identificado o nó em falha, é necessário identificar o serviço que não está a funcionar. Os dois principais serviços utilizados no cluster PostgreSQL são o `patroni` e o `etcd`.

> **Informação**
>
> O serviço `patroni` depende do serviço `etcd`: se o `etcd` não estiver a funcionar, o `patroni` também não funcionará.

Para identificar o serviço em falha, pode executar os seguintes comandos:

```
1
2
```

Estes comandos indicam o estado do serviço, bem como as suas 10 últimas linhas de log.

> **Atenção**
>
> Um serviço com o estado `active (running)` não está necessariamente a funcionar: pode estar em execução e escrever logs de erro. Por isso, é importante ler os logs do serviço para compreender o seu estado real.

> **Exemplo de resultado para o `etcd` quando o serviço está a funcionar**
>
> ```
>  1
>  2
>  3
>  4
>  5
>  6
>  7
>  8
>  9
> 10
> 11
> 12
> 13
> 14
> 15
> 16
> 17
> 18
> 19
> 20
> 21
> 22
> ```

> **Exemplo de resultado para o `etcd` quando o serviço está em erro**
>
> ```
>  1
>  2
>  3
>  4
>  5
>  6
>  7
>  8
>  9
> 10
> 11
> 12
> 13
> 14
> 15
> 16
> 17
> 18
> 19
> 20
> ```
>
> No resultado acima, o serviço `etcd` tem o estado `failed` e o erro que o impediu de iniciar é o da linha 17: o serviço não consegue ler o conteúdo do diretório `/var/lib/etcd/cleanroom`. Neste caso, [ajuste as permissões do diretório](https://docs.cyberelements.io/bastion/4.6/pt/Installation/Dependencies/PostgreSQLCluster/Troubleshooting/EtcdDebug/#error-log-explanations).

> **Exemplo de resultado para o `patroni` quando o serviço está a funcionar**
>
> ```
>  1
>  2
>  3
>  4
>  5
>  6
>  7
>  8
>  9
> 10
> 11
> 12
> 13
> 14
> 15
> 16
> 17
> 18
> 19
> 20
> 21
> 22
> 23
> 24
> 25
> 26
> 27
> 28
> 29
> ```

> **Exemplo de resultado para o `patroni` quando o serviço está em erro**
>
> ```
>  1
>  2
>  3
>  4
>  5
>  6
>  7
>  8
>  9
> 10
> 11
> 12
> 13
> 14
> 15
> 16
> 17
> 18
> 19
> 20
> 21
> 22
> 23
> 24
> 25
> 26
> 27
> 28
> 29
> ```
>
> No caso acima, o serviço tem o estado `active (running)` sem estar realmente a funcionar: os logs mostram vários erros de ligação ao `etcd`, de que o `patroni` necessita.
> Neste exemplo, o `patroni` não é necessariamente o culpado: uma vez que depende do `etcd`, resolva primeiro os problemas do `etcd` e, em seguida, volte a verificar o estado do `patroni`.

## Procedimentos de resolução de problemas dos serviços

Segue-se um procedimento de resolução de problemas por serviço. Se tanto o `etcd` como o `patroni` estiverem em falha, comece pelo `etcd`.

- **[Resolução de problemas do `etcd`](https://docs.cyberelements.io/bastion/4.6/pt/Installation/Dependencies/PostgreSQLCluster/Troubleshooting/EtcdDebug/)**

  ---

  Procedimento a seguir quando o serviço `etcd` está em falha.
- **[Resolução de problemas do `patroni`](https://docs.cyberelements.io/bastion/4.6/pt/Installation/Dependencies/PostgreSQLCluster/Troubleshooting/PatroniDebug/)**

  ---

  Procedimento a seguir quando o serviço `patroni` está em falha.
