Snap CloudWatch Publisher Plugin

Changlog

Please see changlog.

Getting Started

To get started, you will need snap (v0.14.0-beta or above) running to receive and aggregate sampling data points. Of course, you will need a working Amazon Web Service (AWS) account so the data points can be published onto CloudWatch.

System Requirements

• golang 1.5+ (needed only for building)
• snap

Operating Systems

All OSs currently supported by snap:

• Linux/amd64
• Darwin/amd64

Installation

Download Snap CloudWatch Publisher Plugin binary:

There is no pre-built binary avaiable yet.

To build the plugin binary:

Fork https://github.com/Ticketmaster/snap-plugin-publisher-cloudwatch.git Clone repo into $GOPATH/src/github.com/ticketmaster/:

$ git clone https://github.com/Ticketmaster/snap-plugin-publisher-cloudwatch.git

Build the plugin by running make within the cloned repo:

$ make

This builds the plugin in /build/rootfs/

To cross build either linux or OS X/macOS,

$ export GOOS=linux;make
$ export GOOS=darwin;make

Configuration and Usage

• Set up the snap framework
• Ensure $SNAP_PATH is exported
  export SNAP_PATH=$GOPATH/src/github.com/intelsdi-x/snap/build/linux/x86_64

Configure Amazon Web Service (AWS)

• Install aws command line and configure it correctly.
• This plugin supports aws_access_key_id, aws_secret_access_key, and aws_session_token. It will also works with EC2 instance using IAM Roles/Policies (CloudWatchFullAccess).

Example Task

---
  version: 1
  schedule:
    type: "simple"
    interval: "1s"
  workflow:
    collect:
      metrics:
        /intel/mock/foo: {}
        /intel/mock/bar: {}
        /intel/mock/*/boz: {}
      config:
        /intel/mock:
          name: "root"
          password: "secret"
      tags:
        /intel:
          region: "us-east-1"
          cluster: "cluster_xyz"
      process:
        -
          plugin_name: "passthru"
          process: null
          publish:
            -
              plugin_name: "cloudwatch"
              config:
                region: "us-east-1"
                namespace: "snap"
                storage_resolution: 60

Create task:

$ snaptel task create -t sample-task.yaml