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

# Monitoring Instances

> Follow live orchestration activity, inspect an instance's decision trail and case file, and review history in Logs.

Once an orchestration is live, you monitor it from three surfaces: the orchestration's **Dashboard** and **Activity** tabs for one orchestration, and **Monitor** > **Logs** for history across the project. Instance detail pages show the full decision trail for a single item.

## Instance statuses

These statuses appear across all monitoring views:

| Status               | Meaning                                                                      |
| -------------------- | ---------------------------------------------------------------------------- |
| **Queued**           | Waiting to start, or held back by the **Max active instances** limit         |
| **Active**           | A workflow run is executing                                                  |
| **Deciding**         | Overcut is evaluating what should happen next                                |
| **Waiting on human** | A person needs to approve, answer, or unblock the instance                   |
| **Completed**        | The goal was reached; terminal                                               |
| **Cancelled**        | Stopped before completion                                                    |
| **Failed**           | Work could not continue, for example a limit was reached with no way forward |

Hover a status chip to see the reason when one is recorded.

## Dashboard

Open an orchestration and select **Dashboard** for its health at a glance. The view auto-refreshes and follows the selected date range.

* **Total Instances**, **Success Rate**, **Avg Duration**, and **Currently Active** cards summarize the period. Most cards link to the matching filtered instance list.
* **Instances Per Day** charts volume over time, next to a per-status breakdown.
* **Recent Instances** lists the newest instances, with **View all instances** opening the full list in **Logs**.

## Activity

Select **Activity** for the live view of one orchestration. A funnel strip shows where every live instance is right now:

* **Queued**: instances waiting to begin.
* One box per allowed workflow, counting the instances currently in that workflow.
* **Other workflows**: instances whose current workflow is no longer in the allowed set.
* **Done**: recent terminal instances from the last day.

A badge on a funnel box means instances there are waiting on a person. Select one or more boxes to filter the live table underneath; clear them to see everything. The table updates while work progresses and links each row to its instance detail page.

## Logs

Open **Monitor** > **Logs** and switch to the **Orchestrations** tab for the historical **Orchestration Instances** list across the project. Filter by **Orchestration**, **Status**, and queued time range (**Last 24 hours**, **Last 7 days**, **Last 30 days**, or **All time**), and use **View Details** to open an instance.

The **Workflows** tab shows workflow runs, including the runs that orchestrations started. An **Orchestration** column links each orchestration-driven run back to its instance, and the run-type filter can hide orchestration-driven runs or include system runs.

## Instance details

The instance detail page is where you see why an orchestration moved the way it did. The summary bar shows the status, the **Orchestration**, the **Trigger** item (linked to its source), **Queued** and **Last activity** times, **Steps** against the configured maximum, and the pinned **Version**.

### The trail

The trail alternates between decision entries and step entries, newest last. Density controls switch between **Headlines only**, an overview with every entry open, and full detail.

Step entries show what a workflow run produced:

* **Summary**: the reported result, with a verdict (**Achieved**, **Partially achieved**, **Blocked**, or **Not applicable**) and a confidence percentage.
* **Proposed next**: the route or completion the run proposed.
* **Artifacts** and **Links**: outputs and references added during the work, including a link to the workflow run itself.

Decision entries show how the next move was chosen:

* **Proposal**: the proposed route or completion, who proposed it, the confidence, and the rationale.
* **Resolution**: the outcome and who resolved it. Human approvals show the approver, so consent is auditable.
* **Proposal history**: earlier proposals and whether they were superseded, rejected, or resolved.
* **Discussion**: a link to the discussion session, when one was held.

### Case file and links

The side panel holds the **Case file**, the running context that accumulates one summary entry per step, and **Links**, which collects related runs, instances, and external references as work progresses. Together with the trail, they let you follow the whole engagement without opening each workflow run.

## Related

* [Approvals and Discussions](/docs/orchestrations/approvals-and-discussions): act on instances that are waiting on a person.
* [Workflow Execution Control](/docs/workflows/workflow-execution-control): how the underlying workflow runs are queued and controlled.