Tareas programadas de Admin: historial de ejecuciones cron

Compruebe si una tarea en segundo plano se ejecutó, cuánto tardó y si falló: filtre el historial de ejecuciones cron de su organización por tarea, estado y fecha en Admin → Tareas programadas.

Parte del trabajo en Docklify ocurre en segundo plano según un horario: nadie pulsa un botón, la tarea simplemente se ejecuta cuando llega su hora. Admin → Tareas programadas es donde usted comprueba esas ejecuciones después: cada ejecución deja una fila con cuándo empezó, cuánto tardó, si tuvo éxito o falló, un breve resumen de lo que hizo y el mensaje de error si falló. La página solo muestra las ejecuciones de su propia organización. Solo los roles Owner y Admin pueden abrirla.

Paso 1: Abra el historial y lea una fila#

1. Abra Admin → Tareas programadas (/admin/cron-runs). La lista de ejecuciones se carga sola: aquí no hay nada que iniciar ni configurar.
2. Elija cualquier fila y léala de izquierda a derecha: hora de inicio, nombre de la tarea, duración, estado, resumen, error.
3. Si la lista es larga, use el paginador al pie de la tabla para recorrerla: la página muestra 50 ejecuciones a la vez por defecto.

• Inicio es el momento en que empezó esa ejecución, mostrado hasta el segundo: úselo para relacionar una ejecución con la hora en que algo debía ocurrir.
• Tarea es el nombre de la tarea programada, mostrado tal como el sistema la nombra.
• Resumen es una breve lista de lo que produjo la ejecución: conteos y resultados en forma simple de clave y valor. Los resúmenes largos se cortan en la tabla, así que tome la fila como el titular, no como el informe completo.
• Error queda vacío (un guion) en las ejecuciones que no fallaron. En una ejecución fallida muestra el mensaje de error, cortado en la tabla: pase el cursor por encima para leer el texto completo.

Una fila es una ejecución, no una tarea. La misma tarea aparece de nuevo cada vez que se ejecuta, así que una tarea sana acumula una larga serie de filas con los días. Cuando recorre la tabla en Admin → Tareas programadas, en realidad está leyendo esa serie: las filas cercanas al momento que le importa, en el orden que la tabla le da tras filtrar.

Paso 2: Filtre por tarea, estado y fecha#

1. En la tarjeta de filtros sobre la tabla, elija una Tarea, o déjela en Todos para ver todas las tareas juntas.
2. Elija un Estado si solo le importa un tipo de resultado: por ejemplo Fallido, para ver solo las ejecuciones que salieron mal.
3. Defina una fecha Desde y Hasta para reducir la lista a un período: una noche, una semana, cuando se notó el problema.
4. Haga clic en Buscar. La lista se recarga desde la primera página con sus filtros aplicados.

El selector de tareas en Admin → Tareas programadas lista las tareas programadas que informan ejecuciones para su organización: employee-term-sweep, abc-analysis y sequence-runner. Elegir una es la forma más rápida de responder «¿esta tarea en concreto se ha estado ejecutando últimamente?»: si sus filas siguen apareciendo puntuales y con Éxito, sí.

Paso 3: Lea el estado y la duración#

• success (verde): la ejecución terminó e hizo su trabajo.
• failed (rojo): la ejecución se detuvo con un error. Lea la columna Error de la misma fila antes de hacer cualquier otra cosa.
• running (amarillo): la ejecución empezó y aún no terminó. Vuelva a mirar dentro de un rato; una ejecución terminada pasa a success o failed.
• Duración se muestra en segundos, o en minutos y segundos en ejecuciones más largas (por ejemplo 2m5s). Un guion significa que la ejecución aún no tiene duración registrada: típico mientras sigue en curso.

Lea el estado y la duración juntos. Un success que de pronto tarda diez veces más que sus ejecuciones habituales merece anotarse aunque haya pasado, y un failed con una duración muy corta suele haberse detenido al principio: el texto de error de esa misma fila dirá dónde. Comparar una ejecución con las filas anteriores de la misma tarea en Admin → Tareas programadas es la forma más rápida de detectar ambos patrones.

Paso 4: Compruebe una tarea que sospecha que no se ejecutó#

1. Filtre por esa tarea y ponga el período de fechas en cuando debía ejecutarse, luego haga clic en Buscar.
2. Si no hay ninguna fila en ese período, no se registró ninguna ejecución para ese momento: la tarea no se ejecutó, o no informó de una ejecución.
3. Una fila con failed significa que sí se ejecutó y encontró un problema: copie el nombre de la tarea, la hora de inicio y el texto completo del error (pase el cursor para verlo todo): ese trío es lo que pedirá soporte.
4. Una fila que sigue en running mucho después de empezar merece una segunda mirada más tarde: repita la búsqueda y vea si pasó a success o failed.

Funciones de Docklify usadas en este artículo#

• Historial de ejecuciones cron de su organización (inicio / tarea / duración / estado / resumen / error) — Admin → Tareas programadas (/admin/cron-runs)
• Filtros de ejecuciones por tarea, estado y rango de fechas, con Buscar — Admin → Tareas programadas (/admin/cron-runs)
• Lectura del estado de un vistazo (running / success / failed, por colores) — Admin → Tareas programadas (/admin/cron-runs)
• Texto completo del error en ejecuciones fallidas (pase el cursor sobre la celda Error) — Admin → Tareas programadas (/admin/cron-runs)