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

Features

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

Use Cases

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

Quickstart

Install

Artillery is available via npm

$ npm install -g artillery

Run A Quick Test

$ 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.

Run With A More Complex Scenario

$ 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 HTML Report

Create a graphical report from the JSON stats produced by artillery run with: artillery report <report_xxxxx.json>

Learn More

See Artillery docs for docs and examples.

Contributing

Thinking of contributing to Artillery? Awesome! Please have a quick look at the guide.

License

Artillery is open-source software distributed under the terms of the MPL2 license.

MPL 2.0 FAQ

Nepoxx / artillery