Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/asitha/andes-test-client
WSO2 Message Broker performance testing client.
https://github.com/asitha/andes-test-client
Last synced: 6 days ago
JSON representation
WSO2 Message Broker performance testing client.
- Host: GitHub
- URL: https://github.com/asitha/andes-test-client
- Owner: Asitha
- Created: 2015-04-16T18:18:38.000Z (over 9 years ago)
- Default Branch: master
- Last Pushed: 2022-09-15T03:29:42.000Z (about 2 years ago)
- Last Synced: 2023-03-23T02:46:11.843Z (over 1 year ago)
- Language: JavaScript
- Homepage:
- Size: 213 KB
- Stars: 0
- Watchers: 2
- Forks: 6
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
WSO2 Message Broker Test Client
==============
Overview
-----------
Performance testing client for WSO2 Message Broker.
Goal of this project is to write a comprehensive test client for
[WSO2 Message Broker (MB)](http://wso2.com/products/message-broker/).
This is a java based console application with the capability to run test scenarios according to a configuration file
given at startup.
Currently this client supports testing AMQP protocol based functionality of MB. Client is written using
[JMS](https://docs.oracle.com/javaee/6/tutorial/doc/bncdr.html)
#### Supported functionality
> - Message Publishers (Topic and queue)
> - multiple publishers (same and different queues)
> - [Disruptor](https://lmax-exchange.github.io/disruptor/) based transactional message publishing
> - publisher failover configuration
>
> - Message Subscribers (Topic and queue)
> - multiple subscribers ( same and different queues)
> - subscriber failover configuration
> - durable topic subscribers
>
> - Test results analytics
> - supports test results analytics with [metrics](https://dropwizard.github.io/metrics/) library
> - graphical view of results
> - message publishing rate (individual publisher and total publisher rates)
> - subscriber receiving rate (individual subscriber and total subscriber rates)
> - message latency (publishing to receiving message latency)
>
> - SL4j logging support
>
Build
------
To get started clone this project and build using maven (or else get the binaries from the
[releases](https://github.com/Asitha/andes-test-client/releases).)
```
mvn clean install
```
Run
----
Extract andes-test-client-\-pack.zip in `target/` directory. Inside the extracted file execute the
**andes-test-client_\** executable to run the client. This will use the default configuration file
(\/conf/client.yaml) to run the test.
```
$ ./andes-test-client_1.0-SNAPSHOT
```
If you want to run a different test configuration point to that file using option `--conf` or `-c`
```
$ ./andes-test-client_1.0-SNAPSHOT --conf
$ ./andes-test-client_1.0-SNAPSHOT -c
```
Configure Test Cases
-------------------------
Use `conf/client.yaml` to configure test cases
For more information on how to configure test cases see following wiki pages
- [Get started with writing your own test configuration](https://github.com/Asitha/andes-test-client/wiki/Get-started-with-writing-your-own-test)
- [Configuration attributes in detail](https://github.com/Asitha/andes-test-client/wiki/Configuration-attributes-in-detail)
Results
---------
After running a test go to `logs/metrics/` directory to view the metrics csv output.
To generate graphs of the results use `result-viewer.html`