How to view integration logs

Frends includes powerful view to see what happened during a specific integration flow.

In order to see what happened during integration flow execution, Frends has a view called Process Instance.

Step by Step Tutorial Available

If you prefer more visual or interactive guidance on how to view Process logs with Frends, you can find a step-by-step walkthrough from your own environment's home page, under Onboarding by selecting "Tutorial 2b, Step 2: Process Logs" tour.

Accessing process instances

The Process Instances are accessible through Process list by selecting Show Process instances. You can also access the Process Instance list by clicking on Last execution or Instance counts per day columns from the Process list.

How to access Process Instances from Process list.

Then selecting any of the Process Instances on the Process Instance list will take you to the chosen execution's Instance view.

Process Instance list view.

Viewing Multiple Processes' Instances at once

In order to see Instances for multiple Processes at once, you can use the bulk actions for Processes. Simply select the wanted (or all) Processes using the checkboxes in Process List view, select Actions from the top of the list, and finally select Show Process Instances from the menu.

Opening Process Instance List view for multiple Processes.

Opening the Process Instance list this way allows you to view and filter multiple Processes' Instances at once, showing for example the lifecycle of a specific Order ID through multiple Processes in one view.

Process Instance List showing executions for multiple Processes.

Process Instance list filters

In the Process Instance list, you can filter the shown Instances using time period and the state of the Process Instance. The search also supports searching for results and values promoted from the Process execution using SQL wildcards.

The Instance list is automatically refreshed by default, to show the current state of the executions in almost real time. In case there are a lot of executions happening, setting the Auto refresh to Off might help in focusing on the earlier executions.

Process Instance view usage

From the Process Instance view it is possible to see what happened at each stage of the execution, shape by shape.

Example Process Instance view.

From the view, it's possible to click on the Process elements to see details of that part of the Process. Depending on logging settings in the Process as well as in the Agent Group, some details of the execution might not be always visible.

Functionality in the Process Instance view is similar to Process Editor view, but instead of allowing editing the Process and shape details, it shows what happened during the execution.

Process Instance view with HTTP Request Task selected.

Common information shown for each shape are:

• Start time, when the execution of chosen shape was started
• Duration, how long the execution took for that shape
• Task or Expression, what was executed
• Result, showing what was the result of the execution

If extended logging is enabled for the Process or Agent Group (Log everything in Log settings), the input parameters are also logged and shown here. Because extended logging has some impact on performance, this level of logging is recommended to be used only temporarily. The Log settings provide an easy way to set Log everything for only a specified duration.

Extended information shown for the executed Task, when "Log everything" is set.

It's also possible that log settings were adjusted so that Only errors are logged, or Skip logging result and parameters is enabled for some elements in the Process. In these situations details for successful shape executions are not logged. This is useful for production use, when there can be many and more executions and as long as there are no errors, most details of the executions are not needed.

No data shown for the Process execution with "Only errors" log level set.

Viewing Multiple Processes' Instances at once

In order to see Instances for multiple Processes at once, you can use the bulk actions for Processes. Simply select the wanted (or all) Processes using the checkboxes in Process List view, select Actions from the top of the list, and finally select Show Process Instances from the menu.

Opening Process Instance List view for multiple Processes.

Opening the Process Instance list this way allows you to view and filter multiple Processes' Instances at once, showing for example the lifecycle of a specific Order ID through multiple Processes in one view.

Process Instance List showing executions for multiple Processes.