Java Shell
Clone or download
pmouawad <resultsFileFormat> is ignored in version 2.6.0
Add  integration test to check it works
This comments #266
Latest commit 5ee0d24 May 6, 2018

README.md

JMeter Maven Plugin

License Build Status codecov

GitHub release Maven Central Javadocs JitPack

Join the chat at https://gitter.im/jmeter-maven-plugin/jmeter-maven-plugin Stack Overflow Twitter

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.

Last version is 2.7.0 and is compatible with Apache JMeter 4.0

This plugin requires JDK 1.8 or higher since 2.2.0.

Basic Usage

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>2.7.0</version>
    <executions>
	   <!-- 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 <Project Dir>/src/test/jmeter. By default this plugin will pick up all the .jmx files in that directory, to specify which tests should be run please see the project documentation.

You can also put data files in this folder and reference them in your plan.

Run the tests

mvn verify

All your tests will run in maven!

Documentation

All the documentation you need to configure the plugin 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.

Community

Users Group

A place to discuss usage of the maven-jmeter-plugin, let people know how you use it here.

Homepage: http://groups.google.com/group/maven-jmeter-plugin-users

Group Email: maven-jmeter-plugin-users@googlegroups.com

Devs Group

A place to discuss the development of the maven-jmeter-plugin, or ask about features you would like to see added.

Homepage: http://groups.google.com/group/maven-jmeter-plugin-devs

Group Email: maven-jmeter-plugin-devs@googlegroups.com

Website

The official website is available at http://jmeter.lazerycode.com

We love it when people Contribute!