telegraf/plugins/outputs/cloudwatch
Adam Johnson 56be3d3236 Reintroduce AWS credential check to cloudwatch output (#3587) 2018-01-02 16:33:15 -08:00
..
README.md Fix cloudwatch output requires unneeded permissions (#3335) 2017-10-13 11:04:40 -07:00
cloudwatch.go Reintroduce AWS credential check to cloudwatch output (#3587) 2018-01-02 16:33:15 -08:00
cloudwatch_test.go Added CloudWatch metric constraint validation (#3183) 2017-08-28 16:56:03 -07:00

README.md

Amazon CloudWatch Output for Telegraf

This plugin will send metrics to Amazon CloudWatch.

Amazon Authentication

This plugin uses a credential chain for Authentication with the CloudWatch API endpoint. In the following order the plugin will attempt to authenticate.

  1. Assumed credentials via STS if role_arn attribute is specified (source credentials are evaluated from subsequent rules)
  2. Explicit credentials from access_key, secret_key, and token attributes
  3. Shared profile from profile attribute
  4. Environment Variables
  5. Shared Credentials
  6. EC2 Instance Profile

The IAM user needs only the cloudwatch:PutMetricData permission.

Config

For this output plugin to function correctly the following variables must be configured.

  • region
  • namespace

region

The region is the Amazon region that you wish to connect to. Examples include but are not limited to:

  • us-west-1
  • us-west-2
  • us-east-1
  • ap-southeast-1
  • ap-southeast-2

namespace

The namespace used for AWS CloudWatch metrics.