awslabs / collectd-cloudwatch

A collectd plugin for sending data to Amazon CloudWatch
MIT License
199 stars 131 forks source link

Add EC2 Instance Metadata to metrics sent to CW. (Custom Dimensions) #77

Open Tucker459 opened 5 years ago

Tucker459 commented 5 years ago

Issue #10

Description of changes: Added a feature where a user can specify in a dimension file the instance metadata that he/she wants to be pushed to aws cloudwatch along with the metric information. For example, a user can specify region, availability-zone, private-ip, instanceid, and more in the dimension file. In effect those attributes will be pushed along with the metric data to aws cloudwatch giving more clarity and information to the user about the particular metric(s).

Usage: Create dimensions file in whatever location you want. Recommended Path: /opt/collectd-plugins/cloudwatch/config/dimensions

Add Instance Dimensions to file: Host PrivateIp InstanceId Region etc.

Run: Python setup.py

For more information on instance dimensions to be added: https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/instance-identity-documents.html

By submitting this pull request, I confirm that you can use, modify, copy, and redistribute this contribution, under the terms of your choice.