Ejecutar tarea¶
Aprende a lanzar tareas y monitorear su ejecución en tiempo real.
Formas de ejecutar¶
Ejecución automática (CRON)¶
Las tareas programadas se ejecutan automáticamente según su horario.
No requiere acción del usuario.
Ejecución manual¶
Lanzar una tarea inmediatamente, independientemente de su tipo.
Ejecutar manualmente¶
Desde la lista de tareas¶
- Ve a Tareas
- Localiza la tarea
- Haz clic en Ejecutar
Desde los detalles¶
- Abre los detalles de la tarea
- Haz clic en el botón Ejecutar
Desde el Workspace¶
- En el Workspace, puedes ejecutar tareas como parte de una conversación
- Usa el comando o acción rápida correspondiente
Panel de ejecución¶
Al ejecutar una tarea, se abre el panel de monitoreo:
┌─────────────────────────────────────────────────────────────────┐
│ Ejecutando: Backup base de datos [Cancelar] │
├─────────────────────────────────────────────────────────────────┤
│ │
│ Estado: ⏳ En progreso │
│ Inicio: 25/01/2025 14:30:15 │
│ Duración: 00:01:23 │
│ │
│ ┌─────────────────────────────────────────────────────────┐ │
│ │ [14:30:15] Iniciando backup... │ │
│ │ [14:30:16] Conectando a PostgreSQL... │ │
│ │ [14:30:17] Conexión establecida │ │
│ │ [14:30:18] Exportando tabla: users (1500 registros) │ │
│ │ [14:30:25] Exportando tabla: projects (45 registros) │ │
│ │ [14:30:28] Exportando tabla: executions (8500 reg.) │ │
│ │ [14:31:15] Comprimiendo archivo... │ │
│ │ [14:31:38] Subiendo a S3... │ │
│ │ ▌ │ │
│ └─────────────────────────────────────────────────────────┘ │
│ │
│ Progreso: ████████████░░░░░░░░ 60% │
│ │
└─────────────────────────────────────────────────────────────────┘
Elementos del panel¶
| Elemento | Descripción |
|---|---|
| Estado | En cola / En progreso / Completado / Fallido |
| Inicio | Fecha y hora de inicio |
| Duración | Tiempo transcurrido |
| Logs | Salida en tiempo real |
| Progreso | Barra de progreso (si disponible) |
| Cancelar | Detener la ejecución |
Estados de ejecución¶
stateDiagram-v2
[*] --> EnCola
EnCola --> Ejecutando
Ejecutando --> Completada
Ejecutando --> Fallida
Ejecutando --> Cancelada
Completada --> [*]
Fallida --> [*]
Cancelada --> [*]| Estado | Icono | Descripción |
|---|---|---|
| En cola | Esperando recursos disponibles | |
| Ejecutando | En progreso | |
| Completada | Terminó exitosamente | |
| Fallida | Terminó con error | |
| Cancelada | Detenida por el usuario |
Logs en tiempo real¶
Durante la ejecución, los logs aparecen en tiempo real gracias a SignalR:
- Cada línea incluye timestamp
- Los errores se resaltan en rojo
- Las advertencias en amarillo
- Puedes hacer scroll para ver todo
Filtrar logs¶
En ejecuciones largas, puedes filtrar:
- Errores: Solo mensajes de error
- Warnings: Solo advertencias
- Info: Mensajes informativos
- Buscar: Texto específico
Cancelar ejecución¶
Si necesitas detener una tarea:
- Haz clic en Cancelar
- Confirma la acción
- El sistema envía señal de parada
- La tarea termina con estado Cancelada
Cancelación parcial
La cancelación puede no ser inmediata. El agente intentará terminar de forma limpia, lo que puede tomar unos segundos.
¿Cuándo cancelar?¶
- La tarea está tardando más de lo esperado
- Detectas un error en los logs
- Ya no necesitas el resultado
- Lanzaste la tarea por error
Resultado de la ejecución¶
Al terminar, el panel muestra:
Ejecución exitosa¶
┌─────────────────────────────────────────────────────────────────┐
│ ✓ Completada: Backup base de datos │
├─────────────────────────────────────────────────────────────────┤
│ │
│ Estado: ✓ Éxito │
│ Duración: 00:02:45 │
│ Fin: 25/01/2025 14:33:00 │
│ │
│ RESULTADO: │
│ ┌─────────────────────────────────────────────────────────┐ │
│ │ Backup completado exitosamente. │ │
│ │ │ │
│ │ - Tablas exportadas: 15 │ │
│ │ - Registros totales: 12,450 │ │
│ │ - Tamaño del archivo: 45 MB │ │
│ │ - Ubicación: s3://backups/2025-01-25/db-backup.sql.gz │ │
│ └─────────────────────────────────────────────────────────┘ │
│ │
│ [Ver logs completos] [Ejecutar de nuevo] [Cerrar] │
│ │
└─────────────────────────────────────────────────────────────────┘
Ejecución fallida¶
┌─────────────────────────────────────────────────────────────────┐
│ ✗ Fallida: Backup base de datos │
├─────────────────────────────────────────────────────────────────┤
│ │
│ Estado: ✗ Error │
│ Duración: 00:00:45 │
│ Fin: 25/01/2025 14:31:00 │
│ │
│ ERROR: │
│ ┌─────────────────────────────────────────────────────────┐ │
│ │ ❌ Error de conexión a PostgreSQL │ │
│ │ │ │
│ │ Connection refused: Unable to connect to database │ │
│ │ server at localhost:5432 │ │
│ │ │ │
│ │ Posibles causas: │ │
│ │ - El servidor PostgreSQL no está corriendo │ │
│ │ - Puerto 5432 bloqueado por firewall │ │
│ │ - Credenciales incorrectas │ │
│ └─────────────────────────────────────────────────────────┘ │
│ │
│ [Ver logs completos] [Reintentar] [Crear issue] [Cerrar] │
│ │
└─────────────────────────────────────────────────────────────────┘
Acciones post-ejecución¶
Ejecutar de nuevo¶
Lanza la misma tarea inmediatamente.
Ver logs completos¶
Abre la página de detalles con todos los logs sin truncar.
Reintentar (en fallos)¶
Vuelve a ejecutar la tarea después de un fallo.
Crear issue (en fallos)¶
Crea un item en el backlog con los detalles del error.
Ejecuciones en paralelo¶
Nexus puede ejecutar múltiples tareas simultáneamente:
- Cada tarea corre de forma independiente
- Los recursos se distribuyen equitativamente
- Puedes monitorear todas desde Ejecuciones
Límites
Hay un límite de ejecuciones paralelas según la configuración del servidor. Las tareas adicionales esperan en cola.
Notificaciones¶
Configura notificaciones para saber cuando terminan:
- En la configuración de la tarea
- Activa notificaciones por:
- Slack (si está configurado)
Tipos de notificación¶
| Evento | Descripción |
|---|---|
| Éxito | La tarea terminó correctamente |
| Fallo | La tarea terminó con error |
| Duración | La tarea tardó más de X minutos |
Siguiente: Historial - Ver ejecuciones pasadas.