Application response measurement

Notes on logged values

The meaning of transaction identifiers are dependent on the ARM collection agent being used. For information on the collector, refer to the documentation on the Open ARM implementation used for MCS at open-arm.sourceforge.net.

The time recorded is the overall time to retrieve a resource, including the time to allocate and open the outbound socket, retrieve the resource and close the socket.

A status code of 0 indicates success. A non-zero code indicates failure.

Installing and configuring the libraries

The following libraries and configuration file are designed to work in the context of the MCS distribution.

• arm40.jar

• openarm_resources.jar

• open-arm.cfg

• open_arm.jar

The commons-pool-1.2.jar is required, and is not supplied with some web application servers.

Copy all the .jar files into the lib directory in your web application path, and copy the open-arm.cfg file to a convenient location. Add the following entries to the mcs-jlog.xml file.

<appender name="ARM-LOG" class="org.apache.log4j.FileAppender">
  <param name="Append" value="false"/>
  <param name="File" value="/tmp/arm.log"/>
  <layout class="org.apache.log4j.PatternLayout">
    <param name="ConversionPattern" value="%d{dd MMM HH:mm:ss} - %m%n"/>
  </layout>
</appender>

<category name="net.m2technologies.open_arm">
  <priority value="info"/>
  <appender-ref ref="ARM-LOG"/>
</category>

Then set the system property Arm40.ArmTransactionFactory of your JVM to the class of your ARM provider, and define the location of the configuration file.

-DArm40.ArmTransactionFactory=com.volantis.synergetics.performance.arm.openarm.OpenArmTransactionFactory
-Dopenarm.config.file=/[config_file_location]/open-arm.cfg 

Related topics

• Administering MCS