IBM Performance Management

Configuring transaction tracking for the DataPower agent

To display transaction tracking data for DataPower appliances in the middleware and topology dashboards, you must enable transaction tracking for the DataPower® agent.

Before you begin

  • Install the DataPower agent and configure it to connect to the DataPower appliance.
  • Enable monitoring for SOAP or ARM in the DataPower appliance.

About this task

For IBM Performance Management V8.1.2 Fix Pack 1, transaction tracking of SOAP traffic through the DataPower appliance is supported. DataPower transaction tracking supports SOAP using files store:///soapreq.xsl, store:///soaprsp.xsl, and store:///soaperror.xsl. These XSL files instrument the Web Service Proxy to add and report on kd4:KD4SoapHeaderV2 in the SOAP Envelope.

For IBM Performance Management V8.1.3 and later, transaction tracking of REST traffic through the DataPower appliance is also supported. In addition to the soap*.xsl files, DataPower transaction tracking also includes apm_req.xsl, apm_rsp.isl, and apm_error.xsl, which support incoming HTTP requests containing an ARM_CORRELATOR: HTTP Header, or a SOAP Envelope containing ITCAMCorrelator or kd4:KD4SoapHeaderV2. The Web Service Proxy updates or sets the outgoing request to contain an ARM_CORRELATOR: HTTP Header, and removes the SOAP correlators.

Note: If DataPower appliances are added to a business application, and the appliance carries traffic for multiple applications, after Transaction tracking is enabled, the application topology displayed for those business applications includes paths to nodes for all applications.

Procedure

To enable Transaction tracking for the DataPower agent, complete the following steps:

  1. In the navigation bar, click System Configuration icon System Configuration > Agent Configuration.
  2. On the DataPower tab, select the agent instances for which you want to enable transaction tracking.
  3. Select Actions > Set Transaction Tracking > Enabled to enable transaction tracking. The status of the agent in the Transaction Tracking column is updated to Enabled.

Results

You have enabled transaction tracking for the selected agent instances.

What to do next

To see data for a DataPower appliance in the middleware and topology dashboards, you must now add the appliances that you want to monitor to the Application Performance Dashboard. For further information about adding a DataPower appliance to the Application Performance Dashboard, see Adding middleware applications to the Application Performance Dashboard.
Note: If you are using Integration Services and you want to monitor IBM Integration Bus → DataPower, additional configuration is required to show an accurate Aggregate Transaction Topology. The IBM® Integration Bus agent cannot include correlation support for SOAP messages without a SOAP envelope. SOAPRequest nodes, SOAPAsyncRequest nodes, and SOAPReply nodes may accept messages without SOAP Envelopes as input messages. For these nodes, there is no relationship displayed in the topology view from the mediation to the downstream mediation or the application server. To avoid this problem, insert a SOAPEnvelope node immediately before the SOAPRequest, SOAPAsyncRequest, or SOAPReply nodes in your IBM Integration Bus message flow, and select the Create new envelope option for the SOAPEnvelope node to add a SOAP envelope for the SOAP message.