JMeter GUI: Test Plan & Workbench

As soon as you launch JMeter, you will see 2 elements

  1. Test Plan
  2. Workbench

JMeter GUI

What is a Test Plan?

Test Plan is where you add elements required for your JMeter Test.

It stores all the elements (like ThreadGroup, Timers etc) and their corresponding settings required to run your desired Tests.

The following figure shows an example of Test Plan

Test Plan

What is WorkBench?

The WorkBench simply provides a place to store test elements temporarily. WorkBench has no relation with Test Plan. JMeter will not save the contents of the WorkBench. It only saves the contents of the Test Plan branch


“WorkBench” will be used in our tutorial HTTP Proxy Server Recording Test

For now, ignore it.

How to add Elements?

Adding Elements is the essential step to build a Test Plan because without adding elements, JMeter cannot execute your Test Plan

A Test Plan includes many Elements such as Listener, Controller, and Timer

You can add an element to test plan by right-clicking on a Test Plan and choose new elements from “Add” list.

Suppose, you want to add 2 elements to Test Plan BeanShell Assertion and Java Request Default

  • Right click Test Plan -> Add -> Assertion-> Bean Shell Assertion
  • Right click Test Plan -> Add -> Config Element -> Java Request Default

Add Elements

You can also remove an unused element

Let’s say, you want to remove element “HTTP Request Defaults“, select “HTTP Request Default” -> Right click-> choose Remove from the context menu -> Click Yes to confirm delete this element on message box

Loading and Saving Elements

How to Create JMX file

Suppose you have already added an element name “BeanShell Assertion“. Now you want to save it.

Right-click BeanShell Assertion -> select Save Selection As

Create JMX File

A dialog box display, click Save button to save your elements under default name BeanShell Assertion.jmx. You can choose other names if you want

Create JMX File

JMeter Test Elements and Test plan are stored in *.JMX format. JMX is standing for Java Management Extensions.

How to Run JMX file

Loading exist element helps you save your time required to create & configure new elements

Let’s say, that you have an existing element in Test Plan: Java Request Default

Right-click Java Request Defaults-> select Merge

Run JMX File

Choose the Elements (BeanShell Assertion.jmx.) file in the directory. This element will be added to your current test plan.

Run JMX File

How to Configure Elements

In order to configure any Element

  1. Select the element in the Tree on Left Pane
  2. Enter configuration settings on the Right Pane

Configure Elements

How to Save a Test Plan

Before running a test, you should save your Test Plan first. Saving your Test Plan helps you avoid unexpected error when running the test plan. Steps to saving Test plan –

  1. File -> Save Test Plan as-> a Dialog box display
  2. Enter a filename of Test Plan ->click Save

Save a Test Plan

Note: Saving a Test Plan is different from saving elements.

Saving a Test Plan Saving an Element
Test Plan consists of one or many elements Element is a basic component of JMeter
When you save your Test Plan, all those elements in the plan are saved When you save your elements, only one element is saved.

Create a Combo Test Plan

You can merge one or many Test Plans to create a combo Test Plan as shown in below figure

Create a Combo Test Plan

Suppose you already have an existing Test Plan name Test_Fragment.jmx on your computer (This article includes this file). You can merge this test plan to current Test Plan on JMeter to create a new Test Plan.

Create a Combo Test Plan

Now all the test elements in file Test_Fragment.jmx are added to your current test plan as shown in the figure below

Create a Combo Test Plan

How to Run Test Plan

To run your single or multiple test plans, choose Start (Control + R) from the Run menu item.

Run Test Plan

When JMeter is running, it shows a small green box at the right-hand end of the menu bar.

Run Test Plan

The numbers to the left of the green box are the number of active threads / total number of threads.

To Stop the Test, press Stop button or use short key Ctrl + ‘.’

Run Test Plan

Test Report

When test execution is done, you can get the test report. The test report includes the error log file, which is saved in jmeter.log, and the test results summary. Here is a sample log file of JMeter

  • 2013/08/18 08:41:12 INFO  – jmeter.JMeter: Copyright (c) 1998-2013 The Apache Software Foundation
  • 2013/08/18 08:41:12 INFO  – jmeter.JMeter: Version 2.9 r1437961
  • 2013/08/18 08:41:12 INFO  – jmeter.JMeter: java.version=1.7.0_25
  • 2013/08/18 08:41:12 INFO  – jmeter.JMeter: HotSpot(TM) Client VM
  • 2013/08/18 08:41:12 INFO  – jmeter.JMeter: 7
  • 2013/08/18 08:41:12 INFO  – jmeter.JMeter: os.arch=x86
  • 2013/08/18 08:41:12 INFO  – jmeter.JMeter: os.version=6.1
  • 2013/08/18 08:41:12 INFO  – jmeter.JMeter: file.encoding=Cp1252
  • 2013/08/18 08:41:12 INFO  – jmeter.JMeter: Default Locale=English (United States)
  • 2013/08/18 08:41:12 INFO  – jmeter.JMeter: JMeter  Locale=English (United States)
  • 2013/08/18 08:41:12 INFO  – jmeter.JMeter: JMeterHome=C:\Nguyen\Source_code\apache-jmeter-2.9
  • 2013/08/18 08:41:12 INFO  – jmeter.JMeter: user.dir  =c:\Nguyen\Source_code\apache-jmeter-2.9\bin
  • 2013/08/18 08:41:12 INFO  – jmeter.JMeter: PWD       =C:\Nguyen\Source_code\apache-jmeter-2.9\bin