DianPermana/jmeter-amqp-plugin

A JMeter plugin to publish & consume messages from RabbitMQ or any AMQP message broker

JMeter AMQP Plugin

A JMeter plugin to publish & consume messages from RabbitMQ or any AMQP message broker.

Requirements

• Requires JDK 8 or higher.
• Works with Apache JMeter 5.6.x.
• Compatible with versions up to 5.x.x of com.rabbitmq:amqp-client.

Installation

1. Download the latest release or build your own from the source code.
2. Put jmeter-amqp-plugin-VERSION.jar into $JMETER_HOME/lib/ext directory.
   It contains the necessary AMQP client dependency, no other jars are required.
3. Restart JMeter.

Usage

This plugin includes 2 samplers:

• AMQP Publisher
• AMQP Consumer

Both samplers can be found in the Add -> Sampler list shown as below:

AMQP Publisher

AMQP Consumer

A pre-configured example scenario can be found in the examples directory.

Build

Build requirements

In order to build JMeter AMQP plugin from source, you will need:

• Java 8 or higher
• Apache Maven 3

Build dependencies are managed by Maven.
Jars should automatically be downloaded by Maven as part of the build process.

In addition, you'll need to copy or symlink the following from $JMETER_HOME/lib/ext directory:

• ApacheJMeter_core.jar

Build from source

To build, just execute:

mvn clean package

This will create 2 jars in /target directory - the jar with all the dependencies within (this is the one you need) and the original jar (without amqp-client library inside):

target/jmeter-amqp-plugin-VERSION.jar
target/original-jmeter-amqp-plugin-VERSION.jar

Install

To install, execute:

cp target/jmeter-amqp-plugin-VERSION.jar $JMETER_HOME/lib/ext

Restart JMeter.

Acknowledgements

Thanks to

• jlavallee (Jeff Lavallee), who created original plugin;
• polarnik (Viacheslav Smirnov), who spent time and efforts to create comparison of the forks with valuable changes;
• for the features & enhancements implemented in their forks:
  • gregLibert (Gregory Libert),
  • gybandi (Gyuro Andras),
  • looseend (John Singleton),
  • sergiogouveia (Sergio Gouveia),
  • wojtek-oledzki (Wojtek Oledzki),
  • zeph1rus;
• all the contributors to original project.

Contributing

Contributions are welcome.
Please take a look at the contributing guideline first.