> ## Documentation Index
> Fetch the complete documentation index at: https://docs.decisional.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Monitoring Runs

> Follow agent activity, inspect workflow steps, and recover incomplete work

A **run** is one execution of an agent. The Runs view shows what is active, what completed, and where an incomplete run needs attention.

## Open Agent Runs

Open an agent and choose **Runs** to see its execution history. If the agent has no runs yet, start a test or live run first.

The Agent Runs page has three parts:

* Summary cards for **Total Runs**, **Active Runs**, **Completed Runs**, and **Failed Runs**
* An activity chart for the selected time period
* A table of individual runs

<Frame caption="Agent Runs combines activity totals, a trend chart, run filters, and execution history.">
  <img src="https://mintcdn.com/decisional/scF9vHVkoBk7vGdp/images/runs/agent-runs-dashboard.png?fit=max&auto=format&n=scF9vHVkoBk7vGdp&q=85&s=477f04b1ee09f0a85e15c1e6bd9e97f6" alt="Agent Runs dashboard with total, active, completed, and failed run cards, an activity chart, filters, and a run table" width="1693" height="929" data-path="images/runs/agent-runs-dashboard.png" />
</Frame>

### Filter the run list

Use the controls above the table to narrow the list:

| Control | Available choices |
| - | - |
| **Time period** | 30 days, 14 days, 7 days, 24 hours, or a custom date range |
| **Run type** | All, Test, Live, and Action. Build runs are also visible to administrators. |
| **Status** | Any run status, including active, waiting, and final states |

The run table shows the information that is available for every execution:

| Column | What it shows |
| - | - |
| **Run ID** | The public identifier for the run |
| **Type** | Test, Live, Action, or Build |
| **Status** | The current run state |
| **Started** | Start date and time, relative time, and the person who started it when available |
| **Duration** | Elapsed execution time |
| **Action** | Cancel or Resume when that action is available |

<Note>
  A schedule, webhook, API call, or manual request can start a run, but the run list groups executions by **Test**, **Live**, **Action**, and **Build** rather than by trigger source.
</Note>

## Select a Run

Select a row to open that run in the agent workspace. Decisional places the workflow in run context and opens the run summary on the right.

<Frame caption="A selected run shows execution state on the workflow graph and a run summary on the right.">
  <img src="https://mintcdn.com/decisional/p_K8KTgUaUdelXwd/images/workflows/run-workflow-graph.png?fit=max&auto=format&n=p_K8KTgUaUdelXwd&q=85&s=0df4f744fca65d4d411ad6caeb79bbaa" alt="Completed workflow run with successful nodes and a run summary showing outputs, progress, and step counts" width="3020" height="1662" data-path="images/workflows/run-workflow-graph.png" />
</Frame>

### Read the workflow graph

The graph shows which workflow path ran and the execution state of each node. During a run:

* A running node shows active progress.
* A successful node is marked as completed.
* A failed or rejected node is marked as failed.
* A node can show several executions when it runs once for each item or row.
* A reused result is identified when a successful test execution was reused instead of running the node again.

Select a node to review its executions. If the node ran more than once, choose the individual execution you want to inspect.

### Read the run summary

The run summary shows:

* Run ID, type, and start time
* Overall progress across the workflow
* Total, succeeded, running, and failed step counts
* A shortcut to pending approvals when a step needs review
* A credit warning when a step is paused for credits
* Run output files grouped by the node that created them

Open **Run Outputs** to view or download an individual output file. Use **Back to chat** to return to the conversation without clearing the selected run.

## Inspect a Node Execution

Select a workflow node, open **Executions**, and choose an execution to see what happened at that step.

The execution panel can include:

| Section | What it contains |
| - | - |
| **Execution Info** | Node name and type, execution ID, status, duration, retry count, and timestamps |
| **Error Details** | The error returned by a failed execution |
| **Input Data** | The structured values the node received |
| **Output Data** | The structured values the node produced |
| **Live Logs** | Streaming or saved log lines, with an option to copy them |
| **Live Browser** | A live browser preview when a running browser task provides one |
| **Log Files** | Log artifacts that can be opened individually |
| **Approval Info** | The reviewer and notes for an approval decision |
| **Dex Status** | Follow-up state for a Dex node, including what it is waiting for when available |

