AWS CloudFormation
User Guide (Version )

AWS::AutoScaling::ScalingPolicy PredefinedMetricSpecification

PredefinedMetricSpecification is a subproperty of TargetTrackingConfiguration that configures a predefined metric for a target tracking policy to use with Amazon EC2 Auto Scaling.


To declare this entity in your AWS CloudFormation template, use the following syntax:


{ "PredefinedMetricType" : String, "ResourceLabel" : String }


PredefinedMetricType: String ResourceLabel: String



The metric type.

Required: Yes

Type: String

Allowed Values: ALBRequestCountPerTarget | ASGAverageCPUUtilization | ASGAverageNetworkIn | ASGAverageNetworkOut

Update requires: No interruption


Identifies the resource associated with the metric type. The following predefined metrics are available:

  • ASGAverageCPUUtilization - Average CPU utilization of the Auto Scaling group.

  • ASGAverageNetworkIn - Average number of bytes received on all network interfaces by the Auto Scaling group.

  • ASGAverageNetworkOut - Average number of bytes sent out on all network interfaces by the Auto Scaling group.

  • ALBRequestCountPerTarget - Number of requests completed per target in an Application Load Balancer target group.

For predefined metric types ASGAverageCPUUtilization, ASGAverageNetworkIn, and ASGAverageNetworkOut, the property must not be specified as the resource associated with the metric type is the Auto Scaling group. For predefined metric type ALBRequestCountPerTarget, the property must be specified in the format: app/load-balancer-name/load-balancer-id/targetgroup/target-group-name/target-group-id , where app/load-balancer-name/load-balancer-id is the final portion of the load balancer ARN, and targetgroup/target-group-name/target-group-id is the final portion of the target group ARN. The target group must be attached to the Auto Scaling group.

Required: Conditional

Type: String

Minimum: 1

Maximum: 1023

Pattern: [\u0020-\uD7FF\uE000-\uFFFD\uD800\uDC00-\uDBFF\uDFFF\r\n\t]*

Update requires: No interruption

On this page: