# Debugger

## Introduction

The Value Streams Debugger helps authorized users monitor running process instances, identify failed steps, and replay selected steps without restarting the entire process. In the debug mode, you can:

* Open a process instance overview directly from the value stream view.
* See the executed path in the model and identify failed steps.
* Open step-level details to review input, output, completion event, and status.
* Open the connected Make scenario from the selected step.

If your value stream uses subflows, debug each child flow separately to investigate the failures.

## Debug access and permissions

Debugger access is role-based:

* The debugger icon is visible in the Value Stream Modeller, for each specific value stream, only for users with the required admin role.
* You can create a dedicated user group and assign the required role to that group.
* Users without authorization cannot see the debugger icon and cannot access debugger data.

<figure><img src="/files/MDmdMpI9aJQZZ0opQXbj" alt="Debugger icon"><figcaption><p>Debugger icon</p></figcaption></figure>

## Process instance overview

When you click the debugger icon, the system opens a list of process instances for the value stream. You can filter the results by status or sort them by Instance ID or time.

<figure><img src="/files/kCE7WtAlYdKOyfQ5Awjs" alt="Debugger instances view"><figcaption><p>Debugger instances view</p></figcaption></figure>

When you select an instance the process opens in the advanced mode and you can see all the details:

* The actually executed path is highlighted in the model in green.
* If the instance is still running, or was not executed for any reason it's higlighted in relevant color and you can view the details in the steps.
* Failed steps are marked with a red status icon.
* Each step shows its execution status.

## Step-level detail view

Click any step in the executed path to open a side panel with the process details. For iterator steps, the panel shows the status of the last available iteration.

<figure><img src="/files/RArwkgGWmFnrNfAuICho" alt="Debugger view of a running step"><figcaption><p>Debugger view of a running step</p></figcaption></figure>

## View related Make scenarios

From a selected step, you can open the corresponding Make scenario. This option is available only when the single sign-on integration is working.

<figure><img src="/files/7ZvVHBPtOJXNP18fMIHY" alt="Debugger connection to Make scenario"><figcaption><p>Debugger connection to Make scenario</p></figcaption></figure>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://developer.emporix.io/value-stream-modeller/value-stream-designer/debugger.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.