Task Queue
Task Queue is the live work queue surface for Colony Cloud. Route: /operations/throughput?view=tasks
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. Shows — when nothing is pending. 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.
When at least one pending task has history to estimate from, a Projected drain (pending tasks with history) line appears under the cards. It is hidden otherwise. For the definition, 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 Ledger filtered to that repository (/work?repo=owner/name). |
| 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. |
| Est. duration | An estimated task duration, or — when there is not enough history. For the definition, see Metrics — Queue / DLQ. |
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: “Queue is empty. No tasks are pending or claimed.” With a repository filter active, it reads “No tasks queued for owner/name.” instead. Either way, the message links to the Ledger, which shows what is currently processing. An empty queue is the expected steady state when all queued work has been picked up by Workers.
Repository scoping
Section titled “Repository scoping”The repository filter in the page chrome, carried in the URL as ?repo=owner/name, 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.
To import a plan, use Import a plan in the Ledger’s Proposals band. See Drafts.