shoreditch-ops/artillery-plugin-statsd

Name: artillery-plugin-statsd

Owner: Shoreditch Ops

Description: StatsD publishing plugin for Artillery

Created: 2015-09-20 14:39:14.0

Updated: 2018-04-27 21:19:21.0

Pushed: 2017-12-27 09:51:55.0

Homepage:

Size: 18

Language: JavaScript

GitHub Committers

User	Most Recent Commit	# Commits

Other Committers

User	Email	Most Recent Commit	# Commits

README

StatsD output for Artillery stats

This Artillery plugin allows you to publish the stats produced by Artillery CLI to StatsD in real-time.

Usage

Install

npm install -g artillery-plugin-statsd - if you've installed Artillery globally

npm install artillery-plugin-statsd otherwise.

Use

Enable the plugin by adding it in your test script's config.plugins section:

onfig": {
// ...
"plugins": {
  "statsd": {
    "host": "localhost",
    "port": 8125,
    "prefix": "artillery"
  }
}

 ...

host, port, and prefix are optional; the values above are the defaults.

Published metrics

By default, all stats from artillery are reported. This includes any custom stats you may have in place. As of artillery@1.5.0-17, the metrics you can expect to see are as follows.

• scenariosCreated
• scenariosCompleted
• requestsCompleted
• latency.min
• latency.max
• latency.median
• latency.p95
• latency.p99
• rps.count
• rps.mean
• scenarioDuration.min
• scenarioDuration.max
• scenarioDuration.median
• scenarioDuration.p95
• scenarioDuration.p99
• scenarioCounts.0, scenarioCounts.0 etc
• codes.200, codes.301 etc
• errors.ECONNREFUSED, errors.ETIMEDOUT etc
• matches
• concurrency
• pendingRequests

Metrics will be added or removed based on what artillery decides to send.

If a metric is null or cannot be resolved to a number, the default value of 0 is sent. You can change the default value in the configuration by passing in the property default. Example:

"default": 100000 - Metrics are sent with gauges so avoid negative numbers.

Metrics can be skipped by passing in an additional configuration property skipList. Skip list values can look like the following:

• "skipList": "scenarioDuration" - would skip all scenarioDuration metrics
• "skipList": "latency.max" - would skip only the latency.max metric
• "skipList": "scenarioDuration, latency.max" - a comma separated list can be used to pass in multiple values.

Using with Librato

This plugin can be used to publish metrics to Librato:

1. Install StatsD with:

   npm install statsd

2. Add Librato backend to StatsD:

   cd /path/to/statsd npm install statsd-librato-backend

   Enable the backend in your StatsD config:

   
   ato: {
   ail:  "mylibrato@email.com",
   ken:  "a161e2bc22b1bdd0cfe90412token10498token22dd52cat792doge1ab5a1d32"
   
   ends: ['statsd-librato-backend']
   
   

3. Run StatsD and use Artillery with this plugin.

License

artillery-plugin-statsd is distributed under the terms of the ISC license.