39 lines
1.2 KiB
Markdown
39 lines
1.2 KiB
Markdown
## 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](https://github.com/aws/aws-sdk-go/wiki/configuring-sdk#environment-variables)
|
|
5. [Shared Credentials](https://github.com/aws/aws-sdk-go/wiki/configuring-sdk#shared-credentials-file)
|
|
6. [EC2 Instance Profile](http://docs.aws.amazon.com/AWSEC2/latest/UserGuide/iam-roles-for-amazon-ec2.html)
|
|
|
|
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.
|