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

# Dépanner le cluster PostgreSQL

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

Lorsque des erreurs de connexion à la base de données du cluster PostgreSQL de CyberElements Bastion se présentent, elles peuvent avoir diverses causes. Cette section présente une méthodologie de dépannage générale, à adapter à votre cas.

## Vérifier l'état du cluster

> **Information**
>
> Vérifier l'état du cluster permet de localiser rapidement le ou les nœuds défaillants.

Il est possible de vérifier l'état du cluster avec la commande suivante, à exécuter sur chacun des nœuds du cluster PostgreSQL :

```
1
```

> **Exemple de retour en cas de plateforme fonctionnelle**
>
> ```
> 1
> 2
> 3
> 4
> 5
> 6
> 7
> ```
>
> Dans le retour ci-dessus, l'ensemble des éléments indiquent que le cluster PostgreSQL est dans un état fonctionnel : le lag est à 0 MB pour tous les nœuds `Replica`, et tous les nœuds sont dans la liste, au statut `running`. Il est nécessaire d'obtenir ce retour sur l'ensemble des nœuds pour valider le fonctionnement de `patroni` et de `etcd`.

> **Exemple de retour dans le cas où il y a un problème de communication entre les nœuds**
>
> ```
> 1
> 2
> 3
> 4
> 5
> 6
> 7
> ```
>
> Dans le retour ci-dessus, le lag de 230 MB est anormal : il pourrait indiquer un problème de communication entre le nœud 3 et le nœud 1.
> Si le problème persiste après plusieurs heures d'attente, cela confirme le problème.

> **Exemple de retour dans le cas où un nœud n'est pas correctement démarré ou arrêté**
>
> ```
> 1
> 2
> 3
> 4
> 5
> 6
> 7
> ```
>
> Dans le retour ci-dessus, l'état (colonne `State`) indique que le nœud 1 est en cours de démarrage. Si le statut `started` persiste plusieurs minutes, voire plusieurs heures, il se peut qu'il y ait un problème avec `patroni` ou `etcd` sur ce nœud.
> Le nœud 2 est à l'état `stopped` : il est arrêté. En cas de défaillance d'un nœud du cluster, cette information n'est affichée que temporairement, avant que le nœud ne soit retiré de la liste.

> **Exemple de retour en cas de défaillance de `etcd` sur le nœud actuel**
>
> ```
> 1
> 2
> 3
> ```
>
> Le retour ci-dessus indique une erreur de connexion à `etcd`, qui empêche de récupérer l'état du cluster PostgreSQL.

> **Exemple de retour en cas de désynchronisation de l'un des nœuds**
>
> ```
> 1
> 2
> 3
> 4
> 5
> 6
> 7
> ```
>
> Dans le retour ci-dessus, 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.
> Pour résoudre ce problème, suivez la procédure de [désynchronisation d'un nœud](https://docs.cyberelements.io/bastion/4.6/fr/Installation/Dependencies/PostgreSQLCluster/Troubleshooting/PatroniDebug/#node-desynchronization).

## Vérifier l'état des services

Une fois le nœud défaillant identifié, il faut identifier le service dysfonctionnel. Les deux principaux services utilisés sur le cluster PostgreSQL sont `patroni` et `etcd`.

> **Information**
>
> Le service `patroni` dépend du service `etcd` : si `etcd` n'est pas fonctionnel, `patroni` ne le sera pas non plus.

Pour identifier le service défaillant, vous pouvez exécuter les commandes suivantes :

```
1
2
```

Ces commandes donnent l'état du service, ainsi que les 10 dernières lignes de logs qui lui sont liées.

> **Attention**
>
> Un service au statut `active (running)` n'est pas forcément fonctionnel : il peut être en cours d'exécution tout en écrivant des logs d'erreur. Il est donc important de lire les logs du service pour comprendre son état réel.

> **Exemple de retour pour `etcd` lorsque le service est fonctionnel**
>
> ```
>  1
>  2
>  3
>  4
>  5
>  6
>  7
>  8
>  9
> 10
> 11
> 12
> 13
> 14
> 15
> 16
> 17
> 18
> 19
> 20
> 21
> 22
> ```

> **Exemple de retour pour `etcd` lorsque le service est en erreur**
>
> ```
>  1
>  2
>  3
>  4
>  5
>  6
>  7
>  8
>  9
> 10
> 11
> 12
> 13
> 14
> 15
> 16
> 17
> 18
> 19
> 20
> ```
>
> Dans le retour ci-dessus, le service `etcd` est au statut `failed`, et l'erreur qui l'a empêché de démarrer est celle de la ligne 17 : le service n'arrive pas à lire le contenu du répertoire `/var/lib/etcd/cleanroom`. Il conviendra dans ce cas d'[ajuster les droits sur le répertoire](https://docs.cyberelements.io/bastion/4.6/fr/Installation/Dependencies/PostgreSQLCluster/Troubleshooting/EtcdDebug/#error-log-explanations).

> **Exemple de retour pour `patroni` lorsque le service est fonctionnel**
>
> ```
>  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
> ```

> **Exemple de retour pour `patroni` lorsque le service est en erreur**
>
> ```
>  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
> ```
>
> Dans le cas ci-dessus, le service est au statut `active (running)` sans être fonctionnel pour autant : les logs indiquent diverses erreurs de connexion à `etcd`, dont `patroni` a besoin.
> Dans cet exemple, `patroni` n'est pas forcément en cause : comme il dépend de `etcd`, il faut d'abord régler les problèmes de `etcd`, puis revérifier l'état de `patroni`.

## Procédures de dépannage des services

Vous trouverez ci-dessous une procédure de dépannage par service. Si `etcd` et `patroni` sont tous deux dysfonctionnels, commencez par `etcd`.

- **[Dépannage de `etcd`](https://docs.cyberelements.io/bastion/4.6/fr/Installation/Dependencies/PostgreSQLCluster/Troubleshooting/EtcdDebug/)**

  ---

  Procédure à suivre en cas de dysfonctionnement du service `etcd`.
- **[Dépannage de `patroni`](https://docs.cyberelements.io/bastion/4.6/fr/Installation/Dependencies/PostgreSQLCluster/Troubleshooting/PatroniDebug/)**

  ---

  Procédure à suivre en cas de dysfonctionnement du service `patroni`.
