Sign In to the Console
AWS CloudFormation
User Guide (Version )

AWS Documentation » AWS CloudFormation » User Guide » Amazon EMR Resource Type Reference » AWS::EMR::InstanceGroupConfig » AWS::EMR::InstanceGroupConfig CloudWatchAlarmDefinition

AWS::EMR::InstanceGroupConfig CloudWatchAlarmDefinition

CloudWatchAlarmDefinition is a subproperty of the ScalingTrigger property, which determines when to trigger an automatic scaling activity. Scaling activity begins when you satisfy the defined alarm conditions.

Syntax

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

JSON

{
  "ComparisonOperator" : String,
  "Dimensions" : [ MetricDimension, ... ],
  "EvaluationPeriods" : Integer,
  "MetricName" : String,
  "Namespace" : String,
  "Period" : Integer,
  "Statistic" : String,
  "Threshold" : Double,
  "Unit" : String
}

YAML

  ComparisonOperator: String
  Dimensions: 
    - MetricDimension
  EvaluationPeriods: Integer
  MetricName: String
  Namespace: String
  Period: Integer
  Statistic: String
  Threshold: Double
  Unit: String

Properties

ComparisonOperator

Determines how the metric specified by MetricName is compared to the value specified by Threshold.

Required: Yes

Type: String

Allowed Values: GREATER_THAN | GREATER_THAN_OR_EQUAL | LESS_THAN | LESS_THAN_OR_EQUAL

Update requires: No interruption

Dimensions

A CloudWatch metric dimension.

Required: No

Type: List of MetricDimension

Update requires: No interruption

EvaluationPeriods

The number of periods, expressed in seconds using Period, during which the alarm condition must exist before the alarm triggers automatic scaling activity. The default value is 1.

Required: No

Type: Integer

Update requires: No interruption

MetricName

The name of the CloudWatch metric that is watched to determine an alarm condition.

Required: Yes

Type: String

Update requires: No interruption

Namespace

The namespace for the CloudWatch metric. The default is AWS/ElasticMapReduce.

Required: No

Type: String

Update requires: No interruption

Period

The period, in seconds, over which the statistic is applied. EMR CloudWatch metrics are emitted every five minutes (300 seconds), so if an EMR CloudWatch metric is specified, specify 300.

Required: Yes

Type: Integer

Update requires: No interruption

Statistic

The statistic to apply to the metric associated with the alarm. The default is AVERAGE.

Required: No

Type: String

Allowed Values: AVERAGE | MAXIMUM | MINIMUM | SAMPLE_COUNT | SUM

Update requires: No interruption

Threshold

The value against which the specified statistic is compared.

Required: Yes

Type: Double

Update requires: No interruption

Unit

The unit of measure associated with the CloudWatch metric being watched. The value specified for Unit must correspond to the units specified in the CloudWatch metric.

Required: No

Type: String

Allowed Values: BITS | BITS_PER_SECOND | BYTES | BYTES_PER_SECOND | COUNT | COUNT_PER_SECOND | GIGA_BITS | GIGA_BITS_PER_SECOND | GIGA_BYTES | GIGA_BYTES_PER_SECOND | KILO_BITS | KILO_BITS_PER_SECOND | KILO_BYTES | KILO_BYTES_PER_SECOND | MEGA_BITS | MEGA_BITS_PER_SECOND | MEGA_BYTES | MEGA_BYTES_PER_SECOND | MICRO_SECONDS | MILLI_SECONDS | NONE | PERCENT | SECONDS | TERA_BITS | TERA_BITS_PER_SECOND | TERA_BYTES | TERA_BYTES_PER_SECOND

Update requires: No interruption

On this page: