# Process debugging

Tools provided by EximeeBPMS Cockpit allow debugging of processes, in particular insight into process variables and their current values.

After opening the detailed view of a process, all its running instances are presented. On the diagram, active instances are marked with a blue circle, while locations where an incident occurred are marked in red.

{% hint style="info" %}
Incidents are also visible in the **Process Instances** tab in the **State** column, where a red marker appears next to the instances.
{% endhint %}

<figure><img src="https://2112972046-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2CssJT0zIo4SJQLbSZ6l%2Fuploads%2FKY3mQKqA6LUFrGZP7iSE%2Fimage.png?alt=media&#x26;token=ade37f06-96c0-442f-a0d8-ce5f52fdfe53" alt=""><figcaption></figcaption></figure>

&#x20;After clicking the process number (in the **ID**column), the details of the specific instance are presented.

<figure><img src="https://2112972046-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2CssJT0zIo4SJQLbSZ6l%2Fuploads%2FXZrG15LSlGRXD4nT5Gh7%2Fimage.png?alt=media&#x26;token=a67205fc-d641-4294-9f88-68e5d9b0f8e8" alt=""><figcaption></figcaption></figure>

## Incidents

The **Incidents** displays errors generated by a given process instance. The most important column during debugging is the **Message**column, which shows the message describing the incident. Proper analysis of it is crucial to diagnose the problem.

<figure><img src="https://2112972046-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2CssJT0zIo4SJQLbSZ6l%2Fuploads%2FfoT1gcBFp1uBJmZENFVO%2Fimage.png?alt=media&#x26;token=39bfb53b-d994-4f1b-83d1-49bbbdcf5970" alt=""><figcaption></figcaption></figure>

After clicking the message content, a dialog window with the full message text will be displayed.

<figure><img src="https://2112972046-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2CssJT0zIo4SJQLbSZ6l%2Fuploads%2FEE3AJLwz7A1pj9lxsogq%2Fimage.png?alt=media&#x26;token=8d3615a6-7e70-43e0-bbb6-57893c330807" alt=""><figcaption></figcaption></figure>

On the right side in the **Action** column there is an icon of a curled arrow. Clicking it allows restarting the activity that ended in an incident.

## Variable values

Alternative text for the default value "Choose": **Variables** contain all variables and their values passed to the process. Clicking the red pencil icon allows manual editing of the values. Combined with the action of restarting an activity, this is a useful tool for testing and debugging the process.

<figure><img src="https://2112972046-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2CssJT0zIo4SJQLbSZ6l%2Fuploads%2FJPvmfBrRe0b1a5MiXFob%2Fimage.png?alt=media&#x26;token=4a96ccb7-e04e-4bff-a9d9-b21299779b60" alt=""><figcaption></figcaption></figure>

## Logs

While working with processes, it may happen that despite the time indicated in **router-api**, the latest version of the process will not appear in EximeeBPMS. In such a case the version visible in Cockpit may differ from the one available in Eximee Designer.

Information about errors that occurred during synchronization can be found in the ***process-handler-executor***.