Debugging processes

The tools provided by EximeeBPMS Cockpit enable process debugging, in particular access to process variables and their current values.

After opening the detailed process view, all of its launched instances are displayed. On the diagram, active instances are marked with a blue circle, while the places where an incident occurred are marked with a red symbol.

Incidents are also visible in the tab Process Instances in the column State, where a red marker appears next to the instances.

After clicking on the process number (in the column ID), details of a specific instance are displayed.

Incidents

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

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

On the right side in the column Action there is a rolled-up arrow icon. Clicking it enables restarting the activity that ended with an incident.

Variable values

In the Variables contains all variables and their values passed to the process. Clicking the red pencil icon allows manual editing of the value. Combined with the activity restart action, it is a useful tool for testing and debugging the process.

Logs

While working with processes, it may happen that despite the time elapsed specified 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 logs process-handler-executor.