Getting started !

Once you have downloaded the player binary from here, or you have recompiled it using the procedure described here, check that it runs on your host by executing the following command:

$ player version
INFO[0000] Current version: 1.5.0-15-g827a0ed

Use the ab mode for a quick test

The ab mode is so called because it tries to mimic the ab command installed with Apache server ! This mode can be used to make a quick test. For example, we are going to request the home page of mysite.com with 10 concurrent users that will be launched at start time, the total duration of the test will be 5 seconds and the resulst will be stored in /tmp directory:

$ player ab --users 10 --request http://mysite.com --duration 5 --output-dir /tmp
INFO[0000] Maximum number of open file descriptors: 65536
INFO[0000] If you press  during the play, you will get partial results !
INFO[0000] Playbook Version is v1
INFO[0000] Play pre-actions
INFO[0000] Launch VUs to play the actions
INFO[0000] All VUs started, waiting at WaitGroup
INFO[0001] Time: 1 TotalReq: 230, VUCount: 10, Avg latency: 40451 μs (40 ms) req/s: 230
INFO[0002] Time: 2 TotalReq: 475, VUCount: 10, Avg latency: 40533 μs (40 ms) req/s: 245
INFO[0003] Time: 3 TotalReq: 719, VUCount: 10, Avg latency: 40639 μs (40 ms) req/s: 244
INFO[0004] Time: 4 TotalReq: 962, VUCount: 10, Avg latency: 40847 μs (40 ms) req/s: 243
INFO[0005] Time: 5 TotalReq: 1214, VUCount: 7, Avg latency: 39833 μs (39 ms) req/s: 252
INFO[0006] Time: 6 TotalReq: 1221, VUCount: 0, Avg latency: 39472 μs (39 ms) req/s: 7
INFO[0007] Done in 7.052995652s
INFO[0007] Building reports, please wait...
INFO[0007] Count of remaining goroutines=3
INFO[0007] Launching Viewer
INFO[0007] Graphs generated

When the player ends, you can browse the results by displaying the /tmp/index.html file in your browser !