Datadog Synthetics is now available!

AWS Auto Scaling

Crawler Crawler

Overview

Amazon 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.

Setup

Installation

If you haven’t already, set up the Amazon Web Services integration first.

Configuration

  1. In the Datadog AWS integration tile, ensure that AutoScaling is checked under metric collection.

  2. In AWS, Auto Scaling data must be sent to CloudWatch. Refer to the AWS documentation: Enable Auto Scaling Group Metrics.

  3. Add the following permissions to your Datadog IAM policy in order to collect Amazon Auto Scaling metrics. For more information on Auto Scaling policies, review the documentation on the AWS website.

    AWS Permission Description
    autoscaling:DescribeAutoScalingGroups Used to list all autoscaling groups.
    autoscaling:DescribePolicies List available policies (for autocompletion in events and monitors).
    autoscaling:DescribeTags Used to list tags for a given autoscaling group. This will add ASG custom tags on ASG CloudWatch metrics.
    autoscaling:DescribeScalingActivities Used to generate events when an ASG scales up or down.
    autoscaling:ExecutePolicy 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 autoscaling policy.
  4. Install the Datadog - AWS Auto Scaling integration.

Data Collected

Metrics

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.

Events

The AWS Auto-Scaling integration includes events for launching and terminating EC2 instances. See example events below:

AWS Auto-Scaling Events

Service Checks

The AWS Auto-Scaling integration does not include any service checks.

Troubleshooting

Need help? Contact Datadog support.