telegraf/plugins/outputs/cloudwatch
Daniel Nelson fe91c779e9
Remove AWS credential check from cloudwatch output (#3583)
This method is reported to not work with IAM Instance Profiles, and we
do not want to make any calls that would require additional permissions.

(cherry picked from commit 5b40173bcb)
2017-12-13 17:52:45 -08:00
..
README.md Fix cloudwatch output requires unneeded permissions (#3335) 2017-10-13 11:04:40 -07:00
cloudwatch.go Remove AWS credential check from cloudwatch output (#3583) 2017-12-13 17:52:45 -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.