IBM App Connect Enterprise, Version 11.0.0.2 Operating Systems: Windows, Linux


User trace

User trace is one of two types of optional trace that are available in IBM® App Connect Enterprise and provides more information than that provided by the entries that are written to the Administration log. User trace is inactive by default; you must activate it explicitly by using the IBM App Connect Enterprise web user interface or a REST API command.

For more information about logs, see Logs. For information about controlling user trace, see Controlling user trace.

Typically, you use user trace for debugging your applications, as it can trace integration servers.

When you activate user trace, you cause additional processing for every activity in the component that you are tracing. Large quantities of data are generated by the components. Expect to see some effect on performance while user trace is active. You can limit this additional processing by restricting the time during which trace is active.

The user trace log files

When trace is active, information is recorded in the user trace log files in plain text format.

The location of the trace logs is workpath/config/common/log where workpath is the work directory of the integration server as specified on the IntegrationServer command.
Note: For information about checking and changing the location of the work path; see Changing the location of the IBM App Connect Enterprise working directory.
Trace data is written to files with the format integration_server.name.userTrace.number.txt where:
name
The name of your integration server as specified on the --name of the IntegrationServer command.
number
An integer in the range 0 through 4. There are 5 user trace log files and IBM App Connect Enterprise writes to these files in a rotational manner. When user trace is started, trace data is written to the integration_server.name.userTrace.0.txt file. When the integration_server.name.userTrace.0.txt file becomes full, user trace data is then written to the integration_server.name.userTrace.1.txt file. The process continues until the integration_server.name.userTrace.4.txt file is full, at which point user trace data is written to the integration_server.name.userTrace.0.txt file and the existing data there is overwritten. The process continues in this rotational manner until user trace is stopped.

Using a Trace node

If you include a Trace node in your message flows when you are developing and testing them, this option not only gives you the ability to trace messages and activity in the flow, but also allows you to specify an alternate target file for the trace contents to isolate the detail in which you are interested. For details of how to use and configure a Trace node, see the Trace node topic.


an01310_.htm | Last updated 2018-11-02 14:45:57