Boom! is a simple command line tool to send some load to a web app.
Boom! is a script you can use to quickly smoke-test your web app deployment. If you need a more complex tool, I'd suggest looking at Funkload.
Boom! was specifically written to replace my Apache Bench usage, to provide a few missing features and fix a few annoyances I had with AB.
I have no special ambitions for this tool, and since I have not found any tool like this in the Python-land, I wrote this one.
There are a lot of other tools out there, like Siege which seems very popular.
However, Boom! is a good choice because it works on any platform and is able to simulate thousands of users by using greenlets.
Boom! requires Gevent and Requests. If you are under Windows I strongly recommend installing Gevent with the xxx-win32-py2.7.exe installer you will find at: https://github.com/surfly/gevent/downloads
Boom! should work with the latest 1.x version or the latest 0.x version.
If you are under Linux, installing the source version is usually a better idea. You will need libevent for Gevent 0.x and libev for Gevent 1.x.
Example under Ubuntu:
$ sudo apt-get install libevent libevent-dev python-devThen:
$ pip install boomBasic usage example: 100 queries with a maximum concurrency of 10 users:
$ boom http://localhost:80 -c 10 -n 100
Server Software: nginx/1.2.2
Running 100 queries - concurrency: 10.
Starting the load [===================================] Done
-------- Results --------
Successful calls 100
Total time 0.3260 s
Average 0.0192 s
Fastest 0.0094 s
Slowest 0.0285 s
Amplitude 0.0191 s
RPS 306
BSI Pretty good
-------- Legend --------
RPS: Request Per Second
BSI: Boom Speed IndexBoom! has more options:
$ boom --help
usage: boom [-h] [--version] [-m {GET,POST,DELETE,PUT,HEAD,OPTIONS}]
[--content-type CONTENT_TYPE] [-D DATA] [-c CONCURRENCY] [-a AUTH]
[--header HEADER] [--hook HOOK] [--json-output]
[-n REQUESTS | -d DURATION]
[url]
Simple HTTP Load runner.
positional arguments:
url URL to hit
optional arguments:
-h, --help show this help message and exit
--version Displays version and exits.
-m {GET,POST,DELETE,PUT,HEAD,OPTIONS}, --method {GET,POST,DELETE,PUT,HEAD,OPTIONS}
HTTP Method
--content-type CONTENT_TYPE
Content-Type
-D DATA, --data DATA Data. Prefixed by "py:" to point a python callable.
-c CONCURRENCY, --concurrency CONCURRENCY
Concurrency
-a AUTH, --auth AUTH Basic authentication user:password
--header HEADER Custom header. name:value
--hook HOOK Python callable that'll be used on every requests call
-n REQUESTS, --requests REQUESTS
Number of requests
-d DURATION, --duration DURATION
Duration in seconds
--json-output Prints the results as a JSON object instead. Also
silences the progress logging.Boom uses greenlets through Gevent to create virtual users, and uses Requests to do the queries.
Using greenlets allows Boom to spawn large amounts of virtual users with very little resources. It's not a problem to spawn 1000 users and hammer a web application with them.
If you are interested in this project, you are welcome to join the fun at https://github.com/tarekziade/boom