Service trace is a type of optional trace that is available in IBM® App Connect Enterprise, and it provides more information than that provided by the entries that are written to the Event Log or to user trace. Service trace is inactive by default; you must activate it explicitly by using a command.
With service trace, you can activate more comprehensive tracing of an integration node or server, and start tracing for the IBM App Connect Enterprise Toolkit. You can also trace the execution of all the commands described in Commands, including the trace commands themselves.
Activate service trace only when you receive an error message that instructs you to, or when you are directed to do so by your IBM Support Center. You use the mqsichangetrace command to start service trace; you cannot start it through the IBM App Connect Enterprise Toolkit. For more information about how to use service trace, see Starting service trace.
When you activate service trace, you cause additional processing for every activity in the component that you are tracing. Large quantities of data are generated by the components, so you can expect performance to be affected while service trace is active. You can limit this additional processing by being selective about what you trace, and by restricting the time during which trace is active.
The location of the trace log depends on whether it is the trace for a command, an integration node (or integration server managed by an integration node), or an independent integration server:
mqsilist myIntegrationNode --trace c:\tmp\listtrace.txt
The
trace data is written to the specified file in plain text format (in
this example, c:\tmp\listtrace.txt). The output is
appended to the end of the file; if the file does not exist, it is
created automatically.myIntegrationNodeName.myIntegrationServerName.trace.n.txt
where n is
a number between 0-3, indicating this specific file in the series
of four equally-sized files into which the trace log is divided.<workdir>/config/common/log
The
name of the log file takes the following form:integration_server.myIntegrationServerName.trace.n.txt
where n is
a number between 0-3, indicating this specific file in the series
of four equally-sized files into which the trace log is divided.The directory to which the service trace logs are written must be able to hold all the logs for that computer. You might want to place it on a separate file system, if that is allowed by your system operator.