/jmeter-amqp-plugin

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

Primary LanguageJavaApache License 2.0Apache-2.0

JMeter AMQP Plugin

build status release downloads contributions welcome

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:

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

amqp-plugin-samplers

AMQP Publisher

amqp-publisher

AMQP Consumer

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:

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

Contributing

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