Create a test based on the JMeter script#

STANDARD PRO

JMeter is an open source load testing tool capable of recording HTTP requests via a built–in HTTP proxy. The JMX file is a saved JMeter script in XML format. Boomq supports JMX files import.

To create a test based on the JMeter script, follow these steps:

  1. Create the script in JMeter.

  2. Import the script in Boomq.

  3. Run the debug test and edit the script if needed.

  4. Run the test.

To upload projects from Boomq and edit them in Apache JMeter, you can use a special plugin.

When importing JMX scripts into Boomq, some Jmeter elements are supported.

Record a script#

To create a script in JMeter, use the Apache JMeter documentation.

Import a script#

  1. Open Boomq.

  2. Click + in the lower-right corner of your screen and select Import.

    _images/um_import.en.png

  3. Go to the JMX file tab and use one of the following methods:

    • Click to upload a JMX file and select the JMX file. The file size should not exceed 100 MB.

    • Using Drag & Drop, move the file from the local folder to the area for uploading the JMX file:

    _images/um_import_jmx.en.png

  4. Use Click to upload supporting files.

  5. Click Import. The Requests tab opens:

    _images/um_list_of_requests_jmx.en.png

    To view the timer settings for the request, hover over the timer_info_button_jmx icon.

    To view the request settings, click request_info_button_jmx.

    Note

    If the script contains unsupported plugins, then the script is not imported. For more information, see Supported plugins and elements of JMX scripts.

  6. Edit the load profile for each step for the Thread Group jp@gc - Ultimate Thread Group, if needed:
    _images/um_jmx_steps.en.png

    • Start delay (min). Delay before starting testing. Specified in minutes.

    • Duration (min). Test duration at maximum load with all VUsers running. Specified in minutes.

    • Ramp-up time (min). Time allocated to start all VUsers. If set to 0, all VUsers will start simultaneously. Specified in minutes.

    • Number of VUsers. The number of load threads. The intensity of the load depends on the number of virtual users, timers, and response time of the testing system.

    • Ramp-down time (min). Time allocated to stop all VUsers. If set to 0, all VUsers will stop simultaneously. Specified in minutes.

  7. Redefine the timer’s settings if needed:

    1. Click Action ⋮ and select Set timers. The window opens:

      _images/um_jmx_timer_settings.en.png

    2. Click the On/off timers toggle.

    3. Enter the multiplication coefficient. The timer’s values are multiplied by the specified value.

      Note

      Multiplication by a coefficient are supported for Constant Timer, Gaussian Random timer, Poisson Random timer, Uniform Random timer.

    4. Click Apply.

  8. Configure the profile graph display if needed:

    • To merge the graphs of several steps, click the Merge steps toggle. The toggle becomes available when there are several steps in the transaction.

    • Select the testing time that you want to consider in detail on the graph.

Apache JMeter Plugin#

The plugin allows you to upload projects from Boomq to edit them in Apache JMeter

The plugin supports Apache JMeter 5.4.1 and higher.

Install the plugin#

  1. Request a JAR file of the plugin from the Technical support.

  2. Copy the JAR file to the Apache JMeter folder: \lib\ext.

  3. Create a config file and fill in the file before Apache JMeter runs.

Config file#

The boomq.properties config file is located in the Apache JMeter folder: \bin.

The config file contains:

  • boomq_url. URL of the Boomq platform.

  • boomq_token. API token.

  • tmp_dir. The folder where projects downloaded from Boomq.

Example of the config file:

boomq_url=https://mytinyboomqurl.io
boomq_token=<API token>
tmp_dir=/home/jmeter/

You can also edit settings in the plugin window on the Settings tab:

_images/um_jmeter_plugin_settings.png

Use the plugin#

To edit the Boomq project in Apache JMeter, follow these steps:

  1. Run Apache JMeter.

  2. In the upper-right corner of the Apache JMeter window, click jmeter_plugin_button. The list of the Boomq OWN_JMX projects opens. To refresh the list, click Reload if needed.

  3. Expand the required project and select the version:

    _images/um_jmeter_plugin_list.png

  4. Click Download. The JMX file downloaded from Boomq will open:

    _images/um_jmeter_plugin_project.png

    Note

    If the Name and Comments fields are not filled in for the script element, then Boomq generates unique values of these fields. For example:

    _images/um_jmeter_plugin_name_comments.png

  5. Edit and save the JMX file.

  6. Create a new Boomq project and import the JMX file.

Supported elements of JMX scripts#

When importing JMX scripts into Boomq, the following Jmeter elements are supported:

  • Thread Group

    • Thread Group

    • setUp Thread Group

    • TearDown Thread Group

    • Ultimate Thread Group

  • Assertions

    • Duration Assertion

    • JSON Assertion

    • Response Assertion

    • Size Assertion

    • XPath2 Assertion

  • Configuration Elements:

    • HTTP Authorization Manager

    • HTTP Cookie Manager

    • HTTP Request Defaults

    • HTTP Header Manager

    • User Defined Variables

    • CSV Data Set Config

    • Random csv data set config

  • Logic Controllers:

    • ForEach Controller

    • If Controller

    • Loop Controller

    • Transaction Controller

    • While Controller

  • Post-Processors:

    • Boundary Extractor

    • JSON Extractor

    • Regular Expression Extractor

    • XPath2 Extractor

  • Samplers:

    • HTTP Request

    • Flow Control Action

  • Timers:

    • BeanShell Timer

    • Constant Throughput Timer

    • Constant Timer

    • Gaussian Random timer

    • JSR223 Timer

    • Poisson Random timer

    • Precise Throughput Timer

    • Synchronizing Timer

    • Uniform Random timer