Skip to content
v2.273.0

WarmUpConfigurationProperty Struct ​

The configuration settings that define the warm-up behavior for an alarm.

Use these settings to delay alarm evaluation after you create or update the alarm, which reduces alarm noise while a new resource or service starts publishing data. During the warm-up period, the alarm stays in INSUFFICIENT_DATA and does not perform alarm actions.

Example ​

ts
// The code below shows an example of how to instantiate this type.
// The values are placeholders you should change.
import { aws_cloudwatch as cloudwatch } from 'aws-cdk-lib';
const warmUpConfigurationProperty: cloudwatch.CfnAlarm.WarmUpConfigurationProperty = {
  onlyStartEvaluatingAfterWarmUpPeriodEnds: false,
  warmUpPeriodDurationInMinutes: 123,
};

Properties ​

onlyStartEvaluatingAfterWarmUpPeriodEndsboolean | IResolvableonly_start_evaluating_after_warm_up_period_endstyping.Union[bool, IResolvable]onlyStartEvaluatingAfterWarmUpPeriodEndsBooleanOnlyStartEvaluatingAfterWarmUpPeriodEndsboolOnlyStartEvaluatingAfterWarmUpPeriodEndsinterface{}#
Specifies whether the alarm waits for the full warm-up period before it starts to evaluate.
notes

The default is false. If true, the alarm waits the entire WarmUpPeriodDurationInMinutes before it starts to evaluate, even if metric data arrives earlier. If false, the alarm ends the warm-up period early. Evaluation begins as soon as the alarm has enough metric data to fill its evaluation window.

warmUpPeriodDurationInMinutesnumberwarm_up_period_duration_in_minutesint | floatwarmUpPeriodDurationInMinutesNumberWarmUpPeriodDurationInMinutesdoubleWarmUpPeriodDurationInMinutes*float64#
The length of the warm-up period, in minutes.
notes

After you create or update the alarm, the alarm stays in INSUFFICIENT_DATA for this duration. During this time, the alarm does not perform alarm actions. You can change this value at any time, including after the warm-up period ends. If you change it after the warm-up period ends, the new value does not restart the warm-up period.