artillery-plugin-cloudwatch

A plugin for artillery.io that records response data into cloudwatch. See https://github.com/shoreditch-ops/artillery. Also see http://docs.aws.amazon.com/AmazonCloudWatch/latest/DeveloperGuide/WhatIsCloudWatch.html.

Usage no npm install needed!

<script type="module">
  import artilleryPluginCloudwatch from 'https://cdn.skypack.dev/artillery-plugin-cloudwatch';
</script>

README

artillery-plugin-cloudwatch

A plugin for artillery.io that records response data into cloudwatch.

To use:

  1. npm install -g artillery

  2. npm install artillery-plugin-cloudwatch (add -g if you like)

  3. Add cloudwatch plugin config to your "hello.json" Artillery script

    {
      "config": {
        "plugins": {
          "cloudwatch": {
              "namespace": "[INSERT_NAMESPACE]"
          }
        }
      }
    }
    
  4. artillery run hello.json

This will cause every latency to be published to the given CloudWatch namespace with the metric "ResultLatency".

This plugin assumes that the aws-sdk has been pre-configured, before it is loaded, with credentials and any other setting that may be required to successfully execute a PutMetricData against the CloudWatch API. This activity requires at least the rights given by the following IAM statement to the CloudWatch API in order to report latencies:

{
    "Effect": "Allow",
    "Action": [
        "cloudwatch:PutMetricData"
    ],
    "Resource": ["*"]
}

For more information, see:

Enjoy!