Task Runs & Dependency
🏃 Task Runs¶
The Task Runs page (/task-runs) provides real-time monitoring of task execution with live updates via a persistent connection.
✅ What it provides:
- Live Connection Indicator: Shows connection status (Live, Connecting, Error, Disconnected) with auto-reconnect.
- Table Columns: Task name, Group, Trigger Time, Lifecycle chain, Status badge, Agent, Started, Finished, Duration, Logs link.
- Lifecycle Visualization: Progressive status chain displayed inline —
IDLE → ACTIVE → TRIGGER → STARTED → RUNNING → [SUCCESS | FAILED | TERMINATED]. The current state is bold; running tasks show a pulsing indicator. - ADHOC Badge: Adhoc task executions are distinguished with a violet badge.
- Filters:
- Search by task name
- Status filter (RUNNING, SUCCESS, FAILED, IDLE, TRIGGER, ACTIVE, STARTED)
- Time range (6h, 12h, 24h, 3d, 7d)
- Pagination
- Click the eye icon to navigate to the full task run detail view.
💡 Example: Monitor all running tasks during a production deployment, filter by FAILED status to quickly identify issues, and drill into a specific task run to view its execution logs.
📋 Task Run Detail¶
The Task Run Detail page (/task-runs/$taskRunId) provides an in-depth view of a single task execution.
✅ What it provides:
- Task Details Card: Task name, assigned agent, duration, trigger time, started time, finished time.
- Lifecycle Timeline: Visual step-by-step timeline showing each status transition with icons and connecting lines. Completed steps are green, the current step is blue with animation, failed steps are red, and future steps are grayed out.
- Unified Log Viewer:
- Running tasks: Live streaming with auto-updating output.
- Completed tasks: Paginated log retrieval (500 lines per page).
- stdout / stderr tabs with line counts.
- Full-text search with match navigation (next/previous, match counter, highlighted results).
- Follow mode for auto-scrolling live output.
- Download logs as a text file.
- Reload to refresh log data.
💡 Example: A task has failed — navigate to its detail page, check the lifecycle timeline to see where it failed, switch to the stderr tab in the log viewer, and search for "ERROR" to pinpoint the issue.
🔗 Dependency¶
The Dependency graph on the Tasks & Groups page (/tasks) visualizes task relationships.
✅ What it provides:
- Display which tasks depend on others in an interactive graph view.
- Show execution progress with status overlays on task nodes.
- Help identify bottlenecks or failed upstream tasks.
- Supports zoom, pan, and recenter controls.
💡 Example:
Visualize Generate_Invoice → Send_Email_Invoice. See that the email task is waiting on the invoice generation. View dependency graphs to understand workflow structure and identify blocked tasks.
Frequently Asked Questions¶
Q: How do I check why a task failed?
A: Go to the Task Runs page (/task-runs) and filter by the task name and status "Failed" to see the execution details. Click the eye icon to open the Task Run Detail page, check the lifecycle timeline to see where it failed, and use the log viewer's stderr tab with search to find the error.
Q: Can I see real-time task execution status? A: Yes. The Task Runs page shows a live connection indicator and updates task statuses in real time. You can monitor active executions, view lifecycle progressions, and watch running task logs stream live.
Q: What does the ADHOC badge mean on a task run? A: The ADHOC badge (violet) indicates that the task was executed via the Adhoc Tasks console rather than through the regular scheduler. These are one-off commands dispatched by an operator or administrator.
Q: How do I download task logs? A: Open the Task Run Detail page by clicking the eye icon on any task run row. In the log viewer, use the Download button to save the full log output as a text file.