Skip to content

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.

Four cards at the top of the page give an at-a-glance read on queue health.

CardWhat it shows
PendingNumber of pipeline tasks queued but not yet assigned to a Worker.
ClaimedNumber of tasks currently claimed by a Worker and being processed.
Avg waitMean 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 pendingElapsed 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.

Below the summary cards, every pending and claimed task in the queue appears as a row.

ColumnWhat it shows
Task typeThe internal task identifier (e.g. analyze, plan, implement). Displayed in monospace.
IssueThe GitHub issue number for the task. Links to the issue on GitHub.
RepositoryThe owner/repo for the task. Links to the Ledger filtered to that repository (/work?repo=owner/name).
Statuspending (waiting for a Worker) or claimed (being processed).
WaitTime elapsed since the task was enqueued. Turns amber when the wait exceeds 5 minutes.
Est. durationAn 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.

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.

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.