A RetroSearch Logo

Home - News ( United States | United Kingdom | Italy | Germany ) - Football scores

Search Query:

Showing content from https://docs.aws.amazon.com/sdkforruby/api/Aws/CloudWatch/Alarm.html below:

Alarm — AWS SDK for Ruby V2

You are viewing documentation for version 2 of the AWS SDK for Ruby. Version 3 documentation can be found here.

Class: Aws::CloudWatch::Alarm Instance Attribute Summary collapse Attributes inherited from Resources::Resource

#client, #identifiers

Instance Method Summary collapse Methods inherited from Resources::Resource

add_data_attribute, add_identifier, #data, data_attributes, #data_loaded?, identifiers, #load, #wait_until

Methods included from Resources::OperationMethods

#add_batch_operation, #add_operation, #batch_operation, #batch_operation_names, #batch_operations, #operation, #operation_names, #operations

Constructor Details #initialize(name, options = {}) ⇒ Object #initialize(options = {}) ⇒ Object Instance Attribute Details #actions_enabled ⇒ Boolean

Indicates whether actions should be executed during any changes to the alarm state.

#alarm_actions ⇒ Array<String>

The actions to execute when this alarm transitions to the ALARM state from any other state. Each action is specified as an Amazon Resource Name (ARN).

#alarm_arn ⇒ String

The Amazon Resource Name (ARN) of the alarm.

#alarm_configuration_updated_timestamp ⇒ Time

The time stamp of the last update to the alarm configuration.

#alarm_description ⇒ String

The description of the alarm.

#comparison_operator ⇒ String

The arithmetic operation to use when comparing the specified statistic and threshold. The specified statistic value is used as the first operand.

Possible values:

#datapoints_to_alarm ⇒ Integer

The number of data points that must be breaching to trigger the alarm.

#dimensions ⇒ Array<Types::Dimension>

The dimensions for the metric associated with the alarm.

#evaluate_low_sample_count_percentile ⇒ String

Used only for alarms based on percentiles. If ignore, the alarm state does not change during periods with too few data points to be statistically significant. If evaluate or this parameter is not used, the alarm is always evaluated and possibly changes state no matter how many data points are available.

#evaluation_periods ⇒ Integer

The number of periods over which data is compared to the specified threshold.

#extended_statistic ⇒ String

The percentile statistic for the metric associated with the alarm. Specify a value between p0.0 and p100.

#insufficient_data_actions ⇒ Array<String>

The actions to execute when this alarm transitions to the INSUFFICIENT_DATA state from any other state. Each action is specified as an Amazon Resource Name (ARN).

#metric_name ⇒ String

The name of the metric associated with the alarm, if this is an alarm based on a single metric.

#metrics ⇒ Array<Types::MetricDataQuery>

An array of MetricDataQuery structures, used in an alarm based on a metric math expression. Each structure either retrieves a metric or performs a math expression. One item in the Metrics array is the math expression that the alarm watches. This expression by designated by having ReturnData set to true.

#namespace ⇒ String

The namespace of the metric associated with the alarm.

#ok_actions ⇒ Array<String>

The actions to execute when this alarm transitions to the OK state from any other state. Each action is specified as an Amazon Resource Name (ARN).

#period ⇒ Integer

The period, in seconds, over which the statistic is applied.

#state_reason ⇒ String

An explanation for the alarm state, in text format.

#state_reason_data ⇒ String

An explanation for the alarm state, in JSON format.

#state_updated_timestamp ⇒ Time

The time stamp of the last update to the alarm state.

#state_value ⇒ String

The state value for the alarm.

Possible values:

#statistic ⇒ String

The statistic for the metric associated with the alarm, other than percentile. For percentile statistics, use ExtendedStatistic.

Possible values:

#threshold ⇒ Float

The value to compare with the specified statistic.

#threshold_metric_id ⇒ String

In an alarm based on an anomaly detection model, this is the ID of the ANOMALY_DETECTION_BAND function used as the threshold for the alarm.

#treat_missing_data ⇒ String

Sets how this alarm is to handle missing data points. If this parameter is omitted, the default behavior of missing is used.

#unit ⇒ String

The unit of the metric associated with the alarm.

Possible values:

Instance Method Details #delete ⇒ Struct

Deletes the specified alarms. You can delete up to 100 alarms in one operation. However, this total can include no more than one composite alarm. For example, you could delete 99 metric alarms and one composite alarms with one operation, but you can't delete two composite alarms with one operation.

In the event of an error, no alarms are deleted.

It is possible to create a loop or cycle of composite alarms, where composite alarm A depends on composite alarm B, and composite alarm B also depends on composite alarm A. In this scenario, you can't delete any composite alarm that is part of the cycle because there is always still a composite alarm that depends on that alarm that you want to delete.

To get out of such a situation, you must break the cycle by changing the rule of one of the composite alarms in the cycle to remove a dependency that creates the cycle. The simplest change to make to break a cycle is to change the AlarmRule of one of the alarms to False.

Additionally, the evaluation of composite alarms stops if CloudWatch detects a cycle in the evaluation path.

#describe_history(options = {}) ⇒ Types::DescribeAlarmHistoryOutput

Retrieves the history for the specified alarm. You can filter the results by date range or item type. If an alarm name is not specified, the histories for either all metric alarms or all composite alarms are returned.

CloudWatch retains the history of an alarm even if you delete the alarm.

#disable_actions ⇒ Struct

Disables the actions for the specified alarms. When an alarm's actions are disabled, the alarm actions do not execute when the alarm state changes.

#enable_actions ⇒ Struct

Enables the actions for the specified alarms.

#exists? ⇒ Boolean

Returns true if this Alarm exists. Returns false otherwise.

#set_state(options = {}) ⇒ Struct

Temporarily sets the state of an alarm for testing purposes. When the updated state differs from the previous value, the action configured for the appropriate state is invoked. For example, if your alarm is configured to send an Amazon SNS message when an alarm is triggered, temporarily changing the alarm state to ALARM sends an SNS message.

Metric alarms returns to their actual state quickly, often within seconds. Because the metric alarm state change happens quickly, it is typically only visible in the alarm's History tab in the Amazon CloudWatch console or through DescribeAlarmHistory.

If you use SetAlarmState on a composite alarm, the composite alarm is not guaranteed to return to its actual state. It returns to its actual state only once any of its children alarms change state. It is also reevaluated if you update its configuration.

If an alarm triggers EC2 Auto Scaling policies or application Auto Scaling policies, you must include information in the StateReasonData parameter to enable the policy to take the correct action.

#wait_until_exists {|waiter| ... } ⇒ Alarm

Waits until this Alarm is exists. This method waits by polling Client#describe_alarms until successful. An error is raised after a configurable number of failed checks.

This waiter uses the following defaults:

Configuration Default #delay 5 #max_attempts 40

You can modify defaults and register callbacks by passing a block argument.

RetroSearch is an open source project built by @garambo | Open a GitHub Issue

Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo

HTML: 3.2 | Encoding: UTF-8 | Version: 0.7.4