Skip to content

Pipeline Events

Pipeline Events is the audit trail surface for Colony Cloud. Route: /reporting/events

Open it from Events in the Reporting region of the left navigation. The page heading reads “Pipeline Events”.

It presents a chronological stream of structured events emitted by the Colony pipeline — every state transition, agent decision, LLM invocation, and system signal recorded as an immutable entry. Use Pipeline Events to audit what happened, debug a stuck issue, or verify that a self-healing action fired.

Pipeline Events fetches from GET /pipeline/events with offset-based pagination. The stream includes every event type, scoped by the tenant and repository filters described below.

The event-type dropdown filters by these eight types. Under All types the stream can also show less common ones, such as strategy_snapshot.

Event typeWhat it records
state_transitionA pipeline issue moved from one state to another (e.g. planning → in-review).
agent_decisionAn agent produced a routing decision — which next step to take, which tool to invoke, or whether to escalate.
claude_executionA Claude LLM invocation completed — model, turn count, and token spend recorded.
workspace_lifecycleA Worker workspace was created, attached to a task, or torn down.
errorAn unhandled error occurred in the pipeline — includes the error message and the agent or Worker that emitted it.
circuit_breakerThe circuit breaker opened or closed on a downstream dependency (GitHub API, LLM provider, etc.).
cost_alertA cost threshold was crossed — daily, per-issue, or per-run cap triggered a warning or hard stop.
self_healingThe self-healing subsystem detected and acted on a pipeline anomaly automatically.

Three controls narrow the event stream:

  • Event type dropdown — select a single event type to show only events of that kind. Defaults to All types.
  • Tenant — the page follows the tenant chosen in the sidebar tenant selector.
  • Repository filter — the repository filter in the page chrome, carried in the URL as ?repo=owner/name, applies to Pipeline Events. Select a specific repository to see only events for that repo.

Changing the event type or repository filter resets the page offset back to the first page.

ColumnWhat it shows
TimeLocal timestamp of the event, formatted to the second.
Event typeThe event type as a colored badge.
RepositoryThe owner/repo that the event is associated with. Links to the Ledger filtered to that repository (/work?repo=owner/name).
IssueThe issue number, linking to the work item, which opens over this page as ?item=:owner/:repo/:number. Shows — for events with no issue.
AgentThe name of the agent or Worker that emitted the event.

When no events match, the table shows “No pipeline events match the current filters. Ledger shows what’s currently processing.” Ledger is a link to the Ledger.

The event table shows 50 events per page. When there are more than 50 results for the active filters, Previous and Next buttons appear below the table with a count of the current range (e.g. “Showing 1–50 of 312”).

Pagination is offset-based — navigating to the next page fetches the next 50 events from the API.

Pipeline Events is the starting point for any investigation into unexpected pipeline behavior.

To trace a stuck issue: filter by the repository and look for state_transition events for the issue number. The sequence of transitions shows exactly where the issue stalled and when.

To investigate a cost spike: filter by cost_alert and claude_execution to see which agent invocations were most expensive and when cost thresholds were breached.

To confirm self-healing fired: filter by self_healing to see whether the anomaly was automatically resolved, and by error to see the underlying error that triggered it.

To audit a circuit-breaker open: filter by circuit_breaker to see when a downstream service became unavailable and when it recovered.