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

# Resolución de problemas del clúster de PostgreSQL

> **Información**
>
> Todo el procedimiento debe realizarse como `root`. Para elevar sus privilegios a `root`, puede utilizar el comando `su -`.

> **Atención**
>
> Para seguir este procedimiento, es necesario haber realizado las [configuraciones adicionales para `patronictl`](https://docs.cyberelements.io/bastion/4.6/es/Installation/Dependencies/PostgreSQLCluster/Installation/Install/#additional-configurations-for-patronictl).

Los errores de conexión a la base de datos del clúster de PostgreSQL de CyberElements Bastion pueden tener diversas causas. Esta sección presenta una metodología general de resolución de problemas, que debe adaptarse a su caso.

## Comprobar el estado del clúster

> **Información**
>
> Comprobar el estado del clúster permite localizar rápidamente el nodo o los nodos que fallan.

Puede comprobar el estado del clúster con el siguiente comando, que debe ejecutarse en cada uno de los nodos del clúster de PostgreSQL:

```
1
```

> **Ejemplo de resultado en una plataforma que funciona**
>
> ```
> 1
> 2
> 3
> 4
> 5
> 6
> 7
> ```
>
> En el resultado anterior, todo indica que el clúster de PostgreSQL funciona correctamente: el lag es de 0 MB en todos los nodos `Replica`, y todos los nodos figuran en la lista con el estado `running`. Es necesario obtener este resultado en todos los nodos para validar el funcionamiento de `patroni` y de `etcd`.

> **Ejemplo de resultado cuando hay un problema de comunicación entre los nodos**
>
> ```
> 1
> 2
> 3
> 4
> 5
> 6
> 7
> ```
>
> En el resultado anterior, el lag de 230 MB es anómalo: podría indicar un problema de comunicación entre el nodo 3 y el nodo 1.
> Si el problema persiste tras varias horas de espera, esto lo confirma.

> **Ejemplo de resultado cuando un nodo no se ha iniciado o detenido correctamente**
>
> ```
> 1
> 2
> 3
> 4
> 5
> 6
> 7
> ```
>
> En el resultado anterior, el estado (columna `State`) indica que el nodo 1 se está iniciando. Si el estado `started` persiste varios minutos, o incluso varias horas, puede haber un problema con `patroni` o `etcd` en ese nodo.
> El nodo 2 está en el estado `stopped`: está detenido. En caso de fallo de un nodo del clúster, esta información solo se muestra temporalmente, antes de que el nodo se retire de la lista.

> **Ejemplo de resultado cuando `etcd` falla en el nodo actual**
>
> ```
> 1
> 2
> 3
> ```
>
> El resultado anterior indica un error de conexión a `etcd`, que impide obtener el estado del clúster de PostgreSQL.

> **Ejemplo de resultado cuando uno de los nodos está desincronizado**
>
> ```
> 1
> 2
> 3
> 4
> 5
> 6
> 7
> ```
>
> En el resultado anterior, el nodo `PSQL_1` ya no está en la misma `TL` que los demás. Para que el clúster funcione, todos los nodos deben estar en la misma `TL`: una diferencia indica que uno de los nodos está desincronizado.
> Para resolver este problema, siga el procedimiento de [desincronización de un nodo](https://docs.cyberelements.io/bastion/4.6/es/Installation/Dependencies/PostgreSQLCluster/Troubleshooting/PatroniDebug/#node-desynchronization).

## Comprobar el estado de los servicios

Una vez identificado el nodo que falla, hay que identificar el servicio que no funciona. Los dos servicios principales del clúster de PostgreSQL son `patroni` y `etcd`.

> **Información**
>
> El servicio `patroni` depende del servicio `etcd`: si `etcd` no funciona, `patroni` tampoco funcionará.

Para identificar el servicio que falla, puede ejecutar los siguientes comandos:

```
1
2
```

Estos comandos muestran el estado del servicio, así como sus 10 últimas líneas de logs.

> **Atención**
>
> Un servicio con el estado `active (running)` no funciona necesariamente: puede estar en ejecución y escribir logs de error. Por eso es importante leer los logs del servicio para entender su estado real.

> **Ejemplo de resultado para `etcd` cuando el servicio funciona**
>
> ```
>  1
>  2
>  3
>  4
>  5
>  6
>  7
>  8
>  9
> 10
> 11
> 12
> 13
> 14
> 15
> 16
> 17
> 18
> 19
> 20
> 21
> 22
> ```

> **Ejemplo de resultado para `etcd` cuando el servicio está en error**
>
> ```
>  1
>  2
>  3
>  4
>  5
>  6
>  7
>  8
>  9
> 10
> 11
> 12
> 13
> 14
> 15
> 16
> 17
> 18
> 19
> 20
> ```
>
> En el resultado anterior, el servicio `etcd` tiene el estado `failed`, y el error que le impidió iniciarse es el de la línea 17: el servicio no consigue leer el contenido del directorio `/var/lib/etcd/cleanroom`. En ese caso, conviene [ajustar los permisos del directorio](https://docs.cyberelements.io/bastion/4.6/es/Installation/Dependencies/PostgreSQLCluster/Troubleshooting/EtcdDebug/#error-log-explanations).

> **Ejemplo de resultado para `patroni` cuando el servicio funciona**
>
> ```
>  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
> ```

> **Ejemplo de resultado para `patroni` cuando el servicio está en error**
>
> ```
>  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
> ```
>
> En el caso anterior, el servicio tiene el estado `active (running)` sin funcionar realmente: los logs muestran diversos errores de conexión a `etcd`, que `patroni` necesita.
> En este ejemplo, `patroni` no es necesariamente la causa: como depende de `etcd`, primero hay que resolver los problemas de `etcd` y después volver a comprobar el estado de `patroni`.

## Procedimientos de resolución de problemas de los servicios

A continuación encontrará un procedimiento de resolución de problemas por servicio. Si tanto `etcd` como `patroni` fallan, empiece por `etcd`.

- **[Resolución de problemas de `etcd`](https://docs.cyberelements.io/bastion/4.6/es/Installation/Dependencies/PostgreSQLCluster/Troubleshooting/EtcdDebug/)**

  ---

  Procedimiento que debe seguirse cuando el servicio `etcd` falla.
- **[Resolución de problemas de `patroni`](https://docs.cyberelements.io/bastion/4.6/es/Installation/Dependencies/PostgreSQLCluster/Troubleshooting/PatroniDebug/)**

  ---

  Procedimiento que debe seguirse cuando el servicio `patroni` falla.
