Overview
During the automation of processes, there are situations where the execution needs to be traced or debugged. Bizagi offers the possibility to trace errors in the Processes Work flows (for their control and diagnosis) so that you can validate if the business rules, validations, interfaces invocations, or even the Process needs to be tuned up.
How does tracing work?
Traces monitor the project at various levels, such as the process and its activities, the business rules, validations and business policies, interface invocations, and forms controls.
Traces at the environment level
To enable and configure tracing, you may enable each object/component separately and set a filter so that the generated logs include levels of detail (e.g. warnings and errors, or errors only).
|
Bear in mind that the excessive generation of .log files can cause performance issues. Therefore a good practice is to only activate the tracing option when troubleshooting issues in any of your environments. |
The steps to accomplish this are:
1. Acknowledging which traces to enable (from the different objects and components).
2. Defining their trace detail.
1. Acknowledging which traces to enable
Enabling the traces is done from the Management Console through the Tracing option:
To learn how to activate traces in your Automation Services environments, click here.
|
Even though the trace feature is available for all environments, it should be used mainly for debugging purposes (e.g traces for expressions) is mainly intended for the Development environment. It is strongly recommended to exploit this feature while testing the Processes so that in the Production environment this is only required if strictly necessary. For example, when an external web service has changed and no considerations were taken for this scenario, it can be useful to enable the traces in the Production environment to help detect unplanned behaviors. |
Once you click the Tracing configuration window, you will see the objects and components available: It is important to acknowledge and plan which traces you wish to enable.
The following table describes the possibilities regarding these objects and components:
ELEMENT |
DESCRIPTION |
|---|---|
Authentication |
Logs when a user is being authenticated in the System (User Request) and when the System is automatically validating a Request Session (Validation of Request Session). All the details such as date, level, trace name, trace type and sub-type, type and sub-type of authentication and message, will be added in the log file. |
Bizagi API / SOA / Entity manager |
Logs when an EntityManagerSOA web method is invoked. This option traces requests and responses.
There are three log files printed:
BizagiAPI_SOA_EntityManager[TimeStamp].log Prints the method of the SOA layer executed.
BizagiAPI_SOA_EntityManager_Request[TimeStamp].log Prints the inputs when executing the method.
BizagiAPI_SOA_EntityManager_Response[TimeStamp].log Prints the response of the method. |
Bizagi API / SOA / Workflow Engine |
Logs when an WorkflowEngineSOA web method is invoked. This option traces requests and responses.
There are three log files printed:
BizagiAPI_SOA_WorkFlowManager[TimeStamp].log Prints the method executed.
BizagiAPI_SOA_WorkFlowManager_Request[TimeStamp].log Prints theinput when executing the method.
BizagiAPI_SOA_WorkFlowManager_Response[TimeStamp].log Prints the response of the method. |
Bizagi API / SOA / Query |
Logs when an QuerySOA web method is invoked. This option traces requests and responses.
There are three log files printed:
BizagiAPI_SOA_QueryManager[TimeStamp].log Prints the method executed.
BizagiAPI_SOA_QueryManager_Request[TimeStamp].log Prints theinput when executing the method.
BizagiAPI_SOA_QueryManager_Response[TimeStamp].log Prints the response of the method. |
Connectors / WS Connector |
Logs when an external interface is invoked. This option traces requests and responses. For more information about tracing Web service invocations, refer to WS Connector traces. |
Connectors / SAP |
Logs when an SAP BAPI is invoked. This option traces inputs and outputs parameters. For more information about tracing SAP invocations, refer to SAP traces. |
Connectors / External Connectors |
Logs when a Connector Action is executed. This option traces Inputs, Outputs, data transformation and connector logic of the Connector. refer to Connector traces. |
Connectors / SAP Cloud Platform |
Logs when the SAP Cloud Connector is invoked. This option traces input and output parameters. For more information about tracing SAP invocations, refer to SAP traces. |
Connectors / Connectors.FormsRecogizer |
Logs when the Forms Recognizer connector is executed. Refer to Form Recognizer. This option traces Inputs, Outputs, and data transformation of the Connector. |
Data replication |
These logs register every time that a replication schema has been started and ended. Refer to Replication. Because the Scheduler executes replications, these logs are found with the following structure:
BATrace_Scheduler_[timeStamp].log |
ECM |
Logs the integration with ECM systems. For more information about tracing ECM integration, refer to ECM traces. |
Entity manager |
Logs the execution of EntityManager activity (database access). |
LDAP |
Logs the execution of the scheduled synchronization of LDAP users into Bizagi. Refer to Importing LDAP users. |
Render (Control) |
Logs the construction of a form in the Work Portal (rendering forms and their controls). |
RPA |
Logs when a RPA bot is invoked. This option traces input and output parameters. For more information about tracing RPA invocations, refer to RPA traces. |
Rules and expressions |
Logs the execution and evaluation of business rules and policies.
When the Custom sub-item is selected, it logs the user-defined traces which are manually included in Business Rules (by using the CHelper.trace function). For more information refer to Validating my business rules. |
Scheduler |
Logs the execution of the Scheduler's jobs. |
Workflow |
Logs when a transaction begins, when the information is saved in the database, when a case is created and the execution of each shape.
When the Assignment sub-item is selected, it logs the assignment rules execution as well. |
2. Defining the trace detail
To decide what alerts exactly to trace (the detail level), in the selected Tracing option in the Standard Menu, click the trace type and define its detail level (Error, Warning, All).
By default, None is selected (an empty box is shown) for all trace objects/components.
When Error is selected, the trace file will only log errors.
When Warning is selected, the trace file will log both warnings and errors.
When All is selected, the trace file will log: warnings, errors and step-by-step information about the executed commands.
Notice that you may select each trace type (and its subtypes) and select a trace detail configuration for each.
Traces location
Once enabled, traces can be accessed from the Management Console.
Last Updated 12/11/2024 12:04:00 PM