software.amazon.awscdk.services.autoscaling

Interface CfnScalingPolicy.CustomizedMetricSpecificationProperty

All Known Implementing Classes:

CfnScalingPolicy.CustomizedMetricSpecificationProperty.Jsii$Proxy

Enclosing class:

CfnScalingPolicy

public static interface CfnScalingPolicy.CustomizedMetricSpecificationProperty

Contains customized metric specification information for a target tracking scaling policy for Amazon EC2 Auto Scaling.

To create your customized metric specification:

• Add values for each required property from CloudWatch. You can use an existing metric, or a new metric that you create. To use your own metric, you must first publish the metric to CloudWatch. For more information, see Publish Custom Metrics in the Amazon CloudWatch User Guide .
• Choose a metric that changes proportionally with capacity. The value of the metric should increase or decrease in inverse proportion to the number of capacity units. That is, the value of the metric should decrease when capacity increases.

For more information about CloudWatch, see Amazon CloudWatch Concepts .

CustomizedMetricSpecification is a property of the AWS::AutoScaling::ScalingPolicy TargetTrackingConfiguration property type.

Example:

 // The code below shows an example of how to instantiate this type.
 // The values are placeholders you should change.
 import software.amazon.awscdk.services.autoscaling.*;
 CustomizedMetricSpecificationProperty customizedMetricSpecificationProperty = CustomizedMetricSpecificationProperty.builder()
         .metricName("metricName")
         .namespace("namespace")
         .statistic("statistic")
         // the properties below are optional
         .dimensions(List.of(MetricDimensionProperty.builder()
                 .name("name")
                 .value("value")
                 .build()))
         .unit("unit")
         .build();
 

Nested Class Summary

Nested Classes

Modifier and Type	Interface and Description
static class	CfnScalingPolicy.CustomizedMetricSpecificationProperty.Builder A builder for CfnScalingPolicy.CustomizedMetricSpecificationProperty
static class	CfnScalingPolicy.CustomizedMetricSpecificationProperty.Jsii$Proxy An implementation for CfnScalingPolicy.CustomizedMetricSpecificationProperty

Method Summary

Modifier and Type	Method and Description
static CfnScalingPolicy.CustomizedMetricSpecificationProperty.Builder	builder()
default java.lang.Object	getDimensions() The dimensions of the metric.
java.lang.String	getMetricName() The name of the metric.
java.lang.String	getNamespace() The namespace of the metric.
java.lang.String	getStatistic() The statistic of the metric.
default java.lang.String	getUnit() The unit of the metric.

Method Detail

getMetricName

java.lang.String getMetricName()

The name of the metric.

To get the exact metric name, namespace, and dimensions, inspect the Metric object that is returned by a call to ListMetrics .

getNamespace

java.lang.String getNamespace()

The namespace of the metric.

getStatistic

java.lang.String getStatistic()

The statistic of the metric.

getDimensions

default java.lang.Object getDimensions()

The dimensions of the metric.

Conditional: If you published your metric with dimensions, you must specify the same dimensions in your scaling policy.

getUnit

default java.lang.String getUnit()

The unit of the metric.

For a complete list of the units that CloudWatch supports, see the MetricDatum data type in the Amazon CloudWatch API Reference .

builder

static CfnScalingPolicy.CustomizedMetricSpecificationProperty.Builder builder()

Returns:

a CfnScalingPolicy.CustomizedMetricSpecificationProperty.Builder of CfnScalingPolicy.CustomizedMetricSpecificationProperty