nodeload - Load test tool for HTTP APIs. Generates result charts and has hooks for generating requests.
nodeload.js [options] <host>:<port>[<path>]
nodeload is for generating lots of requests to send to an HTTP API. It is
inspired by Apache's ab benchmark tool and is designed to let programmers
develop load tests and get informative reports without having to learn a
big and complicated framework..
-n, --number NUMBER Number of requests to make. Defaults to
value of --concurrency unless a time limit
is specified.
-c, --concurrency NUMBER Concurrent number of connections. Defaults to 1.
-t, --time-limit NUMBER Number of seconds to spend running test. No timelimit by default.
-e, --request-rate NUMBER Target number of requests per seconds. Infinite by default
-m, --method STRING HTTP method to use.
-d, --data STRING Data to send along with PUT or POST request.
-f, --flot-chart If set, generate an HTML page with a Flot chart of results.
-r, --request-generator STRING Path to module that exports getRequest function
-i, --report-interval NUMBER Frequency in seconds to report statistics
-q, --quiet Supress display of progress count info.
-u, --usage Show usage info
nodeload requires node to be installed somewhere on your path.
To get a known working combination of nodeload + node grab a release
download or checkout a release tag.
To find a version of node that's compatible with a tag release do
git show <tagname>.
For example: git show v0.1.1
1. Install node.js.
2. Clone nodeload.
3. cd into nodeload working copy.
4. git submodule update --init
5. Start testing!
nodeload contains a toy server that you can use for a quick demo.
Try the following:
[~/code/nodeload] node examples/test-server.js &
[1] 2756
[~/code/nodeload] Server running at http://127.0.0.1:8000/
[~/code/nodeload] ./nodeload.js -f -c 10 -n 10000 -i 1 -r ./examples/test-generator.js localhost:8000
You should now see some test output in your console. The generated HTML
report contains a graphical chart of test results.
Benjamin Schmaus <benjamin.schmaus@gmail.com>
Jonathan Lee <jonjlee@gmail.com>
Thanks to Orlando Vazquez ovazquez@gmail.com for the original proof of concept app.
ab(1), NODELOADLIB.md