Create and execute JMeter tests

To extend the scope of your performance testing, NeoLoad Web lets you execute JMeter tests directly from the NeoLoad Web interface. That way, you can take advantage of NeoLoad's real-time reporting and analysis capabilities in your JMeter tests.

JMeter is an open-source software used to run performance and functional tests in a variety of applications. It supports a range of different protocols and is highly extensible through its plugins.

Before you start

When it comes totesting with JMeter and NeoLoad Web, keep these things in mind:

• You can only execute JMeter tests from NeoLoad Web.

• NeoLoad Web supports JMeter 5.6.3. Lower version projects may run, but we can't guarantee compatibility.

• JMeter supports Static and Dynamic Zones, but not Cloud Zones.

• JMeter doesn't support multi-node runs.

Create and configure a JMeter test

To prepare a JMeter test, follow these steps:

1. Go to Tests > Create and select JMeter as the Load injection provider.

2. Go to Tests and select the test you have just created.

3. Switch to the Configuration tab and perform these actions: 

   • Upload your JMeter project as a JMX or ZIP file. Note that ZIP files must only contain JMX files and their respective resources.

   • Select an appropriate Zone for your test: Static or Dynamic.

4. Prepare your resources. What you need to do here depends on the Zone you've selected: 

   • I've selected 'Static'.

     If you chose a Static zone, you have two options:

     • Option 1: Use a docker image (recommended). To do this, enter this line in the command prompt:

       docker run --name jmeter-controller -d --rm -e MODE=Managed -e NEOLOADWEB_URL=[NLWEB_URL] -e NEOLOADWEB_TOKEN=[NLWEB_TOKEN] neotys/neoload-controller:jmeter-latest

       Replace [NLWEB_URL] and [NLWEB_TOKEN] with your own NeoLoad Web URL and token respectively.

     • Option 2: Manually configure an existing Controller agent for JMeter.

   • I've selected 'Dynamic'.

     If you choose a Dynamic Zone during the previous preparation step, a dialog expands to enter additional Zone specifications.

     Here you must specify the docker images for the Controller and load generator:

     • Controller - Docker Image: registry.hub.docker.com/neotys/neoload-controller:jmeter-latest

     • Load Generator - Docker Image: registry.hub.docker.com/neotys/neoload-loadgenerator:latest

Now, you're ready to run your tests.

Run your tests

In essence, you trigger a test run of JMeter tests the same way you trigger any other NeoLoad tests.

However, there are some differences to keep in mind:

• NeoLoad Web doesn't offer any information on load generators during a test run because JMeter is used as a load injection provider.

• NeoLoad Web doesn't display page values and SLAs.

What's next

Now that you've created and run a JMeter test, explore different ways to interpret your test results.