...
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="1ccf151d-5f1b-4427-a7f4-c7f9ca1c8c37"><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="4a343cf5-e585-44dd-896e-c2f8c1bf534c"><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="9109838f-138d-4975-86c7-bb5cfc692343"><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. | ||
-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) |
...
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.