JMeter tests
This topic describes how to use JMeter scripts in performance tests.
JMeter tests overview
JMeter is an open-source load testing tool for analyzing and measuring the performance of a variety of services, with a focus on web applications.
By including JMeter (.jmx) scripts in your tests, you can run one or more JMeter tests side-by-side with any other tests, giving you a single entry point for running your performance tests.
Measurements can be viewed in online and offline graphs and Analysis, using the data points from the JMeter tests.
JMeter scripts can be run on a load generator on a Windows or Linux operating system. The Docker installations of Windows and Linux also support JMeter scripts.
Transactions in JMeter scripts
JMeter tests work with threads, JMeter's equivalent of Vusers, and thread groups. JMeter tests are handled as follows:
-
If your JMeter script contains multiple thread groups, only the first group is run. If you want all groups to be run, you need to perform the following:
-
Re-upload the script (the script is automatically split into multiple scripts).
-
Update all of your JMeter tests with the new scripts.
-
-
Only transaction names under the TransactionController section in the .jmx file are shown in the results.
-
Transaction names must not include a dot.
Prerequisites
Note the following guidelines before creating a performance test with a JMeter script.
Area | Details |
---|---|
Installation requirements |
|
Load generator setup |
|
Performance Engineering Agent settings |
|
Data files |
The JMeter script can reference parameter files in .csv format. To reference .csv files, make sure that:
The Controller finds these files, and sends them to the load generator for the test run. Tip: To show the contents of JMeter script .csv files in the Script Details tab, you need to edit the configuration file. Edit the appsettings.defaults.json file to include the .csv extension both locally and in the LRE_CONFIGURATION_SERVICE folder so that the customization will be retained after an upgrade: Copy code
|
Creating JMeter scripts |
|
Set up and run a JMeter test
This task describes how to upload JMeter scripts to a test and configure runtime settings.
-
Make sure that you follow the prerequisites for using JMeter scripts.
For details, see Prerequisites.
-
Upload JMeter scripts to OpenText Enterprise Performance Engineering.
For details, see Upload a script.
Note: When uploading a JMeter script, you can split a .jmx file that contains a number of JMeter groups into a separate .jmx file for each group.
After uploading the script, it is added to the test management tree. You can view and edit most scripts directly from within the user interface. For details, see Edit a script.
-
Create a performance test, and assign the JMeter script to it.
For details, see Tests.
-
Configure JMeter runtime settings.
If you need to specify a custom JDK path, or parameters, for example, if you want to change the behavior of the JVM, you need to configure the runtime settings.
-
After you have uploaded a JMeter script and added it to a test, select the test in the test management tree and click Edit Test.
-
In the Groups and Workload view, select a Vuser group and click the Edit Runtime Settings button
. The JMeter Runtime Settings dialog box opens.
-
In the JMeter Runtime Settings dialog box, select:
-
Use default JRE path to use the default JRE installation to run JMeter tests. The path, registry, and Windows directory are searched to locate the JRE to be used.
-
Custom JRE path to use a custom JRE installation. Enter the path to the JRE folder and any additional parameters to be passed to Java when the test starts in the Additional parameters box.
-
-
-
Run the test.
For details, see Manage a performance test run.
Data points from JMeter tests are displayed in the graphs. For details, see View JMeter test results.
View JMeter test results
You can monitor JMeter test results using the following standard graphs:
-
Running Vusers
-
Transaction Response Time
-
Total Transaction per second (Passed)
-
Transactions per second (Passed)
-
HTTP Responses per second
-
Hits per Second
-
Throughput - Whole Load Test
For graph details, see Web resource monitor graphs, Runtime monitor graphs, and Transaction monitor graphs.
Notes and limitations
The following are notes and limitations when working with JMeter scripts:
-
JMeter scripts that use Web HTTP requests only are supported.
-
OpenText Network Virtualization is not supported for JMeter tests.
See also: