# README
EC2 Tagger Processor
The EC2 Tagger Processor can be used to scrape metadata from IMDS in EC2 instances or ECS EC2 or EKS EC2 and add the metadata to the data point attributes
Status | |
---|---|
Stability | [stable] |
Supported pipeline types | metrics |
Distributions | [amazon-cloudwatch-agent] |
Amazon Authentication
The EC2 Tagger Processor uses a credential chain for Authentication with the EC2 API endpoint. In the following order the plugin will attempt to authenticate.
- STS Credentials if Role ARN is specified
- Explicit credentials from 'access_key' and 'secret_key'
- Shared profile from 'profile' (https://stackoverflow.com/a/66121705)
The next will be the default credential chain from AWS SDK Go
- Environment Variables
- Share Credentials Files with default profile
- ECS Task IAM Role
- EC2 Instance Profile
The IAM User or Role making the calls must have permissions to call the EC2 DescribeTags API.
Processor Configuration:
The following receiver configuration parameters are supported.
Name | Description | Supported Value | Default |
---|---|---|---|
refresh_interval_seconds | is the frequency for the plugin to refresh the EC2 Instance Tags and ebs Volumes associated with this Instance. | "0s" | "0s" |
ec2_metadata_tags | is the option to specify which tags to be scraped from IMDS and add to datapoint attributes | ["InstanceId", "ImageId", "InstanceType"] | [] |
ec2_instance_tag_keys | is the option to specific which EC2 Instance tags to be scraped associated with this instance. | ["aws:autoscaling:groupName", "Name"] | [] |
disk_device_tag_key | is the option to Specify which tags to use to get the specified disk device name from input metric | [] | [] |
# Functions
No description provided by the author
No description provided by the author
# Constants
No description provided by the author
No description provided by the author
# Variables
No description provided by the author
No description provided by the author
# Interfaces
No description provided by the author