jMeter - Monitor Test Plan


In this chapter we will discuss about how to create Test plan using JMeter, to monitor webservers. Uses of monitor tests are:

  • Monitors are useful for a stress testing and system management.

  • Used with stress testing, the monitor provides additional information about server performance.

  • Monitors makes it easier to see the relationship between server performance and response time on the client side.

  • As a system administration tool, the monitor provides an easy way to monitor multiple servers from one console.

We would need Tomcat 5 or above version for monitoring. For our test purpose we will monitor Tomcat 7.0.42 server. You can test any servlet container that supports JMX (Java Management Extension). Let us write a test case to monitor the Tomcat server. But before that let us first set up our tomcat server.

Setup Tomcat Server

We'll start with "open" the Tomcat service status. To do this,edit the configuration file for users <TOMCAT_HOME>/conf/tomcat-users.xml. This file contains a tomcat-users section (commented) like this:


  <role rolename="tomcat"/>
  <role rolename="role1"/>
  <user username="tomcat" password="tomcat" roles="tomcat"/>
  <user username="both" password="tomcat" roles="tomcat,role1"/>
  <user username="role1" password="tomcat" roles="role1"/>

We need to change this section to add the admin roles, manager, manager-gui and assign the user "admin". The revised file is as follows:


  <role rolename="manager-gui"/>
  <role rolename="manager-script"/>
  <role rolename="manager-jmx"/>
  <role rolename="manager-status"/>
  <user username="admin" password="admin" roles="manager-gui,manager-script,manager-jmx,manager-status"/>


Now start the tomcat server <TOMCAT_HOME>/bin/ for linux and <TOMCAT_HOME>/bin/startup.bat for windows. Once started, check that the Tomcat supervision works by entering the below link in your browser:


An authentication window appears in the browser, enter the tomcat login and password associated (in our case it is admin). Then, the browser shows the execution status of Tomcat as below:

Tomcat Manager Status

From the above image we can note few things:

  • In the URL, note that XML = true (note the case sensitivity) allows a clean display of the supervisory Tomcat necessary for the JMeter functioning.

  • Also note that there are default two connectors. The AJP connector used in general coupled with the mod_jk Apache HTTPD front module and the HTTP connector which is commonly used connector for direct access to Tomcat via port 8080.

Write JMeter Test Plan

Let us monitor the Tomcat server by writing a test plan as below:

Rename Test Plan

Start the JMeter window by clicking on /home/manisha/apache-jmeter-2.9/bin/ Click on the Test Plan node. Add a thread group as explained in the next step.

Add Thread Group

Add one Thread Group. Right click on Test Plan > Add > Threads(Users) > Thread Group. Thread Group will get added under the Test Plan node. Change the loop count to forever (or some large number) so that enough samples are generated.

Monitor Test Users

HTTP Authorization Manager

Add the HTTP Authorization Manager to the Thread Group element Add > Config element > HTTP Authorization Manager. This element manages authentication requested by the browser to see the Tomcat server status. Select the HTTP Authorization Manager and edit the following details:

  • Username : admin (depending on the configuration in tomcat-users.xml file)

  • Password : admin (depending on the configuration in the tomcat-users.xml file)

  • The other fields are left empty.

http authorization manager

Add Sampler-HTTP Request

Now that we have defined our users, it is time to define the tasks that they will be performing. We will add HTTP Request element. Click your right mouse button to get the Add menu, and then select Add > Sampler > HTTP Request. Then, select the HTTP Request element in the tree and edit the following properties as in the image below:

The following details are entered in the this element:

  • Name : Server Status

  • Server Name or IP : localhost

  • Port : 8080

  • Path : /manager/status

  • Parameters : Add a request parameter named "XML" in uppercase. Give it a value of "true" in lowercase.

  • Optional Tasks : Check "Use as Monitor" at the bottom of the sampler.

Monitor Test Sampler

Add Constant Timer

To request the status of the server periodically, add an element Constant Timer which will allow a time interval between each request. Add a timer to this thread group Add > Timer > Constant Timer.

Enter 5000 milliseconds in the Thread Delay box. In general, using intervals shorter than 5 seconds will add stress to your server. Find out what is an acceptable interval before you deploy the monitor in your production environment.

Monitor Constant Timer

Add Listener

The final element you need to add to your Test Plan is a Listener. We will two types of listeners. One that stores results in a file and second that shows the graphical view of the results.

Select the thread group element and add a Simple Data Writer listener Add > Listener > Simple Data Writer. Next, specify a directory and filename of the output file (in our case it is /home/manisha/work/sample.csv)

Monitor Simple Data Writer

Let us add another listener, by selecting the test plan element Add > Listener > Monitor Results.

Monitor Results

Run the Test Plan

Now save the above test plan as monitor_test.jmx. Execute this test plan using Run > Start option.

View Output

Results will be saved in /home/manisha/work/sample.csv file. You can also see a graphical result in the Monitor result listener as in the image below.

Monitor Test Result Monitor Test Result

Note the graph has captions on both sides of the graph. On the left is percent and the right is dead/healthy. If the memory line spikes up and down rapidly, it could indicate memory thrashing. In those situations, it is a good idea to profile the application with Borland OptimizeIt or JProbe. What you want to see is a regular pattern for load, memory and threads. Any erratic behavior usually indicates poor performance or a bug of some sort.