+

Search Tips   |   Advanced Search


Insert ARM instrumentation into application code

You can also directly modify your application code to call the Application Response Measurement (ARM) API. This can be done for any type of application (not just Java™).

The ARM API is an open standard. Standards documentation and examples are available at www.opengroup.org/management/arm.htm. The Tivoli ARM Java implementation is provided in the plug-in com.ibm.tivoli.transperf.lib. The ARM 4 Java APIs and public ARM standard interfaces are located under the armjni4.jar file in that plug-in. If you require libraries for other programming languages such as C, contact IBM representative.

To use the Tivoli ARM Java implementation:

  1. Add the com.ibm.tivoli.transperf.lib plug-in and the armjni4.jar file to application project dependencies and class path.

  2. Set the following properties...

      Arm40.ArmTransactionFactory = com.ibm.tivoli.transperf.arm4.transaction.Arm40TransactionFactory; Arm40.ArmTranReportFactory = com.ibm.tivoli.transperf.arm4.tranreport.Arm40TranReportFactory; Arm40.ArmMetricFactory = com.ibm.tivoli.transperf.arm4.metric.Arm40MetricFactory;


Results

Information about instrumenting application with the Tivoli ARM implementation is available in the following guide, which is provided in English only.

To view it, have the free Adobe Reader. The guide contains instructions for instrumenting for IBM Tivoli Monitoring for Transaction Performance, but the instructions also apply to instrumenting for the performance and problem analysis tools (the two technologies use the same ARM engine).

Tivoli Monitoring for Transaction Performance: Application Response Measurement (ARM) Instrumentation Guide

After the application is ARM instrumented, you can create an ARM Instrumented Application profiling configuration for the application, attach and monitor the agent, start the application, and begin collecting data.

To create the profiling configuration: click Run > Profile, and select ARM Instrumented Application. Click the Monitor tab, and then on the Overview page select ARM Performance Analysis.

The analysis user interface is quite Java-specific. If you are profiling a C++ application, for example, there will be elements presented that are meaningless in scenario (such as packages).


Related

  • Problem analysis overview


    Related tasks

  • Find the causes of performance problems
  • Customize real-time profiling settings
  • Collect response time breakdown data
  • Overview of the Profiling Tool