Create a test based on the JMeter script#
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:
Run the debug test and edit the script if needed.
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#
Click + in the lower-right corner of your screen and select Import.
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:
Use Click to upload supporting files.
Click Import. The Requests tab opens:
To view the timer settings for the request, hover over the icon.
To view the request settings, click .
If the script contains unsupported plugins, then the script is not imported. For more information, see Supported plugins and elements of JMX scripts.
Edit the load profile for each step for the Thread Group jp@gc - Ultimate Thread Group, if needed:
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.
Redefine the timer’s settings if needed:
Click Action ⋮ and select Set timers. The window opens:
Click the On/off timers toggle.
Enter the multiplication coefficient. The timer’s values are multiplied by the specified value.
Multiplication by a coefficient are supported for Constant Timer, Gaussian Random timer, Poisson Random timer, Uniform Random timer.
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#
Request a JAR file of the plugin from the Technical support.
Copy the JAR file to the Apache JMeter folder:
Create a config file and fill in the file before Apache JMeter runs.
The boomq.properties config file is located in the Apache JMeter folder:
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:
Use the plugin#
To edit the Boomq project in Apache JMeter, follow these steps:
Run Apache JMeter.
In the upper-right corner of the Apache JMeter window, click . The list of the Boomq OWN_JMX projects opens. To refresh the list, click Reload if needed.
Expand the required project and select the version:
Click Download. The JMX file downloaded from Boomq will open:
If the Name and Comments fields are not filled in for the script element, then Boomq generates unique values of these fields. For example:
Edit and save the JMX file.
Supported elements of JMX scripts#
When importing JMX scripts into Boomq, the following Jmeter elements are supported:
setUp Thread Group
TearDown Thread Group
Ultimate Thread Group
HTTP Authorization Manager
HTTP Cookie Manager
HTTP Request Defaults
HTTP Header Manager
User Defined Variables
CSV Data Set Config
Random csv data set config
Regular Expression Extractor
Flow Control Action
Constant Throughput Timer
Gaussian Random timer
Poisson Random timer
Precise Throughput Timer
Uniform Random timer