Jmeter-Introscope integration fieldpack

Document created by meaje04 on May 30, 2013Last modified by meaje04 on Jun 13, 2014
Version 2Show Document
  • View in full screen mode
More details about usage can be found in the docs folder of the zip file.

**Installing the Wily Listener package**

WilyJMeter provides a Jmeter Listener that can be added to test plans in JMeter for reporting results of round-trip user URL response times into the Introscope application management platform.   The WilyJMeter Jmeter Listener will serve as an Introscope Agent and report Jmeter Metrics to the Introscope Enterprise Manager.  It will record the results of each thread in a Jmeter test plan under separate nodes in the Introscope Workstation Explorer tree with subnodes and corresponding metrics for each sample (i.e., HTML request) executed.   

Following are the metrics recorded for each sample:
•     Execution Response Time (ms)   
•     Reponses Per Second
•     Counts of each response code returned (404's, 200's, etc.).

Jmeter Versions Supported:
•     JMeter 1.9.1 thru 2.5 ( as of this writing )

Assumptions:  JMeter & Introscope are both installed
1.     Unzip in the root directory of Jmeter.   
This will install WilyJMeter.jar, EPAgent.jar, and epawrap.jar into <jmeter_home>/lib/ext and create <jmeter_home>/bin/wily with a few resources. If you do not wish to use the epa functionality to send additional metrics, then you may delete the epawrap.jar
2.     Edit <jmeter_home>/bin/wily/IntroscopeAgent.profile to set the host and port number for the Introscope Enterprise Manager.  The EPA properties file does not need to be changed unless you wish to run additional plugins besides the http listening port.

3.     Once installed, add a "Wily Listener" to a test plan through the Jmeter GUI in the same manner as any other Jmeter listener.   Test results can optionally be written to a datafile for validation purposes.

Note:  The above assumes a Windows platform.   For unix, unzip the file on Windows and copy the jar files to the unix directories which correspond to the above.
To Run:
Assumptions:  Introscope Enterprise Manager and Workstation are running

1.     Run JMeter.  Under windows this is done with <jmeter_home>/bin/jmeter.bat.
2.     Create a test plan (or load the sample) and execute.   A sample test plan can be found at <jmeter_home>/scripts/CA_APM.jmx.

Using the epa http listener for additional metrics:
It is sometimes useful to be able to send additional metrics apart from the response times, such as in the case of an asynchronous transaction.
The epawrap.jar file causes the epa classes to be loaded by the agent.  The EPA properties file is configured to use the http listener to receive metrics.  To send a metric simply make an http request from jmeter to localhost on port 8080 ( can be changed in epa properties ).
For the request path use the following format:  (normal types are StringEvent, IntAverage, IntCounter as with epa.)

Results in Introscope: