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


Chapter 2 Designing and Implementing Custom Adapters : Tracing and Tracking

Tracing and Tracking
TIBCO Adapter SDK offers various ways to send information from a running custom adapter.
Tracing
Upon startup of an adapter application, the Adapter SDK creates a trace class that allows custom adapters to implement the following tracing functions:
Single trace message to multiple target sinks: Files, network (TIBCO Rendezvous messages), standard IO, and TIBCO Hawk. Users need only change the configuration of the adapter instance to change the destination of the trace messages.
Multiple roles per sink (info, debug, error, and warn). Users can attach any role to any sink in the adapter configuration. Adapter developers can also define custom roles.
TIBCO Adapter SDK implements the ActiveEnterprise trace format used by ActiveEnterprise applications. Developers create a separate XML file using a predefined format in which trace messages are stored. Each time the custom adapter needs to send out a trace message, it uses a message symbol. The SDK accesses the message corresponding to the message symbol in the XML file and sends it to the appropriate destination.
The Adapter SDK includes the genAeErrors utility, which parses the XML file containing message descriptions and generates appropriate code for inclusion in the custom adapter.
See TIBCO Adapter SDK Programmer’s Guide for more information on configuring and using tracing facilities. See also the description of MMessageBundle and MTrace in the TIBCO Adapter SDK API References.
Tracking
In contrast to tracing, tracking information is included with the data. This enables the tracking of the progression of data as it moves from one ActiveEnterprise application to another.
For example:
1.
2.
3.
TIBCO ActiveMatrix BusinessWorks performs data transformation, adds tracking information, and then sends the data to the messaging system.
4.
If a problem occurs, you can look into the tracking information to determine when the process stopped working as expected.
Tracking information uses an MTrackingInfo object. The source application places appropriate information into the MTrackingInfo objects using the MTrackingInfo::addApplicationInfo() method. SDK adds this application information to the MTree, MData, or MOperation. As the data is sent through the enterprise, each application adds information about its operations to messages that pass through.
You can use the tracking information within an ActiveEnterprise wire format message to trace where a message originated and where it has been.

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