@Generated(value="com.amazonaws:aws-java-sdk-code-generator") public class PredictiveScalingMetricSpecification extends Object implements Serializable, Cloneable
This structure specifies the metrics and target utilization settings for a predictive scaling policy.
You must specify either a metric pair, or a load metric and a scaling metric individually. Specifying a metric pair instead of individual metrics provides a simpler way to configure metrics for a scaling policy. You choose the metric pair, and the policy automatically knows the correct sum and average statistics to use for the load metric and the scaling metric.
Example
You create a predictive scaling policy and specify ALBRequestCount
as the value for the metric pair and
1000.0
as the target value. For this type of metric, you must provide the metric dimension for the
corresponding target group, so you also provide a resource label for the Application Load Balancer target group that
is attached to your Auto Scaling group.
The number of requests the target group receives per minute provides the load metric, and the request count averaged
between the members of the target group provides the scaling metric. In CloudWatch, this refers to the
RequestCount
and RequestCountPerTarget
metrics, respectively.
For optimal use of predictive scaling, you adhere to the best practice of using a dynamic scaling policy to automatically scale between the minimum capacity and maximum capacity in response to real-time changes in resource utilization.
Amazon EC2 Auto Scaling consumes data points for the load metric over the last 14 days and creates an hourly load forecast for predictive scaling. (A minimum of 24 hours of data is required.)
After creating the load forecast, Amazon EC2 Auto Scaling determines when to reduce or increase the capacity of your Auto Scaling group in each hour of the forecast period so that the average number of requests received by each instance is as close to 1000 requests per minute as possible at all times.
Constructor and Description |
---|
PredictiveScalingMetricSpecification() |
Modifier and Type | Method and Description |
---|---|
PredictiveScalingMetricSpecification |
clone() |
boolean |
equals(Object obj) |
PredictiveScalingPredefinedLoadMetric |
getPredefinedLoadMetricSpecification()
The load metric specification.
|
PredictiveScalingPredefinedMetricPair |
getPredefinedMetricPairSpecification()
The metric pair specification from which Amazon EC2 Auto Scaling determines the appropriate scaling metric and
load metric to use.
|
PredictiveScalingPredefinedScalingMetric |
getPredefinedScalingMetricSpecification()
The scaling metric specification.
|
Double |
getTargetValue()
Specifies the target utilization.
|
int |
hashCode() |
void |
setPredefinedLoadMetricSpecification(PredictiveScalingPredefinedLoadMetric predefinedLoadMetricSpecification)
The load metric specification.
|
void |
setPredefinedMetricPairSpecification(PredictiveScalingPredefinedMetricPair predefinedMetricPairSpecification)
The metric pair specification from which Amazon EC2 Auto Scaling determines the appropriate scaling metric and
load metric to use.
|
void |
setPredefinedScalingMetricSpecification(PredictiveScalingPredefinedScalingMetric predefinedScalingMetricSpecification)
The scaling metric specification.
|
void |
setTargetValue(Double targetValue)
Specifies the target utilization.
|
String |
toString()
Returns a string representation of this object.
|
PredictiveScalingMetricSpecification |
withPredefinedLoadMetricSpecification(PredictiveScalingPredefinedLoadMetric predefinedLoadMetricSpecification)
The load metric specification.
|
PredictiveScalingMetricSpecification |
withPredefinedMetricPairSpecification(PredictiveScalingPredefinedMetricPair predefinedMetricPairSpecification)
The metric pair specification from which Amazon EC2 Auto Scaling determines the appropriate scaling metric and
load metric to use.
|
PredictiveScalingMetricSpecification |
withPredefinedScalingMetricSpecification(PredictiveScalingPredefinedScalingMetric predefinedScalingMetricSpecification)
The scaling metric specification.
|
PredictiveScalingMetricSpecification |
withTargetValue(Double targetValue)
Specifies the target utilization.
|
public PredictiveScalingMetricSpecification()
public void setTargetValue(Double targetValue)
Specifies the target utilization.
targetValue
- Specifies the target utilization.public Double getTargetValue()
Specifies the target utilization.
public PredictiveScalingMetricSpecification withTargetValue(Double targetValue)
Specifies the target utilization.
targetValue
- Specifies the target utilization.public void setPredefinedMetricPairSpecification(PredictiveScalingPredefinedMetricPair predefinedMetricPairSpecification)
The metric pair specification from which Amazon EC2 Auto Scaling determines the appropriate scaling metric and load metric to use.
predefinedMetricPairSpecification
- The metric pair specification from which Amazon EC2 Auto Scaling determines the appropriate scaling metric
and load metric to use.public PredictiveScalingPredefinedMetricPair getPredefinedMetricPairSpecification()
The metric pair specification from which Amazon EC2 Auto Scaling determines the appropriate scaling metric and load metric to use.
public PredictiveScalingMetricSpecification withPredefinedMetricPairSpecification(PredictiveScalingPredefinedMetricPair predefinedMetricPairSpecification)
The metric pair specification from which Amazon EC2 Auto Scaling determines the appropriate scaling metric and load metric to use.
predefinedMetricPairSpecification
- The metric pair specification from which Amazon EC2 Auto Scaling determines the appropriate scaling metric
and load metric to use.public void setPredefinedScalingMetricSpecification(PredictiveScalingPredefinedScalingMetric predefinedScalingMetricSpecification)
The scaling metric specification.
predefinedScalingMetricSpecification
- The scaling metric specification.public PredictiveScalingPredefinedScalingMetric getPredefinedScalingMetricSpecification()
The scaling metric specification.
public PredictiveScalingMetricSpecification withPredefinedScalingMetricSpecification(PredictiveScalingPredefinedScalingMetric predefinedScalingMetricSpecification)
The scaling metric specification.
predefinedScalingMetricSpecification
- The scaling metric specification.public void setPredefinedLoadMetricSpecification(PredictiveScalingPredefinedLoadMetric predefinedLoadMetricSpecification)
The load metric specification.
predefinedLoadMetricSpecification
- The load metric specification.public PredictiveScalingPredefinedLoadMetric getPredefinedLoadMetricSpecification()
The load metric specification.
public PredictiveScalingMetricSpecification withPredefinedLoadMetricSpecification(PredictiveScalingPredefinedLoadMetric predefinedLoadMetricSpecification)
The load metric specification.
predefinedLoadMetricSpecification
- The load metric specification.public String toString()
toString
in class Object
Object.toString()
public PredictiveScalingMetricSpecification clone()