78 lines
No EOL
3.2 KiB
Text
78 lines
No EOL
3.2 KiB
Text
# Attach AWS EC2 metadata to metrics
|
|
[[processors.aws_ec2]]
|
|
## Instance identity document tags to attach to metrics.
|
|
## For more information see:
|
|
## https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/instance-identity-documents.html
|
|
##
|
|
## Available tags:
|
|
## * accountId
|
|
## * architecture
|
|
## * availabilityZone
|
|
## * billingProducts
|
|
## * imageId
|
|
## * instanceId
|
|
## * instanceType
|
|
## * kernelId
|
|
## * pendingTime
|
|
## * privateIp
|
|
## * ramdiskId
|
|
## * region
|
|
## * version
|
|
# imds_tags = []
|
|
|
|
## EC2 instance tags retrieved with DescribeTags action.
|
|
## In case tag is empty upon retrieval it's omitted when tagging metrics.
|
|
## Note that in order for this to work, role attached to EC2 instance or AWS
|
|
## credentials available from the environment must have a policy attached, that
|
|
## allows ec2:DescribeTags.
|
|
##
|
|
## For more information see:
|
|
## https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_DescribeTags.html
|
|
# ec2_tags = []
|
|
|
|
## Paths to instance metadata information to attach to the metrics.
|
|
## Specify the full path without the base-path e.g. `tags/instance/Name`.
|
|
##
|
|
## For more information see:
|
|
## https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-instance-metadata.html
|
|
# metadata_paths = []
|
|
|
|
## Allows to convert metadata tag-names to canonical names representing the
|
|
## full path with slashes ('/') being replaces with underscores. By default,
|
|
## only the last path element is used to name the tag.
|
|
# canonical_metadata_tags = false
|
|
|
|
## Timeout for http requests made by against aws ec2 metadata endpoint.
|
|
# timeout = "10s"
|
|
|
|
## ordered controls whether or not the metrics need to stay in the same order
|
|
## this plugin received them in. If false, this plugin will change the order
|
|
## with requests hitting cached results moving through immediately and not
|
|
## waiting on slower lookups. This may cause issues for you if you are
|
|
## depending on the order of metrics staying the same. If so, set this to true.
|
|
## Keeping the metrics ordered may be slightly slower.
|
|
# ordered = false
|
|
|
|
## max_parallel_calls is the maximum number of AWS API calls to be in flight
|
|
## at the same time.
|
|
## It's probably best to keep this number fairly low.
|
|
# max_parallel_calls = 10
|
|
|
|
## cache_ttl determines how long each cached item will remain in the cache before
|
|
## it is removed and subsequently needs to be queried for from the AWS API. By
|
|
## default, no items are cached.
|
|
# cache_ttl = "0s"
|
|
|
|
## tag_cache_size determines how many of the values which are found in imds_tags
|
|
## or ec2_tags will be kept in memory for faster lookup on successive processing
|
|
## of metrics. You may want to adjust this if you have excessively large numbers
|
|
## of tags on your EC2 instances, and you are using the ec2_tags field. This
|
|
## typically does not need to be changed when using the imds_tags field.
|
|
# tag_cache_size = 1000
|
|
|
|
## log_cache_stats will emit a log line periodically to stdout with details of
|
|
## cache entries, hits, misses, and evacuations since the last time stats were
|
|
## emitted. This can be helpful in determining whether caching is being effective
|
|
## in your environment. Stats are emitted every 30 seconds. By default, this
|
|
## setting is disabled.
|
|
# log_cache_stats = false |