This plugin will send metrics to Amazon CloudWatch.
This plugin uses a credential chain for Authentication with the CloudWatch API endpoint. In the following order the plugin will attempt to authenticate.
- Assumed credentials via STS if
role_arn
attribute is specified (source credentials are evaluated from subsequent rules) - Explicit credentials from
access_key
,secret_key
, andtoken
attributes - Shared profile from
profile
attribute - Environment Variables
- Shared Credentials
- EC2 Instance Profile
The IAM user needs only the cloudwatch:PutMetricData
permission.
For this output plugin to function correctly the following variables must be configured.
- region
- namespace
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
The namespace used for AWS CloudWatch metrics.
If you have a large amount of metrics, you should consider to send statistic
values instead of raw metrics which could not only improve performance but
also save AWS API cost. If enable this flag, this plugin would parse the required
CloudWatch statistic fields
(count, min, max, and sum) and send them to CloudWatch. You could use basicstats
aggregator to calculate those fields. If not all statistic fields are available,
all fields would still be sent as raw metrics.
Enable high resolution metrics (1 second precision) instead of standard ones (60 seconds precision).
Remove dimension keys and their corresponding values.
Example:
[[outputs.cloudwatch]]
region = "us-east-1"
namespace = "namespace"
write_statistics = false
high_resolution_metrics = false
[outputs.cloudwatch.dimensions_excluded]
dimension_to_remove = true