13. Monitor de trabajos¶
El Monitor de Trabajos permite visualizar y supervisar las tareas que el sistema ejecuta de forma automática en segundo plano.
Estas tareas, denominadas jobs, se gestionan mediante colas de procesamiento (queues) y garantizan que las operaciones intensivas no bloqueen el uso normal del WebGIS.
Este módulo es una herramienta clave para: - controlar la correcta ejecución de procesos automáticos, - detectar errores de forma temprana, - y asegurar la fiabilidad operativa del sistema.
13.1 Permisos necesarios¶
Para acceder al Monitor de Trabajos, el usuario debe disponer del permiso:
Queue management
Este permiso está restringido a perfiles con responsabilidades técnicas o de administración.
Sin este permiso: - no es posible visualizar el estado de las colas, - ni consultar trabajos pendientes o fallidos.
Esto garantiza que la información interna del sistema esté protegida y controlada.
13.2 Vista general del Monitor¶
La pantalla del Monitor de Trabajos se organiza en dos secciones principales, que reflejan el estado de ejecución de las tareas.
13.2.1 Jobs pendientes¶
En esta sección se muestran los jobs que están en cola, es decir, tareas que han sido creadas pero aún no han finalizado su ejecución.
Para cada job se muestra la siguiente información:
| Campo | Descripción |
|---|---|
| ID | Identificador interno del trabajo. |
| Cola | Nombre de la cola donde se ha registrado el job (por ejemplo: queue_import_excel_samplings). |
| Intentos | Número de intentos de ejecución realizados hasta el momento. |
| Disponible desde | Tiempo transcurrido desde que el job entró en cola. |
| Payload | Información interna del job (parámetros técnicos del proceso). |
| Creado | Fecha y hora de creación del job. |
Un job pendiente indica que:
- el sistema ha aceptado la tarea,
- y la ejecutará en cuanto haya recursos disponibles.
Esto es normal en procesos como importaciones de datos o cálculos complejos.
13.2.2 Jobs fallidos¶
En esta sección se listan únicamente los trabajos que no han podido completarse correctamente.
Un job se marca como fallido cuando:
- supera el número máximo de reintentos,
- encuentra errores en los datos de entrada,
- o se produce un fallo inesperado durante su ejecución.
Cuando no existen errores recientes, el sistema muestra explícitamente:
No hay jobs fallidos
Este mensaje indica que el sistema está funcionando con normalidad.
13.3 Tipos de trabajos gestionados¶
El Monitor de Trabajos permite supervisar, entre otros, los siguientes procesos automáticos:
Importación de datos de muestreo¶
Cuando se carga un archivo Excel desde el módulo Importar Datos, el sistema genera un job específico llamado 'queue_import_excel_samplings'