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

# Resolución de problemas de `patroni`

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

`patroni` es un orquestador de alta disponibilidad para PostgreSQL. Automatiza la gestión de un clúster de PostgreSQL asegurando la elección del líder, la conmutación por error (*failover*) y la sincronización de los nodos en caso de incidente.

En el clúster de PostgreSQL de CyberElements Bastion, `patroni` se apoya en `etcd` para almacenar y compartir el estado del clúster. Supervisa de forma continua el estado de las instancias de PostgreSQL y se asegura de que un solo nodo sea designado líder en un momento dado.

Si el nodo líder falla, `patroni` orquesta automáticamente una elección mediante el almacén de configuración distribuido `etcd`, con el fin de promover un nuevo líder y mantener la disponibilidad del servicio.

Por tanto, `patroni` depende de `etcd` y no puede funcionar correctamente si `etcd` no funciona.

## Desincronización de un nodo

A veces, un nodo del clúster de PostgreSQL puede desincronizarse. La desincronización se observa en el resultado del comando `patronictl -c /etc/patroni/config.yml topology`:

```
1
2
3
4
5
6
7
```

En la columna `TL`, 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.

En ese caso, ejecute el siguiente comando en el nodo desincronizado:

```
1
```

Donde `<MEMBER_PATRONI>` es el nombre del nodo desincronizado, tal como aparece en la columna `Member` de la topología.

Si hay varios nodos desincronizados, resincronice todos los que no estén en la `TL` más alta.

> **Atención**
>
> Si el nodo desincronizado es el nodo `Leader`, puede producirse una pérdida de datos. Este caso no debería darse nunca: el nodo `Leader` debe estar en la `TL` más alta.

> **Ejemplo**
>
> En el resultado del comando `patronictl -c /etc/patroni/config.yml topology` anterior, el nodo `PSQL_1` está desincronizado. Para resincronizarlo, se utiliza el siguiente comando:
>
> ```
> 1
> ```

## Logs

Todo este procedimiento se basa en los logs del servicio `patroni`, que se obtienen con el siguiente comando:

```
1
```

> **Consejo**
>
> Para consultar los logs en directo, añada la opción `-f` al comando:
>
> ```
> 1
> ```

> **Información**
>
> Los logs de `patroni` también están disponibles en `/var/log/syslog`.

## Explicación de los logs de error

> **`ERROR: Request to server https://<PSQL_NODE_NAME>:2379 failed: MaxRetryError("HTTPSConnectionPool(host='<PSQL_NODE_NAME>', port=2379)`**
>
> Cuando `etcd` no funciona o no es accesible, `patroni` puede escribir los siguientes errores:
>
> ```
> 1
> 2
> 3
> 4
> 5
> 6
> 7
> 8
> ```
>
> **`<PSQL_NODE_NAME>`**
>
> Nombre de uno de los nodos del clúster de PostgreSQL.
>
> En este caso, es necesario [resolver los problemas de `etcd`](https://docs.cyberelements.io/bastion/4.6/es/Installation/Dependencies/PostgreSQLCluster/Troubleshooting/EtcdDebug/).
