...
Parameter | Meaning |
---|---|
-c pattern | The number of tests to run concurrently. |
-r num | The number of times to repeat each test. |
-d duration | The length of time to run the tests for. |
-t name | The name of the test case to execute. |
-s pattern | The size parameter to run tests with. |
-o dir | The name of the directory to output test timings to. |
--csv | Output test results in CSV format. |
--xml | Output test results in XML format. |
-v | Verbose mode. |
Here are some examples:
<ac:structured-macro ac:name="unmigrated-wiki-markup" ac:schema -version="1" ac:macro-id="226b818c-b15d-4d92-bb3a-b4258bd709f0"><ac:plain-text-body><![CDATA[ -c [10:20:30:40:50] | Runs the test with 10,20,...,50 threads. | ]]></ac:plain-text-body></ac:structured-macro> | <ac:structured-macro ac:name="unmigrated-wiki-markup" ac:schema-version="1" ac:macro-id="a8b029cf-7c1e-43ad-aa5b-b0c4cb5e6680"><ac:plain-text-body><![CDATA[ |
-s [1:100]:samples=10 | Runs the test with ten different size parameters evenly spaced between 1 and 100. | ]]></ac:plain-text-body></ac:structured-macro> | <ac:structured-macro ac:name="unmigrated-wiki-markup" ac:schema-version="1" ac:macro-id="adaa58fb-18db-4426-8147-019bedd875c7"><ac:plain-text-body><![CDATA[ |
-s [1:1000000]:samples=10:exp | Runs the test with ten different size parameters exponentially spaced between 1 and 1000000. | ||
]]></ac:plain-text -body></ac:structured-macro> -r 10 | Runs each test ten times. | ||
-d 10H | Runs the test repeatedly for 10 hours. | ||
-d 1M, -r 10 | Runs the test repeatedly for 1 minute but only takes a timing sample every 10 test runs. | ||
<ac:structured -macro ac:name="unmigrated-wiki-markup" ac:schema-version="1" ac:macro-id="6c40df76-15c3-450a-ba82-18682cba3c1f"><ac:plain-text-body><![CDATA[ -r 10, -c [1:5:10:50], -s [100:1000:10000] | Runs 12 test cycles (4 concurrency samples * 3 size sample), with 10 repeats each. In total the test will be run 199 times (3 + 15 + 30 + 150) ]]></ac:plain-text-body></ac:structured-macro> |
The test runner also accepts name=value properties on the end of the command line, and these are passed to the test code as parameters to control the operation of the test. The following properties may be set:
Parameter | Default | Comments | ||||
---|---|---|---|---|---|---|
messageSize | 0 | Message size in bytes. Not including any headers. | ||||
destinationName | ping | The root name to use to generate destination names to ping. | ||||
persistent | false | Determines whether peristent delivery is used. | ||||
transacted | false | Determines whether messages are sent/received in transactions. | ||||
broker | tcp://localhost:5672 | Determines the broker to connect to. | ||||
virtualHost | test | Determines the virtual host to send all ping over. | ||||
rate | 0 | The maximum rate (in hertz) to send messages at. 0 means no limit. | ||||
verbose | false | The verbose flag for debugging. Prints to console on every message. | ||||
pubsub | false | Whether to ping topics or queues. Uses p2p by default. | ||||
failAfterCommit | false | Whether to prompt user to kill broker after a commit batch. | ||||
failBeforeCommit | false | Whether to prompt user to kill broker before a commit batch. | ||||
failAfterSend | false | Whether to prompt user to kill broker after a send. | ||||
failBeforeSend | false | Whether to prompt user to kill broker before a send. | ||||
failOnce | true | Whether to prompt for failover only once. | ||||
username | guest | The username to access the broker with. | ||||
password | guest | The password to access the broker with. | ||||
selector | null | Not used. Defines a message selector to filter pings with. | ||||
destinationCount | 1 | The number of destinations to send pings to. | ||||
numConsumers | 1 | The number of consumers on each destination. | ||||
timeout | 30000 | In milliseconds. The timeout to stop waiting for replies. | ||||
commitBatchSize | 1 | The number of messages per transaction in transactional mode. | ||||
uniqueDests | true | Whether each receivers only listens to one ping destination or all. | ||||
durableDests | false | Whether or not durable destinations are used. | ||||
ackMode | AUTO_ACK |
| ||||
consTransacted | false |
| ||||
consAckMode | AUTO_ACK |
| ||||
maxPending | 0 |
|
Added for 0.7
Parameter | Default | Comments |
---|---|---|
numConsumers | <int> | Augmented Allow a value of 0, meaning no consumers. |
consumeOnly | boolean | Disable all message sending. Message counts are used by consumers as validation. |
preFill | int | Message count to preFill the destination with before the test start. |
delayBeforeConsume | int | Delay in ms to wait after the preFill has occured before the test starts. |
Test case output
Test cases output data in csv format. The extratThroughputResults.sh script can be used to interpret the data and output the average throughput rate.