Skip to content

JMeter import

JMeter is an open-source load testing tool capable of recording HTTP requests through a built-in HTTP Proxy. A JMX file is a saved JMeter project in XML format. OctoPerf supports importing JMeter projects in such format.


JMeter projects often rely on external files (i.e. CSV files used in datasets or plugins). Be sure to upload them using the Files Menu after your import your JMX.


To record a virtual user with JMeter, please follow the JMeter recording guide provided by the Apache Foundation.

Generic actions

Most commonly used test elements are supported natively: a dedicated Virtual User action is created for each one.

All other relevant JMeter test elements can be imported as Generic Actions:

Generic JMeterAction

Generic Actions lets you edit the configuration of the associated JMeter test element (here a BSF Post Processor).

However, there are a few limitations:

  • Generic Actions cannot be added to a Virtual User, you can only duplicate existing ones.
  • Their configuration can only be edited, not extended.

At runtime, the Generic Action is converted back to its associated JMeter test element. So you should ensure that it does not break the execution of the test by validating your virtual user.

If you think a test element deserves to be supported natively in OctoPerf, please send us a mail at


Some actions are not directly included in the generated Virtual Users after importing a JMeter JMX file:

All actions related to test recording (i.e. RecordingController) or test results (i.e. ResultAction or ResultCollector) are ignored as OctoPerf comes with its own results and reports.

Natively supported actions

The following elements are natively supported in OctoPerf:



Config elements:



  • Constant Timer,
  • Uniform Random Timer,
  • Constant Throughput Timer.


  • JSR223 PreProcessor: BeanShell are converted to JSR with BeanShell language.



Create Virtual User: Import JMX

Upload the JMeter JMX file to create a virtual user:

Create Virtual User from JMX

Simply drop the file in the JMX area or use the Choose File button. The download starts automatically.


You may select Download resources automatically if you want OctoPerf to remove the static resources requests (images, JavaScript and Css files, etc.). These requests will then be downloaded dynamically during runtime.

Then import all resources that your script may need to run:

Import Resources

Please refer to the Files documentation for more information.

JMeter plugins


All JMeter plugins (even custom ones) are supported using Generic Actions.

You simply need to upload the associated .JAR files using the files manager.


Plugins are automatically downloaded just before runtime so unless you use a custom one you should not have to upload the associated .jar files manually. In case of On-premise load generators that would not have access to JMeter plugins, you should provide the JAR files in advance.


As we use the JDK11 on our load injectors, to run tests that simulate HTTP2 request you need to

  1. Download Java APLN JAR and upload it into the Files,
  2. Delete the JDK8 APLN client JAR on test startup using a bootstrap script.