AWS Auto Scaling
AWS Auto Scaling is a service to launch or terminate EC2 instances automatically based on user-defined policies.
Enable this integration to see all your Auto Scaling metrics in Datadog.
Collect EC2 metrics for hosts in Auto Scaling groups with the
Collect Auto Scaling metrics about the specific group with the
If you haven’t already, set up the
Amazon Web Services integration first. Metric collection
In the Datadog
AWS integration tile, ensure that
AutoScaling is checked under metric collection.
In AWS, Auto Scaling data must be sent to CloudWatch. See
Enable Auto Scaling Group Metrics.
Add the following permissions to your
Datadog IAM policy in order to collect AWS Auto Scaling metrics. For more information, see the Auto Scaling policies on the AWS website.
Used to list all Auto Scaling groups.
List available policies (for autocompletion in events and monitors).
Used to list tags for a given Auto Scaling group. This adds ASG custom tags on ASG CloudWatch metrics.
Used to generate events when an ASG scales up or down.
Execute one policy (scale up or down from a monitor or the events feed).
This is not included in the installation Policy Document and should only be included if you are using monitors or events to execute an Auto Scaling policy.
Datadog - AWS Auto Scaling integration. Log collection
Configure AWS Auto Scaling to send logs either to a S3 bucket or to CloudWatch.
Note: If you log to a S3 bucket, make sure that
amazon_auto_scaling is set as
Target prefix. Send logs to Datadog
If you haven’t already, set up the
Datadog log collection AWS Lambda function.
Once the lambda function is installed, manually add a trigger on the S3 bucket or CloudWatch log group that contains your AWS Auto Scaling logs in the AWS console:
aws.autoscaling.group_desired_capacity (gauge) The number of instances that the Auto Scaling group attempts to maintain.
aws.autoscaling.group_in_service_instances (gauge) The number of instances that are running as part of the Auto Scaling group. This metric does not include instances that are pending or terminating.
aws.autoscaling.group_max_size (gauge) The maximum size of the Auto Scaling group.
aws.autoscaling.group_min_size (gauge) The minimum size of the Auto Scaling group.
aws.autoscaling.group_pending_instances (gauge) The number of instances that are pending. A pending instance is not yet in service. This metric does not include instances that are in service or terminating.
aws.autoscaling.group_terminating_instances (gauge) The number of instances that are in the process of terminating. This metric does not include instances that are in service or pending.
aws.autoscaling.group_total_instances (gauge) The total number of instances in the Auto Scaling group. This metric identifies the number of instances that are in service and/or pending and/or terminating.
Each of the metrics retrieved from AWS is assigned the same tags that appear in the AWS console, including but not limited to host name, security-groups, and more.
The AWS Auto-Scaling integration includes events for launching and terminating EC2 instances. See example events below:
The AWS Auto-Scaling integration does not include any service checks.
In order for the ASG metrics to start appearing in Datadog, first enable them in your AWS console.
See the AWS instructions on how to enable your ASG metrics. Note: It may take a while for such metrics to appear after they have been enabled.
Need help? Contact