Enabling transaction tracking in agent coexistence environment

In an agent coexistence environment, you can configure the data collector to collect and pass the transaction tracking data to the Tivoli® Enterprise Portal, which is a component of IBM® Tivoli Monitoring.

Before you begin

You must install the Microsoft .NET agent, which is delivered as part of Cloud APM and you must remove or unregister the .NET Data Collector component, which is delivered with ITCAM for Microsoft Applications. Use the configdc.exe unregisterdc command to unregister all modules of the data collector.

Procedure

To configure the data collector to collect and pass the transaction tracking data to the Tivoli Enterprise Portal, complete the following steps:

  1. Go to the install_dir\localconfig\qe directory, where install_dir is the installation directory of the Microsoft .NET agent. The default path is C:\IBM\APM.
  2. Open the qe_default.properties file and set the value of the transaction_tracking parameter to ENABLED.
  3. Save and close the qe_default.properties file.
  4. Go to the install_dir\qe\config directory.
  5. Open the dotNetDcConfig.properties.inactive file in a text editor.
  6. Set the TTDC.enabled and TTAS.enabled parameters as follows: 
    TTDC.enabled=true
TTAS.enabled=true
  7. To configure the connection to the Transaction Collector, set the values of the TTAS.Host and TTAS.Port parameters to the IP address and port number of the Transaction Collector.
  8. Run the following command to activate the changes: 
    install_dir\qe\bin\configdc.exe activateconfig
  9. Restart the .NET application for the changes to take effect.

Results

Now, the transaction tracking data can be collected and displayed on the Tivoli Enterprise Portal.

What to do next

To disable the transaction tracking for a .NET Data Collector, repeat the procedure and use the following configuration values:

  • In the qe_default.properties file, set transaction_tracking=DISABLED.
  • In the dotNetDcConfig.properties.inactive file, set TTDC.enabled=false and TTAS.enabled=false.