<Tip>
  Start with **Error Details**, then compare **Input Data** and **Output Data**. Use **Live Logs** or **Log Files** when the error message alone does not explain the failure.
</Tip>

## Run Statuses

Every run has a status that tells you whether it is queued, active, waiting for something, or finished.

| Status | What it means | What you can do |
| - | - | - |
| **Pending** | The run was accepted and is waiting to start. | Open it to monitor progress or cancel an eligible Live or Test run. |
| **Running** | One or more workflow nodes are executing. | Watch the graph, inspect active nodes, or cancel an eligible Live or Test run. |
| **Pending approval** | A node is paused until a person approves or rejects it. | Open the approval from the run summary or node, then approve or reject it. |
| **Needs credits** | A node paused before a metered AI or code-agent call. | Add credits or raise the agent limit, then retry the affected node. |
| **Self-healing** | Decisional is diagnosing a failed execution and attempting a repair. | Follow its progress or cancel an eligible run. |
| **Waiting for input** | The repair process asked a person for clarification. | Return to chat, answer the question, or cancel an eligible run. |
| **Completed** | All required work finished successfully. | Review the graph, node executions, outputs, and files. |
| **Partially completed** | Some work finished, but one or more parts remain incomplete. | Inspect the affected node and Resume an eligible Live or Test run. |
| **Failed** | The run stopped because required work could not complete. | Inspect the failed execution and Resume an eligible Live or Test run. |
| **Cancelled** | A person stopped the run before it finished. | Review completed steps and any external actions before starting again. |

<Info>
  **Pending**, **Running**, **Pending approval**, **Needs credits**, **Self-healing**, and **Waiting for input** can still change. **Completed**, **Partially completed**, **Failed**, and **Cancelled** are final states.
</Info>

## Run and Node Actions

### Cancel a run

Cancel is available for eligible **Live** and **Test** runs while they are active or waiting. It is not offered for Build or Action runs from the run list.

<Warning>
  Cancelling stops remaining work. It does not reverse work that already completed, such as a message that was sent or a record that was updated.
</Warning>

### Resume incomplete work

Resume is available for eligible **Live** and **Test** runs in **Failed** or **Partially completed** status. It continues incomplete work instead of starting the entire run again.

### Retry one node

For a failed, retrying, or credit-blocked node execution, the execution panel can offer:

* **Retry** to run that node execution again
* **Edit Code & Retry** to adjust the node code for this job and retry it

<Note>
  Code entered through **Edit Code & Retry** applies only to that job. It does not update the agent's main workflow or other jobs.
</Note>

## Investigate an Incomplete Run

<Steps>
  <Step title="Open the run">
    Select the Failed or Partially completed run from Agent Runs.
  </Step>

  <Step title="Find the affected node">
    Use the workflow graph and run summary to locate failed, rejected, waiting, or credit-blocked work.
  </Step>

  <Step title="Open the execution">
    Select the node, open **Executions**, and choose the relevant execution.
  </Step>

  <Step title="Compare the evidence">
    Read the error, input, output, logs, and approval or credit state shown for that execution.
  </Step>

  <Step title="Correct the cause">
    Fix the underlying data, credential, integration, source, instruction, or workflow configuration.
  </Step>

  <Step title="Continue the right scope">
    Retry the affected node when the execution panel offers it, or Resume the run when incomplete Live or Test work remains.
  </Step>
</Steps>

## Related Docs

<CardGroup cols={2}>
  <Card title="Workflows" icon="diagram-project" href="/workflows/overview">
    Understand the graph and the nodes that execute during a run.
  </Card>

  <Card title="Approvals and Policy" icon="user-check" href="/agents/approvals">
    Learn how review steps pause and continue a run.
  </Card>

  <Card title="Dashboards and Usage" icon="layout-dashboard" href="/dashboards-and-usage">
    Monitor activity, tool calls, and credit usage across agents.
  </Card>

  <Card title="Using Dex" icon="message" href="/guides/ai-assistant">
    Ask about agents and runs from a conversation.
  </Card>
</CardGroup>
