Java Client Tools

The Java client distribution ships with some utility programs written using the Java client. This page documents how to use them.

These utility programs are contained within rabbitmq-client-tests.jar. This jar file also contains several small example programs for exercising the functionality of the RabbitMQ server. The source code for these examples is in the test/src folder in the source distribution. These are intended to be fairly self-explanatory and are not documented here.

PerfTest

PerfTest (formerly known as MulticastMain) is a performance testing tool. It starts up zero or more producers and consumers and reports the rate at which messages are sent and received, along with the latency (i.e. time taken for messages to pass through the broker).

PerfTest supports many command line flags. Invoke it with –help to see them:

HTML Performance Tools

The HTML Performance Tools are a set of tools that can help you run automated benchmarks by wrapping around the PerfTest benchmarking framework. You can provide benchmark specs, and the tool will take care of running the benchmark, collecting results and displaying them in an HTML page. Learn more here

Tracer

There’s a very basic, very simple AMQP protocol analyzer in class com.rabbitmq.tools.Tracer. Invoke it with