Qué hacer cuando un job falla¶
1. Ubicar el fallo¶
- En Estado, abre el job y mira la última corrida: el código de salida (ver Entender el resultado de una corrida).
- Abre el log de esa corrida. Las últimas líneas con
ERRORsuelen decir la causa. - Mira las alertas recientes del job: cada código trae una acción sugerida (ver Códigos de alerta).
2. Buscar el mensaje en el runbook del job¶
Cada job tiene su runbook en Documentación › Jobs con una tabla de síntoma, causa probable y acción. Busca ahí el texto del error.
3. Causas frecuentes¶
| Síntoma | Causa y solución |
|---|---|
| Código 2, «Falta la variable…» | Falta en secrets/<repo>.env. Ver Cambiar o rotar un secreto |
| El comando falla con «no existe /opt/dabra/jobs/…» o código 127 | El comando del job quedó mal en el panel. sync_jobs lo corrige (se refresca siempre) |
Permission denied en /data/logs o /var/lib/dabra |
Falta chown 10001 en la carpeta del servidor: el contenedor corre con ese usuario |
Can't open lib 'ODBC Driver 17 for SQL Server' |
Revisar odbcinst -q -d dentro del contenedor y reconstruir la imagen |
| Falla de autenticación o timeout en SFTP | Clave vencida o rotada, o corte de red. Verificar las variables SFTP del job y la salida de red |
Permission denied al hacer backup |
El share de backup no está montado o no tiene permiso. El envío suele estar hecho; revisar el montaje |
| El job usa el correo del panel en lugar del suyo | Debe lanzarse con dabra-job; revisar que el comando empiece por /opt/dabra/bin/dabra-job |
LOCK_HELD |
Se lanzó un job mientras seguía corriendo la corrida anterior. Revisar si quedó colgada |
RUN_INTERRUPTED |
El panel se reinició durante la corrida. Revisar si el job dejó datos a medias y relanzar |
| Un job arranca tarde en una franja cargada | El panel ejecuta 4 jobs a la vez; el resto espera. Ajustar horarios |
4. Corregir y relanzar¶
- Para repetir la corrida de hoy: Ejecutar ahora.
- Para una fecha pasada: Reprocesar un día o un rango.
- Si es un envío a un tercero, confirma antes qué recibió el destinatario para no duplicarlo.
5. Si no se resuelve¶
Reúne el nombre del job, la fecha y hora de la corrida, el código de salida y las últimas líneas del log (sin copiar contraseñas) y escala al responsable del proyecto.