How do I pull my EC2 tags without using the AWS integration?
Cette page n'est pas encore disponible en français, sa traduction est en cours.
Si vous avez des questions ou des retours sur notre projet de traduction actuel,
n'hésitez pas à nous contacter.
To pull custom AWS tags for an EC2 instance through the Datadog Agent without using the AWS integration, follow these steps:
Datadog recommends gathering instance tags through the EC2 Instance Metadata Service.
This mechanism is available in the Datadog Agent v7.35.0.
- Ensure that the EC2 instance is configured to allow access to tags in the instance metadata. See the AWS documentation.
- In the
datadog.yaml file, set collect_ec2_tags: true and collect_ec2_tags_use_imds: true. - Restart the Agent.
If tags are not available through the EC2 Instance Metadata Service, the Datadog Agent uses the EC2 API to gather tags.
- Make sure an IAM role is assigned to the EC2 instance, using the AWS documentation. Create one if necessary.
- Attach a policy to the IAM role that includes the permission
ec2:DescribeTags. - In
datadog.yaml, set collect_ec2_tags: true. - Restart the Agent.
- Create a IAM role for the instance using the AWS documentation.
- For the policy section, specify the permissions:
"ec2:Describe*", "ec2:Get*". - In
datadog.conf, set collect_ec2_tags: true. - Optional: Add the security-groups tag by enabling
collect_security_groups. - Restart the Agent.
- Make sure an IAM role is assigned to the agent task, using the AWS documentation. Create one if necessary.
- Attach a policy to the IAM role that includes the permission
ec2:DescribeTags. - Start the Datadog Agent container with the environment variable
DD_COLLECT_EC2_TAGS=true.
Note: For backwards compatibility, the Agent will also try using the EC2 instance role if the ECS task role is unavailable or has insufficient permissions.
This option only pulls in custom tags set on the EC2 host under the Tags tab in your AWS console:
Tags like availability_zone, region, or instance_type are only available by pulling in the EC2 host through the AWS integration.
