JMeter Maven Plugin
A Maven plugin that provides the ability to run JMeter tests as part of your build
See the CHANGELOG for change information.
All the documentation you need to configure the plugin is available on the Github Wiki.
The latest version is 3.1.0, it requires Maven >= 3.5.2 and defaults to Apache JMeter 5.2.1.
Running the GUI
Once you have added the plugin to your project you will be able to invoke the JMeter GUI using the following command:
mvn jmeter:configure jmeter:gui
If you haven't added the plugin to your project you can still invoke it (provided you have a valid pom.xml in your project) by using the following:
mvn com.lazerycode.jmeter:jmeter-maven-plugin:configure com.lazerycode.jmeter:jmeter-maven-plugin:gui
Add the plugin to your project
Add the plugin to the build section of your pom's project :
<plugin> <groupId>com.lazerycode.jmeter</groupId> <artifactId>jmeter-maven-plugin</artifactId> <version>3.1.0</version> <executions> <!-- Generate JMeter configuration --> <execution> <id>configuration</id> <goals> <goal>configure</goal> </goals> </execution> <!-- Run JMeter tests --> <execution> <id>jmeter-tests</id> <goals> <goal>jmeter</goal> </goals> </execution> <!-- Fail build on errors in test --> <execution> <id>jmeter-check-results</id> <goals> <goal>results</goal> </goals> </execution> </executions> </plugin>
Reference JMX files and CSV data
Once you have created your JMeter tests, you'll need to copy them to
By default this plugin will pick up all the .jmx files in that directory, you can also put data files in this folder and reference them in your plan. To specify which tests should be run, see the Selecting-Tests-To-Run section of the Wiki.
Run the tests
mvn clean verify
All your tests will run in maven!
All the plugin configuration documentation is available on the Github Wiki.
Beginners should start with the Basic Configuration section.
For advanced POM configuration settings have a look at the Advanced Configuration section.
If you'd like to help support the maintainers you can donate using the sponsorship button at the top of the page, or you can purchase this book:
Want to help
Have a look at our list of outstanding issues:
A place to discuss usage of the maven-jmeter-plugin, let people know how you use it here.
Group Email: email@example.com
A place to discuss the development of the maven-jmeter-plugin, or ask about features you would like to see added.
Group Email: firstname.lastname@example.org
The official website is available at https://jmeter.lazerycode.com
We love it when people Contribute!