Copyright © TIBCO Software Inc. All Rights Reserved
Copyright © TIBCO Software Inc. All Rights Reserved


Chapter 5 Manage the Interior Server : Tracing

Tracing
This section describes how to enable tracing and view tracing output in TIBCO Administrator, the TIBCO BusinessConnect engine, and the TIBCO BusinessConnect palette.
Tracing for TIBCO Administrator
Enabling Tracing
To enable tracing, access the file TIBCO_HOME\tra\domain\domain_name\ AdministrationDomain.properties and set the property LogDebug=true.
Viewing the Log
View tracing output in the log TIBCO_HOME\tra\domain\domain_name\ logs\Administrator.log
Tracing for the TIBCO BusinessConnect Engine
Enabling Tracing for all TIBCO ActiveMatrix BusinessWorks Tasks
To enable tracing for all TIBCO ActiveMatrix BusinessWorks tasks:
1.
Locate the BusinessConnect-Interior_Server.tra file in the TIBCO_HOME\tra\domain\domain_name\application\BusinessConnect directory.
2.
Trace.Task.*=True.
3.
Click Save.
4.
Set log4j.logger.bw.logger property
1.
locate the file BC_HOME\lib\is\log4j.xml
2.
<logger name="bw.logger">
   <level value ="INFO"/>
<appender-ref ref="tibco_bw_log"/>
</logger>
INFO is the default setting you can change it to DEBUG.
TIBCO LogLogic Integration
When you select DEBUG from log level, the details of the logs related to the transaction processing are traced. These logs are in a format that can be easily parsed and analyzed through TIBCO LogLogic. When these detailed logs are combined with the Gateway Server logs and the audit database, they provide an end to end view of the processing of a transaction. Below is a sample entry:
2017 Jun 30 13:02:51:577 GMT +0530 BW.BusinessConnect-Interior_Server Debug [bw.logger]
BW-EXT-LOG-300002 Job-4030.4030.B910EE33-F6C9-4EF3-BB3A-B5F188A89805.<machine
name>-t460-Interior-Server IBHTTPHandler.createAndSetSyncReply: HTTP message received. Returning HTTP 200
OK.
View the Log
You can view tracing output in the logs TIBCO_HOME\tra\domain\domain_name\application\logs\BusinessConnect-Interior_Server.log
Enabling Verbose Tracing for TIBCO ActiveMatrix BusinessWorks Service Instances
To enable verbose tracing for TIBCO ActiveMatrix BusinessWorks service instances follow these steps.
1.
In the Configuration Builder window, click the hostname-Interior_Server link (where hostname is the name of the machine on which the TIBCO BusinessConnect server component is deployed)
The Dialog Edit Service Instance: Interior Server appears with three tabs: General, Process Configuration, and Advanced.
Figure 8 Editing Service Instance Dialog
2.
Click the Process Configuration tab.
3.
In the General section, select the Enable Verbose Tracing check box.
4.
Click Save.
5.
For more information, see TIBCO ActiveMatrix BusinessWorks Administration, section Changing Server Settings.
Enabling Tracing for the TIBCO BusinessConnect Palette
To enable tracing in TIBCO BusinessConnect palette, create a global variable bc.palette.tracing and specify one of the following values: debug, error, warn, or info. In debug, you'll see every message on transport coming and going before dispatching to TIBCO ActiveMatrix BusinessWorks or before sending from TIBCO ActiveMatrix BusinessWorks.
On high volume and/or large messages in debug mode, performance will be heavily affected.
Production environments should set this property's value to none or remove this global variable altogether. For verbose tracing (most of the comments are such), the debug value is recommended.
Tracing is also self-describing as the palette reports the status of its tracing when initialized either from the designer or loaded runtime. If the property is not configured, the TIBCO BusinessConnect palette displays the name of the tracing property as well as the possible values that you can specify.
View the Log
There are two different contexts when using the TIBCO BusinessConnect palette:
During design-time, tracing output goes to the stdout.log file of the folder set in Edit > Preferences > General > User Directories > User Log Directory.
During runtime, tracing output goes to the following locations:

Copyright © TIBCO Software Inc. All Rights Reserved
Copyright © TIBCO Software Inc. All Rights Reserved