Solución de problemas#
Este capítulo ayuda a encontrar la causa de los problemas más frecuentes de una instalación de Empowerment Center y a resolverlos. Cada problema se explica como síntoma, causa y solución. Al final está la referencia de los códigos de error que devuelve la API.
Por dónde empezar#
Casi todos los problemas dejan rastro en uno de estos sitios. Mírelos en este orden:
| Dónde | Qué le dice | Cómo |
|---|---|---|
| Las alertas operativas | Lo que el servidor ya ha detectado: licencia, BD de cliente caída, memoria, disco, colas, correo, envíos, tareas que fallan. | Administración › Operación › Alertas, o la franja roja de la parte superior. Pulse Comprobar ahora para no esperar a la ronda. |
| El Resumen de la consola | El estado de la BD propia y de su pool, la memoria, el disco, la licencia y la última comprobación de cada BD de cliente. | Administración › Operación |
| La pestaña Trabajos | Qué se está calculando, qué espera y los últimos fallidos con su error. | Administración › Operación › Trabajos |
| La auditoría | Qué hizo un usuario, con qué SQL, cuánto tardó y si falló. | Administración › Auditoría, filtrando por usuario, fechas o Fallidas |
| El registro del servidor | El detalle técnico de un fallo interno (la traza), lo que pasa al arrancar y los avisos que no se pudieron enviar. | docker compose -f deploy/compose.yaml logs backend |
Consejo
Cuando un usuario le diga «me ha salido un error», pídale la hora aproximada y qué estaba haciendo. Con la hora, busque en la auditoría sus entradas Fallidas y en el registro del servidor la línea «Fallo interno en una petición de …» de ese momento.
Páginas del capítulo#
- Arranque, licencia y acceso: el servidor no arranca, la licencia no vale, las contraseñas de las conexiones no se pueden leer, el inicio de sesión único falla, un usuario no puede entrar.
- Problemas en funcionamiento: la BD de un cliente no responde, consultas lentas, trabajos atascados, memoria o disco, correo que no sale, tareas programadas que fallan, eventos sin procesar, varias instancias.
- Códigos de error: los códigos que devuelve la API, qué significa cada uno y qué hacer.
Antes de pedir ayuda a Action Ware#
Reúna esto, que le pedirán:
- La versión, que dice la cabecera de la consola de operación («Servidor ecenter-1 · Empowerment Center 8.0.0») y
GET /api/about. - Las alertas abiertas y lo que dice el Resumen de la consola.
- Las líneas del registro del servidor alrededor de la hora del problema, con la traza si la hay.
- Si el problema es de una consulta, su entrada de la auditoría con el SQL (exportada a CSV).
- El motor y la versión de la BD del cliente, si el problema es de una conexión.
No envíe el fichero de entorno ni ningún secreto (ECENTER_SECRETS_KEY, contraseñas): no hacen falta.