AWS Elastic Beanstalk
Developer Guide (API Version 2010-12-01)

Your AWS Elastic Beanstalk Environment's Auto Scaling Group

Your Elastic Beanstalk includes an Auto Scaling group that manages the Amazon EC2 instances in your environment. In a single-instance environment, the Auto Scaling group ensures that there is always one instance running. In a load balanced environment, you configure the group with a range of instances to run, and Auto Scaling adds or removes instances as-needed based on load.

The Auto Scaling group also manages the launch configuration for the instances in your environment. You can modify the launch configuration to change the instance type, key pair, Amazon Elastic Block Store storage, and other settings that can only be configured when you launch an instance.

The Auto Scaling group uses two Amazon CloudWatch alarms to trigger scaling operations. The default triggers scale when the average outbound network traffic from each instance is higher than 6 MiB or lower than 2 MiB over a period of 5 minutes. To use Auto Scaling effectively, configure triggers that are appropriate for your application, instance type, and service requirements. You can scale based on several statistics including latency, disk I/O, CPU utilization, and request count.

To optimize your environment's use of Amazon EC2 instances through predictable periods of peak traffic, configure your Auto Scaling group to change its instance count on a schedule. You can schedule changes to your group's configuration that recur daily or weekly, or schedule one-time changes to prepare for marketing events that will drive a lot of traffic to your site.

Auto Scaling monitors the health of each Amazon EC2 instance that it launches. If any instance terminates unexpectedly, Auto Scaling detects the termination and launches a replacement instance. To configure the group to use the load balancer's health check mechanism, see Auto Scaling Health Check Setting.

Configuring Your Environment's Auto Scaling Group

You can configure how Auto Scaling works by editing Scaling on the environment's Configuration page in the environment management console.

To configure scheduled actions in the Elastic Beanstalk console

  1. Open the Elastic Beanstalk console.

  2. Navigate to the management page for your environment.

  3. Choose Configuration.

  4. Choose Scaling.

  5. Expand the Auto Scaling section.

            Elastic Beanstalk Auto Scaling Configuration Window
  6. Configure the following settings.

    Auto Scaling Group Settings

    • Minimum instance count – The minimum number of EC2 instances that the group should contain at any time. The group starts with the minimum count and adds instances when the scale-up trigger condition is met.

    • Maximum instance count – The maximum number of EC2 instances that the group should contain at any time.


      If you use rolling updates, make sure that the maximum instance count is higher than the Minimum instances in service setting for rolling updates.

    • Availability Zones – Choose the number of availability zones to spread your environment's instances across. By default, the Auto Scaling group launches instances evenly across all usable zones. To concentrate your instances in fewer zones, choose the number of zones to use. For production environments, use at least two zones to ensure that your application is available in case one Availability Zone goes out.

    • Custom Availability Zones (optional) – Choose the Availability Zones to use. Use this setting if your instances need to connect to resources in specific zones, or if you have purchased reserved instances, which are zone-specific. If you also set the number of zones, you must choose at least that many custom zones.

      If you launch your environment in a custom VPC, you cannot configure this option. In a custom VPC, you choose Availability Zones for the subnets that you assign to your environment.

    • Scaling cooldown (seconds) – The amount of time to wait for instances to launch or terminate after scaling, before continuing to evaluate triggers. For more information, see Auto Scaling Cooldowns.

  7. Choose Apply.

The aws:autoscaling:asg Namespace

Elastic Beanstalk provides configuration options for Auto Scaling settings in the aws:autoscaling:asg namespace.

option_settings: aws:autoscaling:asg: Availability Zones: Any Cooldown: '720' Custom Availability Zones: 'us-west-2a,us-west-2b' MaxSize: '4' MinSize: '2'