Task Queue
Task Queue is the live work queue surface for Colony Cloud. Route: /dashboard/task-queue
It shows every pipeline task that is pending (waiting for a Worker to claim it) or claimed (actively being processed). Use Task Queue to measure queue depth, spot stalled tasks, and understand wait times before they affect throughput.
Summary cards
Section titled “Summary cards”Four cards at the top of the page give an at-a-glance read on queue health.
| Card | What it shows |
|---|---|
| Pending | Number of pipeline tasks queued but not yet assigned to a Worker. |
| Claimed | Number of tasks currently claimed by a Worker and being processed. |
| Avg wait | Mean elapsed time since task creation across all current pending tasks. A rising average indicates Worker pickup is slow or task processing is stalled. |
| Oldest pending | Elapsed time since the oldest pending task was enqueued. The label turns amber when this value exceeds 5 minutes — a signal that at least one task type may not be getting picked up. |
For canonical definitions and calculation details for Pending tasks, Avg queue wait, Oldest pending age, and Write queue, see Metrics — Queue / DLQ.
Task table
Section titled “Task table”Below the summary cards, every pending and claimed task in the queue appears as a row.
| Column | What it shows |
|---|---|
| Task type | The internal task identifier (e.g. analyze, plan, implement). Displayed in monospace. |
| Issue | The GitHub issue number for the task. Links to the issue on GitHub. |
| Repository | The owner/repo for the task. Links to the repository page. |
| Status | pending (waiting for a Worker) or claimed (being processed). |
| Wait | Time elapsed since the task was enqueued. Turns amber when the wait exceeds 5 minutes. |
Rows where the wait time exceeds 5 minutes are highlighted with an amber background to draw attention to potentially stale tasks.
Empty state
Section titled “Empty state”When the queue is empty, a message confirms there are no pending or claimed tasks. This is the expected steady state when all queued work has been picked up by Workers.
Repository scoping
Section titled “Repository scoping”The global repository filter in the sidebar applies to the Task Queue. When a specific repository is selected, the summary cards recalculate against only the tasks for that repository, and the task table filters to matching rows.
Import plan (admin only)
Section titled “Import plan (admin only)”Operators with the owner or admin role see an Import plan button in the page header. This opens the Import Plan dialog, which enqueues a batch of pipeline tasks from an external plan file. Standard members do not see this control.