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