Skip to main content

Watch and recover your workflow runs

Find any run, read its status and step timeline, and recover from failures from the Monitoring section of your workspace.

Where monitoring lives

Open Monitoring in your workspace sidebar (the Activity icon). It holds three children: Runs, Logs, and Approvals. Clicking the group itself takes you to the run list. There is no separate monitoring dashboard, so the run list at /[workspaceSlug]/monitoring/workflow-runs is where you start most of the time.

The Runs list shows every execution across your workflows: its Run ID, the workflow that produced it, status, start and completion times, and duration. From there you open a single run to read its step-by-step timeline, or you pause, resume, and cancel a run that is still in flight.

Run detail refreshes itself while a run is active

The run detail page polls for updates every 10 seconds while a run is pending or running, and stops once the run reaches a terminal status. It also pauses polling in background browser tabs, so a completed run that looks static is not frozen. Use the Refresh button to pull the latest state at any time.

Find and read a run

Start in the run list, narrow it down, then open the run that interests you.

  1. Filter the run list

    The list has two filters: a free-text Run ID field and a Status dropdown (Running, Completed, Failed, Paused, Cancelled). See Find and filter runs.

  2. Open one run

    Click a Run ID to open its detail page: the overview metadata, a progress bar, the trigger payload, and the Execution Steps timeline. See Read a run.

  3. Search the logs

    For activity that crosses runs, use Logs to search by severity (Debug, Info, Warn, Error) and lifecycle event type. See Search logs.

Recover from a failure

When a run fails, the detail page surfaces the first failed step. The timeline shows a Jump to failed step link and auto-expands that step, where you read the error code, the upstream provider status, and whether the error is retryable.

Debug a failed run

Read the error code, provider status, and retryable flag on the failed step, then decide whether to re-run.

Walk a failure end to end in Debug a failed run.

Control a run in flight

Pause, resume, or cancel a run. Which action is available depends on the run's current status.

Replay a run

Re-run a finished run as-is, or with a new prompt or model. Replay is available only for completed, failed, or cancelled runs.

Approvals

The Approvals child is a pending-task inbox for runs that are waiting on a human decision. When tasks are pending, the sidebar shows a count badge next to Approvals. Each task lists its kind, the action it gates, and when it expires, with a Review button to open it. A run that is waiting on an approval does not advance until the task is reviewed.

What you cannot do here

The run list filters by Run ID and status only. It does not offer date, cost, or model filters, and the run list and detail pages do not have a cost breakdown or a live log tail. The Status dropdown also omits two real statuses, pending and waiting, even though both appear in step counts on the run detail page. To narrow runs by start time, sort or scan the Started column directly.

Next steps

Was this helpful?