Artillery is modern multi-protocol load-generator with a strong focus on developer happiness and a batteries-included philosophy. Use it to load-test your webapp backend, API or microservice to help make it faster, more resilient, and more scalable.
- Source: https://github.com/shoreditch-ops/artillery
- Issues: https://github.com/shoreditch-ops/artillery/issues
- Chat: https://gitter.im/shoreditch-ops/artillery
- Docs: https://artillery.io/docs/
- Website: https://artillery.io
- Twitter: @ShoreditchOps
- HTTP and WebSocket support (AMQP coming next)
- Detailed performance metrics (latency, RPS, throughput)
- Graphical reports (self-contained HTML file, handy for embedding in CI or emailing around)
- Test scenarios are just easy-to-read JSON (or YAML) - all declarative, no code (see an example)
- Dynamic payloads from external CSV files (e.g. usernames/passwords for making auth requests)
- Use Artillery as a standalone CLI tool or as a Node.js library
- Good performance (1.2k RPS for HTTP on a modest VPS)
- Plugin support (experimental) - docs - e.g. publish stats to Graphite/Librato/DataDog in real-time
- Open-source & free (commercial support is available for enterprise users - team@artillery.io)
- Benchmark the performance of your API or microservice as you're building it
- Ensure new code does not introduce performance regressions
- Test your code for memory leaks
- Benchmark dependencies (libraries, frameworks, external services) to get a feel for their performance characteristics before you integrate
- Run load-tests before you launch to ensure your application can meet projected demand
Artillery is available via npm
$ npm install -g artillery
$ artillery quick -d 30 -r 5 http://127.0.0.1:3000/test
This will run a test for 30 seconds with an average of 5 new requests to
http://127.0.0.1:3000/test every second.
$ artillery run hello.json
Where hello.json is your tests script that contains something like:
{
"config": {
"target": "http://127.0.0.1:3000",
"phases": [
{ "duration": 120, "arrivalRate": 10 }
],
"defaults": {
"headers": {
"content-type": "application/json",
"x-my-service-auth": "987401838271002188298567"
}
}
},
"scenarios": [
{
"flow": [
{ "get": {"url": "/test"}},
{ "think": 1 },
{ "post": {"url": "/test", "json": { "name": "hassy" }}}
]
}
]
}Create a graphical report from the JSON stats produced by artillery run with:
artillery report <report_xxxxx.json>
Thinking of contributing to Artillery? Awesome! Please have a quick look at the guide.
Artillery is open-source software distributed under the terms of the MPL2 license.