1. Registry
  2. Packages
  3. AWS Cloud Control
  4. API Docs
  5. cloudwatch
  6. LogAlarm

We recommend new projects start with resources from the AWS provider.

Viewing docs for AWS Cloud Control v1.86.0
published on Wednesday, Nov 18, 2026 by Pulumi
aws-native logo aws-native logo AWS Cloud Control

We recommend new projects start with resources from the AWS provider.

Viewing docs for AWS Cloud Control v1.86.0
published on Wednesday, Nov 18, 2026 by Pulumi

    Resource Type definition for AWS::CloudWatch::LogAlarm. A LogAlarm evaluates scheduled query results from CloudWatch Logs and triggers actions when thresholds are breached.

    Create LogAlarm Resource

    Resources are created with functions called constructors. To learn more about declaring and configuring resources, see Resources.

    Constructor syntax

    new LogAlarm(name: string, args: LogAlarmArgs, opts?: CustomResourceOptions);
    @overload
    def LogAlarm(resource_name: str,
                 args: LogAlarmArgs,
                 opts: Optional[ResourceOptions] = None)
    
    @overload
    def LogAlarm(resource_name: str,
                 opts: Optional[ResourceOptions] = None,
                 comparison_operator: Optional[str] = None,
                 threshold: Optional[float] = None,
                 scheduled_query_configuration: Optional[LogAlarmScheduledQueryConfigurationArgs] = None,
                 query_results_to_evaluate: Optional[int] = None,
                 query_results_to_alarm: Optional[int] = None,
                 alarm_actions: Optional[Sequence[str]] = None,
                 alarm_name: Optional[str] = None,
                 alarm_description: Optional[str] = None,
                 insufficient_data_actions: Optional[Sequence[str]] = None,
                 ok_actions: Optional[Sequence[str]] = None,
                 action_configuration: Optional[LogAlarmActionConfigurationArgs] = None,
                 actions_enabled: Optional[bool] = None,
                 action_log_line_role_arn: Optional[str] = None,
                 tags: Optional[Sequence[_root_inputs.TagArgs]] = None,
                 action_log_line_count: Optional[int] = None,
                 treat_missing_data: Optional[str] = None,
                 warm_up_configuration: Optional[LogAlarmWarmUpConfigurationArgs] = None)
    func NewLogAlarm(ctx *Context, name string, args LogAlarmArgs, opts ...ResourceOption) (*LogAlarm, error)
    public LogAlarm(string name, LogAlarmArgs args, CustomResourceOptions? opts = null)
    public LogAlarm(String name, LogAlarmArgs args)
    public LogAlarm(String name, LogAlarmArgs args, CustomResourceOptions options)
    
    type: aws-native:cloudwatch:LogAlarm
    properties: # The arguments to resource properties.
    options: # Bag of options to control resource's behavior.
    
    
    resource "aws-native_cloudwatch_log_alarm" "name" {
        # resource properties
    }

    Parameters

    name string
    The unique name of the resource.
    args LogAlarmArgs
    The arguments to resource properties.
    opts CustomResourceOptions
    Bag of options to control resource's behavior.
    resource_name str
    The unique name of the resource.
    args LogAlarmArgs
    The arguments to resource properties.
    opts ResourceOptions
    Bag of options to control resource's behavior.
    ctx Context
    Context object for the current deployment.
    name string
    The unique name of the resource.
    args LogAlarmArgs
    The arguments to resource properties.
    opts ResourceOption
    Bag of options to control resource's behavior.
    name string
    The unique name of the resource.
    args LogAlarmArgs
    The arguments to resource properties.
    opts CustomResourceOptions
    Bag of options to control resource's behavior.
    name String
    The unique name of the resource.
    args LogAlarmArgs
    The arguments to resource properties.
    options CustomResourceOptions
    Bag of options to control resource's behavior.

    LogAlarm Resource Properties

    To learn more about resource properties and how to use them, see Inputs and Outputs in the Architecture and Concepts docs.

    Inputs

    In Python, inputs that are objects can be passed either as argument classes or as dictionary literals.

    The LogAlarm resource accepts the following input properties:

    ComparisonOperator string
    The arithmetic operation to use when comparing the specified threshold and the query results. Valid values are GreaterThanOrEqualToThreshold, GreaterThanThreshold, LessThanThreshold, and LessThanOrEqualToThreshold.
    QueryResultsToAlarm int
    The number of query results that must be breaching to trigger the alarm.
    QueryResultsToEvaluate int
    The number of query results over which data is compared to the specified threshold.
    ScheduledQueryConfiguration Pulumi.AwsNative.CloudWatch.Inputs.LogAlarmScheduledQueryConfiguration
    The scheduled query configuration for the log alarm.
    Threshold double
    The value to compare against the results of the scheduled query evaluation.
    ActionConfiguration Pulumi.AwsNative.CloudWatch.Inputs.LogAlarmActionConfiguration
    Configuration that applies to the notifications this alarm sends when it performs its actions.
    ActionLogLineCount int
    The number of log lines to include in alarm notifications. Valid values are 0 to 50.
    ActionLogLineRoleArn string
    The ARN of the IAM role that grants CloudWatch permissions to fetch log lines for alarm notifications. Required when ActionLogLineCount is greater than 0.
    ActionsEnabled bool
    Indicates whether actions should be executed during any changes to the alarm state. The default is TRUE.
    AlarmActions List<string>
    The list of actions to execute when this alarm transitions into an ALARM state from any other state.
    AlarmDescription string
    The description of the log alarm.
    AlarmName string
    The name of the log alarm.
    InsufficientDataActions List<string>
    The actions to execute when this alarm transitions to the INSUFFICIENT_DATA state from any other state.
    OkActions List<string>
    The actions to execute when this alarm transitions to the OK state from any other state.
    Tags List<Pulumi.AwsNative.Inputs.Tag>
    A list of key-value pairs to associate with the log alarm.
    TreatMissingData string
    Sets how this alarm is to handle missing data points. Valid values are breaching, notBreaching, ignore, and missing.
    WarmUpConfiguration Pulumi.AwsNative.CloudWatch.Inputs.LogAlarmWarmUpConfiguration
    The warm-up configuration for the alarm. During the warm-up period, the alarm stays in INSUFFICIENT_DATA and doesn't perform alarm actions. For more information, see Alarm warm-up periods in the Amazon CloudWatch User Guide.
    ComparisonOperator string
    The arithmetic operation to use when comparing the specified threshold and the query results. Valid values are GreaterThanOrEqualToThreshold, GreaterThanThreshold, LessThanThreshold, and LessThanOrEqualToThreshold.
    QueryResultsToAlarm int
    The number of query results that must be breaching to trigger the alarm.
    QueryResultsToEvaluate int
    The number of query results over which data is compared to the specified threshold.
    ScheduledQueryConfiguration LogAlarmScheduledQueryConfigurationArgs
    The scheduled query configuration for the log alarm.
    Threshold float64
    The value to compare against the results of the scheduled query evaluation.
    ActionConfiguration LogAlarmActionConfigurationArgs
    Configuration that applies to the notifications this alarm sends when it performs its actions.
    ActionLogLineCount int
    The number of log lines to include in alarm notifications. Valid values are 0 to 50.
    ActionLogLineRoleArn string
    The ARN of the IAM role that grants CloudWatch permissions to fetch log lines for alarm notifications. Required when ActionLogLineCount is greater than 0.
    ActionsEnabled bool
    Indicates whether actions should be executed during any changes to the alarm state. The default is TRUE.
    AlarmActions []string
    The list of actions to execute when this alarm transitions into an ALARM state from any other state.
    AlarmDescription string
    The description of the log alarm.
    AlarmName string
    The name of the log alarm.
    InsufficientDataActions []string
    The actions to execute when this alarm transitions to the INSUFFICIENT_DATA state from any other state.
    OkActions []string
    The actions to execute when this alarm transitions to the OK state from any other state.
    Tags TagArgs
    A list of key-value pairs to associate with the log alarm.
    TreatMissingData string
    Sets how this alarm is to handle missing data points. Valid values are breaching, notBreaching, ignore, and missing.
    WarmUpConfiguration LogAlarmWarmUpConfigurationArgs
    The warm-up configuration for the alarm. During the warm-up period, the alarm stays in INSUFFICIENT_DATA and doesn't perform alarm actions. For more information, see Alarm warm-up periods in the Amazon CloudWatch User Guide.
    comparison_operator string
    The arithmetic operation to use when comparing the specified threshold and the query results. Valid values are GreaterThanOrEqualToThreshold, GreaterThanThreshold, LessThanThreshold, and LessThanOrEqualToThreshold.
    query_results_to_alarm number
    The number of query results that must be breaching to trigger the alarm.
    query_results_to_evaluate number
    The number of query results over which data is compared to the specified threshold.
    scheduled_query_configuration object
    The scheduled query configuration for the log alarm.
    threshold number
    The value to compare against the results of the scheduled query evaluation.
    action_configuration object
    Configuration that applies to the notifications this alarm sends when it performs its actions.
    action_log_line_count number
    The number of log lines to include in alarm notifications. Valid values are 0 to 50.
    action_log_line_role_arn string
    The ARN of the IAM role that grants CloudWatch permissions to fetch log lines for alarm notifications. Required when ActionLogLineCount is greater than 0.
    actions_enabled bool
    Indicates whether actions should be executed during any changes to the alarm state. The default is TRUE.
    alarm_actions list(string)
    The list of actions to execute when this alarm transitions into an ALARM state from any other state.
    alarm_description string
    The description of the log alarm.
    alarm_name string
    The name of the log alarm.
    insufficient_data_actions list(string)
    The actions to execute when this alarm transitions to the INSUFFICIENT_DATA state from any other state.
    ok_actions list(string)
    The actions to execute when this alarm transitions to the OK state from any other state.
    tags list(object)
    A list of key-value pairs to associate with the log alarm.
    treat_missing_data string
    Sets how this alarm is to handle missing data points. Valid values are breaching, notBreaching, ignore, and missing.
    warm_up_configuration object
    The warm-up configuration for the alarm. During the warm-up period, the alarm stays in INSUFFICIENT_DATA and doesn't perform alarm actions. For more information, see Alarm warm-up periods in the Amazon CloudWatch User Guide.
    comparisonOperator String
    The arithmetic operation to use when comparing the specified threshold and the query results. Valid values are GreaterThanOrEqualToThreshold, GreaterThanThreshold, LessThanThreshold, and LessThanOrEqualToThreshold.
    queryResultsToAlarm Integer
    The number of query results that must be breaching to trigger the alarm.
    queryResultsToEvaluate Integer
    The number of query results over which data is compared to the specified threshold.
    scheduledQueryConfiguration LogAlarmScheduledQueryConfiguration
    The scheduled query configuration for the log alarm.
    threshold Double
    The value to compare against the results of the scheduled query evaluation.
    actionConfiguration LogAlarmActionConfiguration
    Configuration that applies to the notifications this alarm sends when it performs its actions.
    actionLogLineCount Integer
    The number of log lines to include in alarm notifications. Valid values are 0 to 50.
    actionLogLineRoleArn String
    The ARN of the IAM role that grants CloudWatch permissions to fetch log lines for alarm notifications. Required when ActionLogLineCount is greater than 0.
    actionsEnabled Boolean
    Indicates whether actions should be executed during any changes to the alarm state. The default is TRUE.
    alarmActions List<String>
    The list of actions to execute when this alarm transitions into an ALARM state from any other state.
    alarmDescription String
    The description of the log alarm.
    alarmName String
    The name of the log alarm.
    insufficientDataActions List<String>
    The actions to execute when this alarm transitions to the INSUFFICIENT_DATA state from any other state.
    okActions List<String>
    The actions to execute when this alarm transitions to the OK state from any other state.
    tags List<Tag>
    A list of key-value pairs to associate with the log alarm.
    treatMissingData String
    Sets how this alarm is to handle missing data points. Valid values are breaching, notBreaching, ignore, and missing.
    warmUpConfiguration LogAlarmWarmUpConfiguration
    The warm-up configuration for the alarm. During the warm-up period, the alarm stays in INSUFFICIENT_DATA and doesn't perform alarm actions. For more information, see Alarm warm-up periods in the Amazon CloudWatch User Guide.
    comparisonOperator string
    The arithmetic operation to use when comparing the specified threshold and the query results. Valid values are GreaterThanOrEqualToThreshold, GreaterThanThreshold, LessThanThreshold, and LessThanOrEqualToThreshold.
    queryResultsToAlarm number
    The number of query results that must be breaching to trigger the alarm.
    queryResultsToEvaluate number
    The number of query results over which data is compared to the specified threshold.
    scheduledQueryConfiguration LogAlarmScheduledQueryConfiguration
    The scheduled query configuration for the log alarm.
    threshold number
    The value to compare against the results of the scheduled query evaluation.
    actionConfiguration LogAlarmActionConfiguration
    Configuration that applies to the notifications this alarm sends when it performs its actions.
    actionLogLineCount number
    The number of log lines to include in alarm notifications. Valid values are 0 to 50.
    actionLogLineRoleArn string
    The ARN of the IAM role that grants CloudWatch permissions to fetch log lines for alarm notifications. Required when ActionLogLineCount is greater than 0.
    actionsEnabled boolean
    Indicates whether actions should be executed during any changes to the alarm state. The default is TRUE.
    alarmActions string[]
    The list of actions to execute when this alarm transitions into an ALARM state from any other state.
    alarmDescription string
    The description of the log alarm.
    alarmName string
    The name of the log alarm.
    insufficientDataActions string[]
    The actions to execute when this alarm transitions to the INSUFFICIENT_DATA state from any other state.
    okActions string[]
    The actions to execute when this alarm transitions to the OK state from any other state.
    tags Tag[]
    A list of key-value pairs to associate with the log alarm.
    treatMissingData string
    Sets how this alarm is to handle missing data points. Valid values are breaching, notBreaching, ignore, and missing.
    warmUpConfiguration LogAlarmWarmUpConfiguration
    The warm-up configuration for the alarm. During the warm-up period, the alarm stays in INSUFFICIENT_DATA and doesn't perform alarm actions. For more information, see Alarm warm-up periods in the Amazon CloudWatch User Guide.
    comparison_operator str
    The arithmetic operation to use when comparing the specified threshold and the query results. Valid values are GreaterThanOrEqualToThreshold, GreaterThanThreshold, LessThanThreshold, and LessThanOrEqualToThreshold.
    query_results_to_alarm int
    The number of query results that must be breaching to trigger the alarm.
    query_results_to_evaluate int
    The number of query results over which data is compared to the specified threshold.
    scheduled_query_configuration LogAlarmScheduledQueryConfigurationArgs
    The scheduled query configuration for the log alarm.
    threshold float
    The value to compare against the results of the scheduled query evaluation.
    action_configuration LogAlarmActionConfigurationArgs
    Configuration that applies to the notifications this alarm sends when it performs its actions.
    action_log_line_count int
    The number of log lines to include in alarm notifications. Valid values are 0 to 50.
    action_log_line_role_arn str
    The ARN of the IAM role that grants CloudWatch permissions to fetch log lines for alarm notifications. Required when ActionLogLineCount is greater than 0.
    actions_enabled bool
    Indicates whether actions should be executed during any changes to the alarm state. The default is TRUE.
    alarm_actions Sequence[str]
    The list of actions to execute when this alarm transitions into an ALARM state from any other state.
    alarm_description str
    The description of the log alarm.
    alarm_name str
    The name of the log alarm.
    insufficient_data_actions Sequence[str]
    The actions to execute when this alarm transitions to the INSUFFICIENT_DATA state from any other state.
    ok_actions Sequence[str]
    The actions to execute when this alarm transitions to the OK state from any other state.
    tags Sequence[TagArgs]
    A list of key-value pairs to associate with the log alarm.
    treat_missing_data str
    Sets how this alarm is to handle missing data points. Valid values are breaching, notBreaching, ignore, and missing.
    warm_up_configuration LogAlarmWarmUpConfigurationArgs
    The warm-up configuration for the alarm. During the warm-up period, the alarm stays in INSUFFICIENT_DATA and doesn't perform alarm actions. For more information, see Alarm warm-up periods in the Amazon CloudWatch User Guide.
    comparisonOperator String
    The arithmetic operation to use when comparing the specified threshold and the query results. Valid values are GreaterThanOrEqualToThreshold, GreaterThanThreshold, LessThanThreshold, and LessThanOrEqualToThreshold.
    queryResultsToAlarm Number
    The number of query results that must be breaching to trigger the alarm.
    queryResultsToEvaluate Number
    The number of query results over which data is compared to the specified threshold.
    scheduledQueryConfiguration Property Map
    The scheduled query configuration for the log alarm.
    threshold Number
    The value to compare against the results of the scheduled query evaluation.
    actionConfiguration Property Map
    Configuration that applies to the notifications this alarm sends when it performs its actions.
    actionLogLineCount Number
    The number of log lines to include in alarm notifications. Valid values are 0 to 50.
    actionLogLineRoleArn String
    The ARN of the IAM role that grants CloudWatch permissions to fetch log lines for alarm notifications. Required when ActionLogLineCount is greater than 0.
    actionsEnabled Boolean
    Indicates whether actions should be executed during any changes to the alarm state. The default is TRUE.
    alarmActions List<String>
    The list of actions to execute when this alarm transitions into an ALARM state from any other state.
    alarmDescription String
    The description of the log alarm.
    alarmName String
    The name of the log alarm.
    insufficientDataActions List<String>
    The actions to execute when this alarm transitions to the INSUFFICIENT_DATA state from any other state.
    okActions List<String>
    The actions to execute when this alarm transitions to the OK state from any other state.
    tags List<Property Map>
    A list of key-value pairs to associate with the log alarm.
    treatMissingData String
    Sets how this alarm is to handle missing data points. Valid values are breaching, notBreaching, ignore, and missing.
    warmUpConfiguration Property Map
    The warm-up configuration for the alarm. During the warm-up period, the alarm stays in INSUFFICIENT_DATA and doesn't perform alarm actions. For more information, see Alarm warm-up periods in the Amazon CloudWatch User Guide.

    Outputs

    All input properties are implicitly available as output properties. Additionally, the LogAlarm resource produces the following output properties:

    Arn string
    The ARN of the log alarm.
    Id string
    The provider-assigned unique ID for this managed resource.
    Arn string
    The ARN of the log alarm.
    Id string
    The provider-assigned unique ID for this managed resource.
    arn string
    The ARN of the log alarm.
    id string
    The provider-assigned unique ID for this managed resource.
    arn String
    The ARN of the log alarm.
    id String
    The provider-assigned unique ID for this managed resource.
    arn string
    The ARN of the log alarm.
    id string
    The provider-assigned unique ID for this managed resource.
    arn str
    The ARN of the log alarm.
    id str
    The provider-assigned unique ID for this managed resource.
    arn String
    The ARN of the log alarm.
    id String
    The provider-assigned unique ID for this managed resource.

    Look up Existing LogAlarm Resource

    Get an existing LogAlarm resource’s state with the given name, ID, and optional extra properties used to qualify the lookup.

    public static get(name: string, id: Input<ID>, opts?: CustomResourceOptions): LogAlarm
    @staticmethod
    def get(resource_name: str,
            id: str,
            opts: Optional[ResourceOptions] = None) -> LogAlarm
    func GetLogAlarm(ctx *Context, name string, id IDInput, state *LogAlarmState, opts ...ResourceOption) (*LogAlarm, error)
    public static LogAlarm Get(string name, Input<string> id, CustomResourceOptions? opts = null)
    public static LogAlarm get(String name, Output<String> id, CustomResourceOptions options)
    resources:  existingLogAlarm:    type: aws-native:cloudwatch:LogAlarm    get:      id: ${id}
    import {
      to = aws-native_cloudwatch_log_alarm.example
      id = "${id}"
    }
    
    name string
    The unique name of the resulting resource.
    id Input<ID>
    The unique provider ID of the resource to look up.
    opts CustomResourceOptions
    Bag of options to control resource's behavior.
    resource_name str
    The unique name of the resulting resource.
    id str
    The unique provider ID of the resource to look up.
    opts ResourceOptions
    Bag of options to control resource's behavior.
    ctx Context
    Context object for the current deployment.
    name string
    The unique name of the resulting resource.
    id IDInput
    The unique provider ID of the resource to look up.
    state LogAlarmState
    Pass nil. This resource has no state arguments.
    opts ResourceOption
    Bag of options to control resource's behavior.
    name string
    The unique name of the resulting resource.
    id Input<string>
    The unique provider ID of the resource to look up.
    opts CustomResourceOptions
    Bag of options to control resource's behavior.
    name String
    The unique name of the resulting resource.
    id Output<String>
    The unique provider ID of the resource to look up.
    options CustomResourceOptions
    Bag of options to control resource's behavior.

    Supporting Types

    LogAlarmActionConfiguration, LogAlarmActionConfigurationArgs

    Configuration that applies to the notifications this alarm sends when it performs its actions.

    AlarmTagsPropagation Pulumi.AwsNative.CloudWatch.Inputs.LogAlarmAlarmTagsPropagation
    Whether the alarm's tags are included in its action notifications and state-change events.
    AlarmTagsPropagation LogAlarmAlarmTagsPropagation
    Whether the alarm's tags are included in its action notifications and state-change events.
    alarm_tags_propagation object
    Whether the alarm's tags are included in its action notifications and state-change events.
    alarmTagsPropagation LogAlarmAlarmTagsPropagation
    Whether the alarm's tags are included in its action notifications and state-change events.
    alarmTagsPropagation LogAlarmAlarmTagsPropagation
    Whether the alarm's tags are included in its action notifications and state-change events.
    alarm_tags_propagation LogAlarmAlarmTagsPropagation
    Whether the alarm's tags are included in its action notifications and state-change events.
    alarmTagsPropagation Property Map
    Whether the alarm's tags are included in its action notifications and state-change events.

    LogAlarmAlarmTagsPropagation, LogAlarmAlarmTagsPropagationArgs

    Controls whether the alarm's tags are included in its action notifications and state-change events, and which tag keys are included. Specify IncludedTagKeys or ExcludedTagKeys, but not both. Omit both to include every tag.

    Enabled bool
    Whether the alarm's tags are included in its action notifications and state-change events.
    ExcludedTagKeys List<string>
    The tag keys to leave out. Cannot be specified together with IncludedTagKeys.
    IncludedTagKeys List<string>
    The only tag keys to include. Cannot be specified together with ExcludedTagKeys.
    Enabled bool
    Whether the alarm's tags are included in its action notifications and state-change events.
    ExcludedTagKeys []string
    The tag keys to leave out. Cannot be specified together with IncludedTagKeys.
    IncludedTagKeys []string
    The only tag keys to include. Cannot be specified together with ExcludedTagKeys.
    enabled bool
    Whether the alarm's tags are included in its action notifications and state-change events.
    excluded_tag_keys list(string)
    The tag keys to leave out. Cannot be specified together with IncludedTagKeys.
    included_tag_keys list(string)
    The only tag keys to include. Cannot be specified together with ExcludedTagKeys.
    enabled Boolean
    Whether the alarm's tags are included in its action notifications and state-change events.
    excludedTagKeys List<String>
    The tag keys to leave out. Cannot be specified together with IncludedTagKeys.
    includedTagKeys List<String>
    The only tag keys to include. Cannot be specified together with ExcludedTagKeys.
    enabled boolean
    Whether the alarm's tags are included in its action notifications and state-change events.
    excludedTagKeys string[]
    The tag keys to leave out. Cannot be specified together with IncludedTagKeys.
    includedTagKeys string[]
    The only tag keys to include. Cannot be specified together with ExcludedTagKeys.
    enabled bool
    Whether the alarm's tags are included in its action notifications and state-change events.
    excluded_tag_keys Sequence[str]
    The tag keys to leave out. Cannot be specified together with IncludedTagKeys.
    included_tag_keys Sequence[str]
    The only tag keys to include. Cannot be specified together with ExcludedTagKeys.
    enabled Boolean
    Whether the alarm's tags are included in its action notifications and state-change events.
    excludedTagKeys List<String>
    The tag keys to leave out. Cannot be specified together with IncludedTagKeys.
    includedTagKeys List<String>
    The only tag keys to include. Cannot be specified together with ExcludedTagKeys.

    LogAlarmScheduleConfiguration, LogAlarmScheduleConfigurationArgs

    The schedule configuration for the scheduled query.

    ScheduleExpression string
    The expression that defines when the scheduled query runs, e.g. rate(1 minute).
    StartTimeOffset int
    The number of seconds into the past to start the query window. Must be a positive value and cannot exceed 2592000 seconds (30 days).
    EndTimeOffset int
    The number of seconds into the past to end the query window. Must be a non-negative value and cannot exceed 2592000 seconds (30 days).
    ScheduleExpression string
    The expression that defines when the scheduled query runs, e.g. rate(1 minute).
    StartTimeOffset int
    The number of seconds into the past to start the query window. Must be a positive value and cannot exceed 2592000 seconds (30 days).
    EndTimeOffset int
    The number of seconds into the past to end the query window. Must be a non-negative value and cannot exceed 2592000 seconds (30 days).
    schedule_expression string
    The expression that defines when the scheduled query runs, e.g. rate(1 minute).
    start_time_offset number
    The number of seconds into the past to start the query window. Must be a positive value and cannot exceed 2592000 seconds (30 days).
    end_time_offset number
    The number of seconds into the past to end the query window. Must be a non-negative value and cannot exceed 2592000 seconds (30 days).
    scheduleExpression String
    The expression that defines when the scheduled query runs, e.g. rate(1 minute).
    startTimeOffset Integer
    The number of seconds into the past to start the query window. Must be a positive value and cannot exceed 2592000 seconds (30 days).
    endTimeOffset Integer
    The number of seconds into the past to end the query window. Must be a non-negative value and cannot exceed 2592000 seconds (30 days).
    scheduleExpression string
    The expression that defines when the scheduled query runs, e.g. rate(1 minute).
    startTimeOffset number
    The number of seconds into the past to start the query window. Must be a positive value and cannot exceed 2592000 seconds (30 days).
    endTimeOffset number
    The number of seconds into the past to end the query window. Must be a non-negative value and cannot exceed 2592000 seconds (30 days).
    schedule_expression str
    The expression that defines when the scheduled query runs, e.g. rate(1 minute).
    start_time_offset int
    The number of seconds into the past to start the query window. Must be a positive value and cannot exceed 2592000 seconds (30 days).
    end_time_offset int
    The number of seconds into the past to end the query window. Must be a non-negative value and cannot exceed 2592000 seconds (30 days).
    scheduleExpression String
    The expression that defines when the scheduled query runs, e.g. rate(1 minute).
    startTimeOffset Number
    The number of seconds into the past to start the query window. Must be a positive value and cannot exceed 2592000 seconds (30 days).
    endTimeOffset Number
    The number of seconds into the past to end the query window. Must be a non-negative value and cannot exceed 2592000 seconds (30 days).

    LogAlarmScheduledQueryConfiguration, LogAlarmScheduledQueryConfigurationArgs

    The scheduled query configuration for the log alarm.

    AggregationExpression string
    The aggregation expression for the scheduled query, e.g. count(*) or avg(latency) by host.
    QueryString string
    The query string to execute against the specified log groups.
    ScheduleConfiguration Pulumi.AwsNative.CloudWatch.Inputs.LogAlarmScheduleConfiguration
    The schedule configuration.
    ScheduledQueryRoleArn string
    The ARN of the IAM role that grants permissions to execute the scheduled query.
    LogGroupIdentifiers List<string>
    The log groups to query.
    Tags List<Pulumi.AwsNative.CloudWatch.Inputs.LogAlarmTag>
    A list of key-value pairs to associate with the scheduled query that backs the log alarm.
    AggregationExpression string
    The aggregation expression for the scheduled query, e.g. count(*) or avg(latency) by host.
    QueryString string
    The query string to execute against the specified log groups.
    ScheduleConfiguration LogAlarmScheduleConfiguration
    The schedule configuration.
    ScheduledQueryRoleArn string
    The ARN of the IAM role that grants permissions to execute the scheduled query.
    LogGroupIdentifiers []string
    The log groups to query.
    Tags []LogAlarmTag
    A list of key-value pairs to associate with the scheduled query that backs the log alarm.
    aggregation_expression string
    The aggregation expression for the scheduled query, e.g. count(*) or avg(latency) by host.
    query_string string
    The query string to execute against the specified log groups.
    schedule_configuration object
    The schedule configuration.
    scheduled_query_role_arn string
    The ARN of the IAM role that grants permissions to execute the scheduled query.
    log_group_identifiers list(string)
    The log groups to query.
    tags list(object)
    A list of key-value pairs to associate with the scheduled query that backs the log alarm.
    aggregationExpression String
    The aggregation expression for the scheduled query, e.g. count(*) or avg(latency) by host.
    queryString String
    The query string to execute against the specified log groups.
    scheduleConfiguration LogAlarmScheduleConfiguration
    The schedule configuration.
    scheduledQueryRoleArn String
    The ARN of the IAM role that grants permissions to execute the scheduled query.
    logGroupIdentifiers List<String>
    The log groups to query.
    tags List<LogAlarmTag>
    A list of key-value pairs to associate with the scheduled query that backs the log alarm.
    aggregationExpression string
    The aggregation expression for the scheduled query, e.g. count(*) or avg(latency) by host.
    queryString string
    The query string to execute against the specified log groups.
    scheduleConfiguration LogAlarmScheduleConfiguration
    The schedule configuration.
    scheduledQueryRoleArn string
    The ARN of the IAM role that grants permissions to execute the scheduled query.
    logGroupIdentifiers string[]
    The log groups to query.
    tags LogAlarmTag[]
    A list of key-value pairs to associate with the scheduled query that backs the log alarm.
    aggregation_expression str
    The aggregation expression for the scheduled query, e.g. count(*) or avg(latency) by host.
    query_string str
    The query string to execute against the specified log groups.
    schedule_configuration LogAlarmScheduleConfiguration
    The schedule configuration.
    scheduled_query_role_arn str
    The ARN of the IAM role that grants permissions to execute the scheduled query.
    log_group_identifiers Sequence[str]
    The log groups to query.
    tags Sequence[LogAlarmTag]
    A list of key-value pairs to associate with the scheduled query that backs the log alarm.
    aggregationExpression String
    The aggregation expression for the scheduled query, e.g. count(*) or avg(latency) by host.
    queryString String
    The query string to execute against the specified log groups.
    scheduleConfiguration Property Map
    The schedule configuration.
    scheduledQueryRoleArn String
    The ARN of the IAM role that grants permissions to execute the scheduled query.
    logGroupIdentifiers List<String>
    The log groups to query.
    tags List<Property Map>
    A list of key-value pairs to associate with the scheduled query that backs the log alarm.

    LogAlarmTag, LogAlarmTagArgs

    Metadata that you can assign to a log alarm. Tags can help you organize and categorize your resources.

    Key string
    A unique identifier for the tag. The combination of tag keys and values can help you organize and categorize your resources.
    Value string
    The value for the specified tag key.
    Key string
    A unique identifier for the tag. The combination of tag keys and values can help you organize and categorize your resources.
    Value string
    The value for the specified tag key.
    key string
    A unique identifier for the tag. The combination of tag keys and values can help you organize and categorize your resources.
    value string
    The value for the specified tag key.
    key String
    A unique identifier for the tag. The combination of tag keys and values can help you organize and categorize your resources.
    value String
    The value for the specified tag key.
    key string
    A unique identifier for the tag. The combination of tag keys and values can help you organize and categorize your resources.
    value string
    The value for the specified tag key.
    key str
    A unique identifier for the tag. The combination of tag keys and values can help you organize and categorize your resources.
    value str
    The value for the specified tag key.
    key String
    A unique identifier for the tag. The combination of tag keys and values can help you organize and categorize your resources.
    value String
    The value for the specified tag key.

    LogAlarmWarmUpConfiguration, LogAlarmWarmUpConfigurationArgs

    The warm-up configuration for an alarm. A warm-up period delays alarm evaluation after you create or update the alarm. This reduces alarm noise from missing data while a new resource or service starts up. During the warm-up period, the alarm stays in INSUFFICIENT_DATA and doesn't perform alarm actions.

    OnlyStartEvaluatingAfterWarmUpPeriodEnds bool
    Specifies whether the alarm waits for the full warm-up period before it starts evaluating. If true, the alarm waits the entire WarmUpPeriodDurationInMinutes before it starts evaluating, even if metric data arrives earlier. If false, the alarm ends the warm-up period early and starts evaluating as soon as it has enough metric data to fill its evaluation window. This is the default behavior.
    WarmUpPeriodDurationInMinutes int
    The length of the warm-up period, in minutes. For this duration after you create or update the alarm, the alarm stays in INSUFFICIENT_DATA and doesn't perform alarm actions. Valid values range from 1 to 2,880 minutes (2 days). You can change this value while the alarm is still in its warm-up period. Changes have no effect after the warm-up period ends.
    OnlyStartEvaluatingAfterWarmUpPeriodEnds bool
    Specifies whether the alarm waits for the full warm-up period before it starts evaluating. If true, the alarm waits the entire WarmUpPeriodDurationInMinutes before it starts evaluating, even if metric data arrives earlier. If false, the alarm ends the warm-up period early and starts evaluating as soon as it has enough metric data to fill its evaluation window. This is the default behavior.
    WarmUpPeriodDurationInMinutes int
    The length of the warm-up period, in minutes. For this duration after you create or update the alarm, the alarm stays in INSUFFICIENT_DATA and doesn't perform alarm actions. Valid values range from 1 to 2,880 minutes (2 days). You can change this value while the alarm is still in its warm-up period. Changes have no effect after the warm-up period ends.
    only_start_evaluating_after_warm_up_period_ends bool
    Specifies whether the alarm waits for the full warm-up period before it starts evaluating. If true, the alarm waits the entire WarmUpPeriodDurationInMinutes before it starts evaluating, even if metric data arrives earlier. If false, the alarm ends the warm-up period early and starts evaluating as soon as it has enough metric data to fill its evaluation window. This is the default behavior.
    warm_up_period_duration_in_minutes number
    The length of the warm-up period, in minutes. For this duration after you create or update the alarm, the alarm stays in INSUFFICIENT_DATA and doesn't perform alarm actions. Valid values range from 1 to 2,880 minutes (2 days). You can change this value while the alarm is still in its warm-up period. Changes have no effect after the warm-up period ends.
    onlyStartEvaluatingAfterWarmUpPeriodEnds Boolean
    Specifies whether the alarm waits for the full warm-up period before it starts evaluating. If true, the alarm waits the entire WarmUpPeriodDurationInMinutes before it starts evaluating, even if metric data arrives earlier. If false, the alarm ends the warm-up period early and starts evaluating as soon as it has enough metric data to fill its evaluation window. This is the default behavior.
    warmUpPeriodDurationInMinutes Integer
    The length of the warm-up period, in minutes. For this duration after you create or update the alarm, the alarm stays in INSUFFICIENT_DATA and doesn't perform alarm actions. Valid values range from 1 to 2,880 minutes (2 days). You can change this value while the alarm is still in its warm-up period. Changes have no effect after the warm-up period ends.
    onlyStartEvaluatingAfterWarmUpPeriodEnds boolean
    Specifies whether the alarm waits for the full warm-up period before it starts evaluating. If true, the alarm waits the entire WarmUpPeriodDurationInMinutes before it starts evaluating, even if metric data arrives earlier. If false, the alarm ends the warm-up period early and starts evaluating as soon as it has enough metric data to fill its evaluation window. This is the default behavior.
    warmUpPeriodDurationInMinutes number
    The length of the warm-up period, in minutes. For this duration after you create or update the alarm, the alarm stays in INSUFFICIENT_DATA and doesn't perform alarm actions. Valid values range from 1 to 2,880 minutes (2 days). You can change this value while the alarm is still in its warm-up period. Changes have no effect after the warm-up period ends.
    only_start_evaluating_after_warm_up_period_ends bool
    Specifies whether the alarm waits for the full warm-up period before it starts evaluating. If true, the alarm waits the entire WarmUpPeriodDurationInMinutes before it starts evaluating, even if metric data arrives earlier. If false, the alarm ends the warm-up period early and starts evaluating as soon as it has enough metric data to fill its evaluation window. This is the default behavior.
    warm_up_period_duration_in_minutes int
    The length of the warm-up period, in minutes. For this duration after you create or update the alarm, the alarm stays in INSUFFICIENT_DATA and doesn't perform alarm actions. Valid values range from 1 to 2,880 minutes (2 days). You can change this value while the alarm is still in its warm-up period. Changes have no effect after the warm-up period ends.
    onlyStartEvaluatingAfterWarmUpPeriodEnds Boolean
    Specifies whether the alarm waits for the full warm-up period before it starts evaluating. If true, the alarm waits the entire WarmUpPeriodDurationInMinutes before it starts evaluating, even if metric data arrives earlier. If false, the alarm ends the warm-up period early and starts evaluating as soon as it has enough metric data to fill its evaluation window. This is the default behavior.
    warmUpPeriodDurationInMinutes Number
    The length of the warm-up period, in minutes. For this duration after you create or update the alarm, the alarm stays in INSUFFICIENT_DATA and doesn't perform alarm actions. Valid values range from 1 to 2,880 minutes (2 days). You can change this value while the alarm is still in its warm-up period. Changes have no effect after the warm-up period ends.

    Tag, TagArgs

    A set of tags to apply to the resource.

    Key string
    The key name of the tag
    Value string
    The value of the tag
    Key string
    The key name of the tag
    Value string
    The value of the tag
    key string
    The key name of the tag
    value string
    The value of the tag
    key String
    The key name of the tag
    value String
    The value of the tag
    key string
    The key name of the tag
    value string
    The value of the tag
    key str
    The key name of the tag
    value str
    The value of the tag
    key String
    The key name of the tag
    value String
    The value of the tag

    Package Details

    Repository
    AWS Native pulumi/pulumi-aws-native
    License
    Apache-2.0
    aws-native logo aws-native logo AWS Cloud Control

    We recommend new projects start with resources from the AWS provider.

    Viewing docs for AWS Cloud Control v1.86.0
    published on Wednesday, Nov 18, 2026 by Pulumi

      Try Pulumi Cloud free.
      Your team will thank you.

      Start free trial