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

# Plan Monitoring

> Monitor task plan execution in Kodexa Studio with the DAG flow visualization, showing each step, status, timing, and progress through the workflow graph.

Plan Monitoring provides real-time visibility into how your task plans are executing. When a task is created from a template with planned activity, the plan status panel shows an interactive DAG (directed acyclic graph) visualization of the workflow.

<img className="block dark:hidden" src="https://mintcdn.com/kodexa/s0CgNICBzXlJtlNW/images/studio/project/project-job-history-light.png?fit=max&auto=format&n=s0CgNICBzXlJtlNW&q=85&s=8941b218b24fba0e4da5da9890328949" alt="Plan Monitoring dashboard showing DAG flow visualization" width="1440" height="900" data-path="images/studio/project/project-job-history-light.png" />

<img className="hidden dark:block" src="https://mintcdn.com/kodexa/s0CgNICBzXlJtlNW/images/studio/project/project-job-history-dark.png?fit=max&auto=format&n=s0CgNICBzXlJtlNW&q=85&s=37ad00125a4a3bd955619f57a535f7f5" alt="Plan Monitoring dashboard showing DAG flow visualization" width="1440" height="900" data-path="images/studio/project/project-job-history-dark.png" />

## DAG Flow Visualization

The plan status panel displays the plan as a top-to-bottom flow diagram where:

* **Nodes** represent planned items (executions, tasks, scripts, agents)
* **Edges** represent dependencies between steps
* **Edge labels** show action qualifiers for conditional dependencies (e.g., "approve", "reject")

Node colors indicate the current status of each step:

| Status         | Description                                          |
| -------------- | ---------------------------------------------------- |
| **Pending**    | Waiting for upstream dependencies to complete        |
| **Running**    | Currently executing                                  |
| **Completed**  | Finished successfully                                |
| **Failed**     | Encountered an error during execution                |
| **Deadlocked** | Cannot proceed because an upstream dependency failed |

Click on any node to view its execution details, including module options, execution logs, and error information.

## Monitoring Your Plans

Once a plan is activated, the Plan Monitoring view lets you:

* **Track step-by-step progress** — See which steps have completed and which are pending
* **Follow conditional branches** — See which path the workflow took based on reviewer actions or script decisions
* **Identify failures** — Failed nodes are highlighted and show error details
* **Detect deadlocks** — The platform automatically identifies steps that are blocked by upstream failures

## Execution Details

Each node in the DAG can be expanded to show:

* **Status** — Current execution state
* **Duration** — Time elapsed for the step
* **Module reference** — Which module was executed (for EXECUTION nodes)
* **Action taken** — Which action the reviewer clicked (for TASK nodes)
* **Script result** — Which action the script returned (for SCRIPT nodes)
* **Error details** — Exception information for failed steps

## Deadlock Handling

A plan enters a deadlocked state when a step fails and other pending steps depend on it (directly or transitively). When this happens:

* The failed step is marked with a failure status
* All transitively dependent pending steps are marked as deadlocked
* The plan is flagged for attention

To resolve a deadlock, you can retry the failed step or manually advance the plan past the failure.

<Tip>
  Use Plan Monitoring alongside [Event Activity](/studio/project/event-activity) for a complete picture of what is happening in your project's processing pipelines.
</Tip>