Monitor de Trabajos¶
Introducción¶
El módulo Monitor de Trabajos permite visualizar y supervisar el estado de las tareas ejecutadas por el backend del sistema.
Estas tareas se gestionan mediante colas de trabajo (queues) y se ejecutan de forma automática en segundo plano.
Este monitor es especialmente útil para:
- Controlar el progreso de importaciones de datos (como la carga de muestreos desde Excel).
- Verificar el envío de alertas automáticas a los usuarios suscritos.
- Detectar errores en tiempo real mediante la sección de Tareas Fallidas.
🔐 Permisos necesarios¶
Para acceder al Monitor de Trabajos se requiere el permiso: Queue management
Sin este permiso:
- El usuario no podrá visualizar el estado de las colas.
- No podrá consultar los jobs pendientes ni fallidos.
Este requisito asegura que solo usuarios con responsabilidades técnicas o de administración tengan acceso a información interna del sistema.¶
Vista general del Monitor¶
La pantalla se organiza en dos secciones principales:
1. Jobs Pendientes¶
En esta tabla se muestran las tareas que están en cola esperando a ser procesadas.
Los campos incluidos son:
| Campo | Descripción |
|---|---|
| ID | Identificador interno del job. |
| Cola | Nombre de la cola en la que está registrada la tarea (por ejemplo: queue_import_excel_samplings). |
| Intentos | Número de veces que se ha intentado ejecutar el trabajo. |
| Disponible Desde | Tiempo transcurrido desde que el job entró en cola. |
| Payload | Información codificada con los parámetros internos del job. |
| Creado | Fecha y hora en la que se registró el job. |
Un job (tarea) pendiente indica que el sistema lo ejecutará en breve, según disponibilidad del procesador de colas.
2. Jobs Fallidos¶
En esta sección se listan únicamente los trabajos que han fallado durante su procesamiento.
Un job aparece como fallido cuando:
- Supera el número máximo de reintentos.
- Produce un error inesperado en su ejecución.
- Falla por datos corruptos o por una configuración incorrecta.
Cada entrada suele incluir:
- Fecha/hora del fallo
- Cola en la que se ejecutó
- Número de intentos
- Error registrado (visible desde el panel detallado de Laravel Horizon)
Si no hay errores recientes, se mostrará:
"No hay jobs fallidos"
Ejemplos de trabajos gestionados por el sistema¶
El Monitor de Trabajos permite observar tareas como:
✔ Importación de datos de muestreo¶
Al cargar un archivo Excel desde el módulo Importar Datos, se crea un job del tipo:
queue_import_excel_samplings
Este job procesa todos los registros del Excel sin bloquear la interfaz del usuario.
✔ Envío de alertas a usuarios suscritos¶
Cuando el sistema detecta una alerta en base a la configuración de umbrales, se generan jobs encargados de enviar:
- Emails
- Notificaciones internas
- Otros avisos configurados
✔ Procesos programados o complejos¶
Incluyen tareas como:
- Generación automática de informes
- Reprocesado de capas satelitales
- Limpieza de datos antiguos
- Actualización de caché
Ventajas del uso del monitor¶
El Monitor de Trabajos facilita:
- Diagnóstico rápido: Saber si hay trabajos atascados o fallidos.
- Supervisión de procesos largos: Ver importaciones o cálculos pesados en tiempo real.
- Trazabilidad: Conocer cuándo y con qué parámetros se ejecutó cada job.
- Mantenimiento: Detectar errores de configuración o datos incompletos.