Class: Aws::CloudWatch::Client

resp = client.delete_anomaly_detector({
  namespace: "Namespace",
  metric_name: "MetricName",
  dimensions: [
    {
      name: "DimensionName", # required
      value: "DimensionValue", # required
    },
  ],
  stat: "AnomalyDetectorMetricStat",
  single_metric_anomaly_detector: {
    account_id: "AccountId",
    namespace: "Namespace",
    metric_name: "MetricName",
    dimensions: [
      {
        name: "DimensionName", # required
        value: "DimensionValue", # required
      },
    ],
    stat: "AnomalyDetectorMetricStat",
  },
  metric_math_anomaly_detector: {
    metric_data_queries: [
      {
        id: "MetricId", # required
        metric_stat: {
          metric: { # required
            namespace: "Namespace",
            metric_name: "MetricName",
            dimensions: [
              {
                name: "DimensionName", # required
                value: "DimensionValue", # required
              },
            ],
          },
          period: 1, # required
          stat: "Stat", # required
          unit: "Seconds", # accepts Seconds, Microseconds, Milliseconds, Bytes, Kilobytes, Megabytes, Gigabytes, Terabytes, Bits, Kilobits, Megabits, Gigabits, Terabits, Percent, Count, Bytes/Second, Kilobytes/Second, Megabytes/Second, Gigabytes/Second, Terabytes/Second, Bits/Second, Kilobits/Second, Megabits/Second, Gigabits/Second, Terabits/Second, Count/Second, None
        },
        expression: "MetricExpression",
        label: "MetricLabel",
        return_data: false,
        period: 1,
        account_id: "AccountId",
      },
    ],
  },
})

Parameters:

• params (Hash) (defaults to: {}) —

  ({})

Options Hash (params):

• :namespace (String) —

  The namespace associated with the anomaly detection model to delete.

• :metric_name (String) —

  The metric name associated with the anomaly detection model to delete.

• :dimensions (Array<Types::Dimension>) —

  The metric dimensions associated with the anomaly detection model to delete.

• :stat (String) —

  The statistic associated with the anomaly detection model to delete.

• :single_metric_anomaly_detector (Types::SingleMetricAnomalyDetector) —

  A single metric anomaly detector to be deleted.

  When using SingleMetricAnomalyDetector, you cannot include the following parameters in the same operation:

  • Dimensions,

  • MetricName

  • Namespace

  • Stat

  • the MetricMathAnomalyDetector parameters of DeleteAnomalyDetectorInput

  Instead, specify the single metric anomaly detector attributes as part of the SingleMetricAnomalyDetector property.

• :metric_math_anomaly_detector (Types::MetricMathAnomalyDetector) —

  The metric math anomaly detector to be deleted.

  When using MetricMathAnomalyDetector, you cannot include following parameters in the same operation:

  • Dimensions,

  • MetricName

  • Namespace

  • Stat

  • the SingleMetricAnomalyDetector parameters of DeleteAnomalyDetectorInput

  Instead, specify the metric math anomaly detector attributes as part of the MetricMathAnomalyDetector property.

Returns:

• (Struct) —

  Returns an empty response.

See Also:

• AWS API Documentation

resp = client.delete_dashboards({
  dashboard_names: ["DashboardName"], # required
})

Parameters:

• params (Hash) (defaults to: {}) —

  ({})

Options Hash (params):

• :dashboard_names (required, Array<String>) —

  The dashboards to be deleted. This parameter is required.

Returns:

• (Struct) —

  Returns an empty response.

See Also:

• AWS API Documentation

resp = client.delete_insight_rules({
  rule_names: ["InsightRuleName"], # required
})

resp.failures #=> Array
resp.failures[0].failure_resource #=> String
resp.failures[0].exception_type #=> String
resp.failures[0].failure_code #=> String
resp.failures[0].failure_description #=> String

Parameters:

• params (Hash) (defaults to: {}) —

  ({})

Options Hash (params):

• :rule_names (required, Array<String>) —

  An array of the rule names to delete. If you need to find out the names of your rules, use DescribeInsightRules.

Returns:

• (Types::DeleteInsightRulesOutput) —

  Returns a response object which responds to the following methods:

  • #failures => Array<Types::PartialFailure>

See Also:

• AWS API Documentation

resp = client.delete_metric_stream({
  name: "MetricStreamName", # required
})

Parameters:

• params (Hash) (defaults to: {}) —

  ({})

Options Hash (params):

• :name (required, String) —

  The name of the metric stream to delete.

Returns:

• (Struct) —

  Returns an empty response.

See Also:

• AWS API Documentation

resp = client.describe_alarm_history({
  alarm_name: "AlarmName",
  alarm_types: ["CompositeAlarm"], # accepts CompositeAlarm, MetricAlarm
  history_item_type: "ConfigurationUpdate", # accepts ConfigurationUpdate, StateUpdate, Action
  start_date: Time.now,
  end_date: Time.now,
  max_records: 1,
  next_token: "NextToken",
  scan_by: "TimestampDescending", # accepts TimestampDescending, TimestampAscending
})

resp.alarm_history_items #=> Array
resp.alarm_history_items[0].alarm_name #=> String
resp.alarm_history_items[0].alarm_type #=> String, one of "CompositeAlarm", "MetricAlarm"
resp.alarm_history_items[0].timestamp #=> Time
resp.alarm_history_items[0].history_item_type #=> String, one of "ConfigurationUpdate", "StateUpdate", "Action"
resp.alarm_history_items[0].history_summary #=> String
resp.alarm_history_items[0].history_data #=> String
resp.next_token #=> String

Parameters:

• params (Hash) (defaults to: {}) —

  ({})

Options Hash (params):

• :alarm_name (String) —

  The name of the alarm.

• :alarm_types (Array<String>) —

  Use this parameter to specify whether you want the operation to return metric alarms or composite alarms. If you omit this parameter, only metric alarms are returned.

• :history_item_type (String) —

  The type of alarm histories to retrieve.

• :start_date (Time, DateTime, Date, Integer, String) —

  The starting date to retrieve alarm history.

• :end_date (Time, DateTime, Date, Integer, String) —

  The ending date to retrieve alarm history.

• :max_records (Integer) —

  The maximum number of alarm history records to retrieve.

• :next_token (String) —

  The token returned by a previous call to indicate that there is more data available.

• :scan_by (String) —

  Specified whether to return the newest or oldest alarm history first. Specify TimestampDescending to have the newest event history returned first, and specify TimestampAscending to have the oldest history returned first.

Returns:

• (Types::DescribeAlarmHistoryOutput) —

  Returns a response object which responds to the following methods:

  • #alarm_history_items => Array<Types::AlarmHistoryItem>
  • #next_token => String

See Also:

• AWS API Documentation

resp = client.describe_alarms({
  alarm_names: ["AlarmName"],
  alarm_name_prefix: "AlarmNamePrefix",
  alarm_types: ["CompositeAlarm"], # accepts CompositeAlarm, MetricAlarm
  children_of_alarm_name: "AlarmName",
  parents_of_alarm_name: "AlarmName",
  state_value: "OK", # accepts OK, ALARM, INSUFFICIENT_DATA
  action_prefix: "ActionPrefix",
  max_records: 1,
  next_token: "NextToken",
})

resp.composite_alarms #=> Array
resp.composite_alarms[0].actions_enabled #=> Boolean
resp.composite_alarms[0].alarm_actions #=> Array
resp.composite_alarms[0].alarm_actions[0] #=> String
resp.composite_alarms[0].alarm_arn #=> String
resp.composite_alarms[0].alarm_configuration_updated_timestamp #=> Time
resp.composite_alarms[0].alarm_description #=> String
resp.composite_alarms[0].alarm_name #=> String
resp.composite_alarms[0].alarm_rule #=> String
resp.composite_alarms[0].insufficient_data_actions #=> Array
resp.composite_alarms[0].insufficient_data_actions[0] #=> String
resp.composite_alarms[0].ok_actions #=> Array
resp.composite_alarms[0].ok_actions[0] #=> String
resp.composite_alarms[0].state_reason #=> String
resp.composite_alarms[0].state_reason_data #=> String
resp.composite_alarms[0].state_updated_timestamp #=> Time
resp.composite_alarms[0].state_value #=> String, one of "OK", "ALARM", "INSUFFICIENT_DATA"
resp.composite_alarms[0].state_transitioned_timestamp #=> Time
resp.composite_alarms[0].actions_suppressed_by #=> String, one of "WaitPeriod", "ExtensionPeriod", "Alarm"
resp.composite_alarms[0].actions_suppressed_reason #=> String
resp.composite_alarms[0].actions_suppressor #=> String
resp.composite_alarms[0].actions_suppressor_wait_period #=> Integer
resp.composite_alarms[0].actions_suppressor_extension_period #=> Integer
resp.metric_alarms #=> Array
resp.metric_alarms[0].alarm_name #=> String
resp.metric_alarms[0].alarm_arn #=> String
resp.metric_alarms[0].alarm_description #=> String
resp.metric_alarms[0].alarm_configuration_updated_timestamp #=> Time
resp.metric_alarms[0].actions_enabled #=> Boolean
resp.metric_alarms[0].ok_actions #=> Array
resp.metric_alarms[0].ok_actions[0] #=> String
resp.metric_alarms[0].alarm_actions #=> Array
resp.metric_alarms[0].alarm_actions[0] #=> String
resp.metric_alarms[0].insufficient_data_actions #=> Array
resp.metric_alarms[0].insufficient_data_actions[0] #=> String
resp.metric_alarms[0].state_value #=> String, one of "OK", "ALARM", "INSUFFICIENT_DATA"
resp.metric_alarms[0].state_reason #=> String
resp.metric_alarms[0].state_reason_data #=> String
resp.metric_alarms[0].state_updated_timestamp #=> Time
resp.metric_alarms[0].metric_name #=> String
resp.metric_alarms[0].namespace #=> String
resp.metric_alarms[0].statistic #=> String, one of "SampleCount", "Average", "Sum", "Minimum", "Maximum"
resp.metric_alarms[0].extended_statistic #=> String
resp.metric_alarms[0].dimensions #=> Array
resp.metric_alarms[0].dimensions[0].name #=> String
resp.metric_alarms[0].dimensions[0].value #=> String
resp.metric_alarms[0].period #=> Integer
resp.metric_alarms[0].unit #=> String, one of "Seconds", "Microseconds", "Milliseconds", "Bytes", "Kilobytes", "Megabytes", "Gigabytes", "Terabytes", "Bits", "Kilobits", "Megabits", "Gigabits", "Terabits", "Percent", "Count", "Bytes/Second", "Kilobytes/Second", "Megabytes/Second", "Gigabytes/Second", "Terabytes/Second", "Bits/Second", "Kilobits/Second", "Megabits/Second", "Gigabits/Second", "Terabits/Second", "Count/Second", "None"
resp.metric_alarms[0].evaluation_periods #=> Integer
resp.metric_alarms[0].datapoints_to_alarm #=> Integer
resp.metric_alarms[0].threshold #=> Float
resp.metric_alarms[0].comparison_operator #=> String, one of "GreaterThanOrEqualToThreshold", "GreaterThanThreshold", "LessThanThreshold", "LessThanOrEqualToThreshold", "LessThanLowerOrGreaterThanUpperThreshold", "LessThanLowerThreshold", "GreaterThanUpperThreshold"
resp.metric_alarms[0].treat_missing_data #=> String
resp.metric_alarms[0].evaluate_low_sample_count_percentile #=> String
resp.metric_alarms[0].metrics #=> Array
resp.metric_alarms[0].metrics[0].id #=> String
resp.metric_alarms[0].metrics[0].metric_stat.metric.namespace #=> String
resp.metric_alarms[0].metrics[0].metric_stat.metric.metric_name #=> String
resp.metric_alarms[0].metrics[0].metric_stat.metric.dimensions #=> Array
resp.metric_alarms[0].metrics[0].metric_stat.metric.dimensions[0].name #=> String
resp.metric_alarms[0].metrics[0].metric_stat.metric.dimensions[0].value #=> String
resp.metric_alarms[0].metrics[0].metric_stat.period #=> Integer
resp.metric_alarms[0].metrics[0].metric_stat.stat #=> String
resp.metric_alarms[0].metrics[0].metric_stat.unit #=> String, one of "Seconds", "Microseconds", "Milliseconds", "Bytes", "Kilobytes", "Megabytes", "Gigabytes", "Terabytes", "Bits", "Kilobits", "Megabits", "Gigabits", "Terabits", "Percent", "Count", "Bytes/Second", "Kilobytes/Second", "Megabytes/Second", "Gigabytes/Second", "Terabytes/Second", "Bits/Second", "Kilobits/Second", "Megabits/Second", "Gigabits/Second", "Terabits/Second", "Count/Second", "None"
resp.metric_alarms[0].metrics[0].expression #=> String
resp.metric_alarms[0].metrics[0].label #=> String
resp.metric_alarms[0].metrics[0].return_data #=> Boolean
resp.metric_alarms[0].metrics[0].period #=> Integer
resp.metric_alarms[0].metrics[0].account_id #=> String
resp.metric_alarms[0].threshold_metric_id #=> String
resp.metric_alarms[0].evaluation_state #=> String, one of "PARTIAL_DATA"
resp.metric_alarms[0].state_transitioned_timestamp #=> Time
resp.next_token #=> String

Parameters:

• params (Hash) (defaults to: {}) —

  ({})

Options Hash (params):

• :alarm_names (Array<String>) —

  The names of the alarms to retrieve information about.

• :alarm_name_prefix (String) —

  An alarm name prefix. If you specify this parameter, you receive information about all alarms that have names that start with this prefix.

  If this parameter is specified, you cannot specify AlarmNames.

• :alarm_types (Array<String>) —

  Use this parameter to specify whether you want the operation to return metric alarms or composite alarms. If you omit this parameter, only metric alarms are returned, even if composite alarms exist in the account.

  For example, if you omit this parameter or specify MetricAlarms, the operation returns only a list of metric alarms. It does not return any composite alarms, even if composite alarms exist in the account.

  If you specify CompositeAlarms, the operation returns only a list of composite alarms, and does not return any metric alarms.

• :children_of_alarm_name (String) —

  If you use this parameter and specify the name of a composite alarm, the operation returns information about the "children" alarms of the alarm you specify. These are the metric alarms and composite alarms referenced in the AlarmRule field of the composite alarm that you specify in ChildrenOfAlarmName. Information about the composite alarm that you name in ChildrenOfAlarmName is not returned.

  If you specify ChildrenOfAlarmName, you cannot specify any other parameters in the request except for MaxRecords and NextToken. If you do so, you receive a validation error.

  Only the Alarm Name, ARN, StateValue (OK/ALARM/INSUFFICIENT_DATA), and StateUpdatedTimestamp information are returned by this operation when you use this parameter. To get complete information about these alarms, perform another DescribeAlarms operation and specify the parent alarm names in the AlarmNames parameter.

• :parents_of_alarm_name (String) —

  If you use this parameter and specify the name of a metric or composite alarm, the operation returns information about the "parent" alarms of the alarm you specify. These are the composite alarms that have AlarmRule parameters that reference the alarm named in ParentsOfAlarmName. Information about the alarm that you specify in ParentsOfAlarmName is not returned.

  If you specify ParentsOfAlarmName, you cannot specify any other parameters in the request except for MaxRecords and NextToken. If you do so, you receive a validation error.

  Only the Alarm Name and ARN are returned by this operation when you use this parameter. To get complete information about these alarms, perform another DescribeAlarms operation and specify the parent alarm names in the AlarmNames parameter.

• :state_value (String) —

  Specify this parameter to receive information only about alarms that are currently in the state that you specify.

• :action_prefix (String) —

  Use this parameter to filter the results of the operation to only those alarms that use a certain alarm action. For example, you could specify the ARN of an SNS topic to find all alarms that send notifications to that topic.

• :max_records (Integer) —

  The maximum number of alarm descriptions to retrieve.

• :next_token (String) —

  The token returned by a previous call to indicate that there is more data available.

Returns:

• (Types::DescribeAlarmsOutput) —

  Returns a response object which responds to the following methods:

  • #composite_alarms => Array<Types::CompositeAlarm>
  • #metric_alarms => Array<Types::MetricAlarm>
  • #next_token => String

See Also:

• AWS API Documentation

resp = client.describe_alarms_for_metric({
  metric_name: "MetricName", # required
  namespace: "Namespace", # required
  statistic: "SampleCount", # accepts SampleCount, Average, Sum, Minimum, Maximum
  extended_statistic: "ExtendedStatistic",
  dimensions: [
    {
      name: "DimensionName", # required
      value: "DimensionValue", # required
    },
  ],
  period: 1,
  unit: "Seconds", # accepts Seconds, Microseconds, Milliseconds, Bytes, Kilobytes, Megabytes, Gigabytes, Terabytes, Bits, Kilobits, Megabits, Gigabits, Terabits, Percent, Count, Bytes/Second, Kilobytes/Second, Megabytes/Second, Gigabytes/Second, Terabytes/Second, Bits/Second, Kilobits/Second, Megabits/Second, Gigabits/Second, Terabits/Second, Count/Second, None
})

resp.metric_alarms #=> Array
resp.metric_alarms[0].alarm_name #=> String
resp.metric_alarms[0].alarm_arn #=> String
resp.metric_alarms[0].alarm_description #=> String
resp.metric_alarms[0].alarm_configuration_updated_timestamp #=> Time
resp.metric_alarms[0].actions_enabled #=> Boolean
resp.metric_alarms[0].ok_actions #=> Array
resp.metric_alarms[0].ok_actions[0] #=> String
resp.metric_alarms[0].alarm_actions #=> Array
resp.metric_alarms[0].alarm_actions[0] #=> String
resp.metric_alarms[0].insufficient_data_actions #=> Array
resp.metric_alarms[0].insufficient_data_actions[0] #=> String
resp.metric_alarms[0].state_value #=> String, one of "OK", "ALARM", "INSUFFICIENT_DATA"
resp.metric_alarms[0].state_reason #=> String
resp.metric_alarms[0].state_reason_data #=> String
resp.metric_alarms[0].state_updated_timestamp #=> Time
resp.metric_alarms[0].metric_name #=> String
resp.metric_alarms[0].namespace #=> String
resp.metric_alarms[0].statistic #=> String, one of "SampleCount", "Average", "Sum", "Minimum", "Maximum"
resp.metric_alarms[0].extended_statistic #=> String
resp.metric_alarms[0].dimensions #=> Array
resp.metric_alarms[0].dimensions[0].name #=> String
resp.metric_alarms[0].dimensions[0].value #=> String
resp.metric_alarms[0].period #=> Integer
resp.metric_alarms[0].unit #=> String, one of "Seconds", "Microseconds", "Milliseconds", "Bytes", "Kilobytes", "Megabytes", "Gigabytes", "Terabytes", "Bits", "Kilobits", "Megabits", "Gigabits", "Terabits", "Percent", "Count", "Bytes/Second", "Kilobytes/Second", "Megabytes/Second", "Gigabytes/Second", "Terabytes/Second", "Bits/Second", "Kilobits/Second", "Megabits/Second", "Gigabits/Second", "Terabits/Second", "Count/Second", "None"
resp.metric_alarms[0].evaluation_periods #=> Integer
resp.metric_alarms[0].datapoints_to_alarm #=> Integer
resp.metric_alarms[0].threshold #=> Float
resp.metric_alarms[0].comparison_operator #=> String, one of "GreaterThanOrEqualToThreshold", "GreaterThanThreshold", "LessThanThreshold", "LessThanOrEqualToThreshold", "LessThanLowerOrGreaterThanUpperThreshold", "LessThanLowerThreshold", "GreaterThanUpperThreshold"
resp.metric_alarms[0].treat_missing_data #=> String
resp.metric_alarms[0].evaluate_low_sample_count_percentile #=> String
resp.metric_alarms[0].metrics #=> Array
resp.metric_alarms[0].metrics[0].id #=> String
resp.metric_alarms[0].metrics[0].metric_stat.metric.namespace #=> String
resp.metric_alarms[0].metrics[0].metric_stat.metric.metric_name #=> String
resp.metric_alarms[0].metrics[0].metric_stat.metric.dimensions #=> Array
resp.metric_alarms[0].metrics[0].metric_stat.metric.dimensions[0].name #=> String
resp.metric_alarms[0].metrics[0].metric_stat.metric.dimensions[0].value #=> String
resp.metric_alarms[0].metrics[0].metric_stat.period #=> Integer
resp.metric_alarms[0].metrics[0].metric_stat.stat #=> String
resp.metric_alarms[0].metrics[0].metric_stat.unit #=> String, one of "Seconds", "Microseconds", "Milliseconds", "Bytes", "Kilobytes", "Megabytes", "Gigabytes", "Terabytes", "Bits", "Kilobits", "Megabits", "Gigabits", "Terabits", "Percent", "Count", "Bytes/Second", "Kilobytes/Second", "Megabytes/Second", "Gigabytes/Second", "Terabytes/Second", "Bits/Second", "Kilobits/Second", "Megabits/Second", "Gigabits/Second", "Terabits/Second", "Count/Second", "None"
resp.metric_alarms[0].metrics[0].expression #=> String
resp.metric_alarms[0].metrics[0].label #=> String
resp.metric_alarms[0].metrics[0].return_data #=> Boolean
resp.metric_alarms[0].metrics[0].period #=> Integer
resp.metric_alarms[0].metrics[0].account_id #=> String
resp.metric_alarms[0].threshold_metric_id #=> String
resp.metric_alarms[0].evaluation_state #=> String, one of "PARTIAL_DATA"
resp.metric_alarms[0].state_transitioned_timestamp #=> Time

Parameters:

• params (Hash) (defaults to: {}) —

  ({})

Options Hash (params):

• :metric_name (required, String) —

  The name of the metric.

• :namespace (required, String) —

  The namespace of the metric.

• :statistic (String) —

  The statistic for the metric, other than percentiles. For percentile statistics, use ExtendedStatistics.

• :extended_statistic (String) —

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

• :dimensions (Array<Types::Dimension>) —

  The dimensions associated with the metric. If the metric has any associated dimensions, you must specify them in order for the call to succeed.

• :period (Integer) —

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

• :unit (String) —

  The unit for the metric.

Returns:

• (Types::DescribeAlarmsForMetricOutput) —

  Returns a response object which responds to the following methods:

  • #metric_alarms => Array<Types::MetricAlarm>

See Also:

• AWS API Documentation

resp = client.describe_anomaly_detectors({
  next_token: "NextToken",
  max_results: 1,
  namespace: "Namespace",
  metric_name: "MetricName",
  dimensions: [
    {
      name: "DimensionName", # required
      value: "DimensionValue", # required
    },
  ],
  anomaly_detector_types: ["SINGLE_METRIC"], # accepts SINGLE_METRIC, METRIC_MATH
})

resp.anomaly_detectors #=> Array
resp.anomaly_detectors[0].namespace #=> String
resp.anomaly_detectors[0].metric_name #=> String
resp.anomaly_detectors[0].dimensions #=> Array
resp.anomaly_detectors[0].dimensions[0].name #=> String
resp.anomaly_detectors[0].dimensions[0].value #=> String
resp.anomaly_detectors[0].stat #=> String
resp.anomaly_detectors[0].configuration.excluded_time_ranges #=> Array
resp.anomaly_detectors[0].configuration.excluded_time_ranges[0].start_time #=> Time
resp.anomaly_detectors[0].configuration.excluded_time_ranges[0].end_time #=> Time
resp.anomaly_detectors[0].configuration.metric_timezone #=> String
resp.anomaly_detectors[0].state_value #=> String, one of "PENDING_TRAINING", "TRAINED_INSUFFICIENT_DATA", "TRAINED"
resp.anomaly_detectors[0].metric_characteristics.periodic_spikes #=> Boolean
resp.anomaly_detectors[0].single_metric_anomaly_detector.account_id #=> String
resp.anomaly_detectors[0].single_metric_anomaly_detector.namespace #=> String
resp.anomaly_detectors[0].single_metric_anomaly_detector.metric_name #=> String
resp.anomaly_detectors[0].single_metric_anomaly_detector.dimensions #=> Array
resp.anomaly_detectors[0].single_metric_anomaly_detector.dimensions[0].name #=> String
resp.anomaly_detectors[0].single_metric_anomaly_detector.dimensions[0].value #=> String
resp.anomaly_detectors[0].single_metric_anomaly_detector.stat #=> String
resp.anomaly_detectors[0].metric_math_anomaly_detector.metric_data_queries #=> Array
resp.anomaly_detectors[0].metric_math_anomaly_detector.metric_data_queries[0].id #=> String
resp.anomaly_detectors[0].metric_math_anomaly_detector.metric_data_queries[0].metric_stat.metric.namespace #=> String
resp.anomaly_detectors[0].metric_math_anomaly_detector.metric_data_queries[0].metric_stat.metric.metric_name #=> String
resp.anomaly_detectors[0].metric_math_anomaly_detector.metric_data_queries[0].metric_stat.metric.dimensions #=> Array
resp.anomaly_detectors[0].metric_math_anomaly_detector.metric_data_queries[0].metric_stat.metric.dimensions[0].name #=> String
resp.anomaly_detectors[0].metric_math_anomaly_detector.metric_data_queries[0].metric_stat.metric.dimensions[0].value #=> String
resp.anomaly_detectors[0].metric_math_anomaly_detector.metric_data_queries[0].metric_stat.period #=> Integer
resp.anomaly_detectors[0].metric_math_anomaly_detector.metric_data_queries[0].metric_stat.stat #=> String
resp.anomaly_detectors[0].metric_math_anomaly_detector.metric_data_queries[0].metric_stat.unit #=> String, one of "Seconds", "Microseconds", "Milliseconds", "Bytes", "Kilobytes", "Megabytes", "Gigabytes", "Terabytes", "Bits", "Kilobits", "Megabits", "Gigabits", "Terabits", "Percent", "Count", "Bytes/Second", "Kilobytes/Second", "Megabytes/Second", "Gigabytes/Second", "Terabytes/Second", "Bits/Second", "Kilobits/Second", "Megabits/Second", "Gigabits/Second", "Terabits/Second", "Count/Second", "None"
resp.anomaly_detectors[0].metric_math_anomaly_detector.metric_data_queries[0].expression #=> String
resp.anomaly_detectors[0].metric_math_anomaly_detector.metric_data_queries[0].label #=> String
resp.anomaly_detectors[0].metric_math_anomaly_detector.metric_data_queries[0].return_data #=> Boolean
resp.anomaly_detectors[0].metric_math_anomaly_detector.metric_data_queries[0].period #=> Integer
resp.anomaly_detectors[0].metric_math_anomaly_detector.metric_data_queries[0].account_id #=> String
resp.next_token #=> String

Parameters:

• params (Hash) (defaults to: {}) —

  ({})

Options Hash (params):

• :next_token (String) —

  Use the token returned by the previous operation to request the next page of results.

• :max_results (Integer) —

  The maximum number of results to return in one operation. The maximum value that you can specify is 100.

  To retrieve the remaining results, make another call with the returned NextToken value.

• :namespace (String) —

  Limits the results to only the anomaly detection models that are associated with the specified namespace.

• :metric_name (String) —

  Limits the results to only the anomaly detection models that are associated with the specified metric name. If there are multiple metrics with this name in different namespaces that have anomaly detection models, they're all returned.

• :dimensions (Array<Types::Dimension>) —

  Limits the results to only the anomaly detection models that are associated with the specified metric dimensions. If there are multiple metrics that have these dimensions and have anomaly detection models associated, they're all returned.

• :anomaly_detector_types (Array<String>) —

  The anomaly detector types to request when using DescribeAnomalyDetectorsInput. If empty, defaults to SINGLE_METRIC.

Returns:

• (Types::DescribeAnomalyDetectorsOutput) —

  Returns a response object which responds to the following methods:

  • #anomaly_detectors => Array<Types::AnomalyDetector>
  • #next_token => String

See Also:

• AWS API Documentation

resp = client.describe_insight_rules({
  next_token: "NextToken",
  max_results: 1,
})

resp.next_token #=> String
resp.insight_rules #=> Array
resp.insight_rules[0].name #=> String
resp.insight_rules[0].state #=> String
resp.insight_rules[0].schema #=> String
resp.insight_rules[0].definition #=> String
resp.insight_rules[0].managed_rule #=> Boolean
resp.insight_rules[0].apply_on_transformed_logs #=> Boolean

Parameters:

• params (Hash) (defaults to: {}) —

  ({})

Options Hash (params):

• :next_token (String) —

  Include this value, if it was returned by the previous operation, to get the next set of rules.

• :max_results (Integer) —

  The maximum number of results to return in one operation. If you omit this parameter, the default of 500 is used.

Returns:

• (Types::DescribeInsightRulesOutput) —

  Returns a response object which responds to the following methods:

  • #next_token => String
  • #insight_rules => Array<Types::InsightRule>

See Also:

• AWS API Documentation

resp = client.disable_alarm_actions({
  alarm_names: ["AlarmName"], # required
})

Parameters:

• params (Hash) (defaults to: {}) —

  ({})

Options Hash (params):

• :alarm_names (required, Array<String>) —

  The names of the alarms.

Returns:

• (Struct) —

  Returns an empty response.

See Also:

• AWS API Documentation

resp = client.disable_insight_rules({
  rule_names: ["InsightRuleName"], # required
})

resp.failures #=> Array
resp.failures[0].failure_resource #=> String
resp.failures[0].exception_type #=> String
resp.failures[0].failure_code #=> String
resp.failures[0].failure_description #=> String

Parameters:

• params (Hash) (defaults to: {}) —

  ({})

Options Hash (params):

• :rule_names (required, Array<String>) —

  An array of the rule names to disable. If you need to find out the names of your rules, use DescribeInsightRules.

Returns:

• (Types::DisableInsightRulesOutput) —

  Returns a response object which responds to the following methods:

  • #failures => Array<Types::PartialFailure>

See Also:

• AWS API Documentation

resp = client.enable_alarm_actions({
  alarm_names: ["AlarmName"], # required
})

Parameters:

• params (Hash) (defaults to: {}) —

  ({})

Options Hash (params):

• :alarm_names (required, Array<String>) —

  The names of the alarms.

Returns:

• (Struct) —

  Returns an empty response.

See Also:

• AWS API Documentation

resp = client.enable_insight_rules({
  rule_names: ["InsightRuleName"], # required
})

resp.failures #=> Array
resp.failures[0].failure_resource #=> String
resp.failures[0].exception_type #=> String
resp.failures[0].failure_code #=> String
resp.failures[0].failure_description #=> String

Parameters:

• params (Hash) (defaults to: {}) —

  ({})

Options Hash (params):

• :rule_names (required, Array<String>) —

  An array of the rule names to enable. If you need to find out the names of your rules, use DescribeInsightRules.

Returns:

• (Types::EnableInsightRulesOutput) —

  Returns a response object which responds to the following methods:

  • #failures => Array<Types::PartialFailure>

See Also:

• AWS API Documentation

resp = client.get_dashboard({
  dashboard_name: "DashboardName", # required
})

resp.dashboard_arn #=> String
resp.dashboard_body #=> String
resp.dashboard_name #=> String

Parameters:

• params (Hash) (defaults to: {}) —

  ({})

Options Hash (params):

• :dashboard_name (required, String) —

  The name of the dashboard to be described.

Returns:

• (Types::GetDashboardOutput) —

  Returns a response object which responds to the following methods:

  • #dashboard_arn => String
  • #dashboard_body => String
  • #dashboard_name => String

See Also:

• AWS API Documentation

resp = client.get_insight_rule_report({
  rule_name: "InsightRuleName", # required
  start_time: Time.now, # required
  end_time: Time.now, # required
  period: 1, # required
  max_contributor_count: 1,
  metrics: ["InsightRuleMetricName"],
  order_by: "InsightRuleOrderBy",
})

resp.key_labels #=> Array
resp.key_labels[0] #=> String
resp.aggregation_statistic #=> String
resp.aggregate_value #=> Float
resp.approximate_unique_count #=> Integer
resp.contributors #=> Array
resp.contributors[0].keys #=> Array
resp.contributors[0].keys[0] #=> String
resp.contributors[0].approximate_aggregate_value #=> Float
resp.contributors[0].datapoints #=> Array
resp.contributors[0].datapoints[0].timestamp #=> Time
resp.contributors[0].datapoints[0].approximate_value #=> Float
resp.metric_datapoints #=> Array
resp.metric_datapoints[0].timestamp #=> Time
resp.metric_datapoints[0].unique_contributors #=> Float
resp.metric_datapoints[0].max_contributor_value #=> Float
resp.metric_datapoints[0].sample_count #=> Float
resp.metric_datapoints[0].average #=> Float
resp.metric_datapoints[0].sum #=> Float
resp.metric_datapoints[0].minimum #=> Float
resp.metric_datapoints[0].maximum #=> Float

Parameters:

• params (Hash) (defaults to: {}) —

  ({})

Options Hash (params):

• :rule_name (required, String) —

  The name of the rule that you want to see data from.

• :start_time (required, Time, DateTime, Date, Integer, String) —

  The start time of the data to use in the report. When used in a raw HTTP Query API, it is formatted as yyyy-MM-dd'T'HH:mm:ss. For example, 2019-07-01T23:59:59.

• :end_time (required, Time, DateTime, Date, Integer, String) —

  The end time of the data to use in the report. When used in a raw HTTP Query API, it is formatted as yyyy-MM-dd'T'HH:mm:ss. For example, 2019-07-01T23:59:59.

• :period (required, Integer) —

  The period, in seconds, to use for the statistics in the InsightRuleMetricDatapoint results.

• :max_contributor_count (Integer) —

  The maximum number of contributors to include in the report. The range is 1 to 100. If you omit this, the default of 10 is used.

• :metrics (Array<String>) —

  Specifies which metrics to use for aggregation of contributor values for the report. You can specify one or more of the following metrics:

  • UniqueContributors -- the number of unique contributors for each data point.

  • MaxContributorValue -- the value of the top contributor for each data point. The identity of the contributor might change for each data point in the graph.

    If this rule aggregates by COUNT, the top contributor for each data point is the contributor with the most occurrences in that period. If the rule aggregates by SUM, the top contributor is the contributor with the highest sum in the log field specified by the rule's Value, during that period.

  • SampleCount -- the number of data points matched by the rule.

  • Sum -- the sum of the values from all contributors during the time period represented by that data point.

  • Minimum -- the minimum value from a single observation during the time period represented by that data point.

  • Maximum -- the maximum value from a single observation during the time period represented by that data point.

  • Average -- the average value from all contributors during the time period represented by that data point.

• :order_by (String) —

  Determines what statistic to use to rank the contributors. Valid values are Sum and Maximum.

Returns:

• (Types::GetInsightRuleReportOutput) —

  Returns a response object which responds to the following methods:

  • #key_labels => Array<String>
  • #aggregation_statistic => String
  • #aggregate_value => Float
  • #approximate_unique_count => Integer
  • #contributors => Array<Types::InsightRuleContributor>
  • #metric_datapoints => Array<Types::InsightRuleMetricDatapoint>

See Also:

• AWS API Documentation

resp = client.get_metric_data({
  metric_data_queries: [ # required
    {
      id: "MetricId", # required
      metric_stat: {
        metric: { # required
          namespace: "Namespace",
          metric_name: "MetricName",
          dimensions: [
            {
              name: "DimensionName", # required
              value: "DimensionValue", # required
            },
          ],
        },
        period: 1, # required
        stat: "Stat", # required
        unit: "Seconds", # accepts Seconds, Microseconds, Milliseconds, Bytes, Kilobytes, Megabytes, Gigabytes, Terabytes, Bits, Kilobits, Megabits, Gigabits, Terabits, Percent, Count, Bytes/Second, Kilobytes/Second, Megabytes/Second, Gigabytes/Second, Terabytes/Second, Bits/Second, Kilobits/Second, Megabits/Second, Gigabits/Second, Terabits/Second, Count/Second, None
      },
      expression: "MetricExpression",
      label: "MetricLabel",
      return_data: false,
      period: 1,
      account_id: "AccountId",
    },
  ],
  start_time: Time.now, # required
  end_time: Time.now, # required
  next_token: "NextToken",
  scan_by: "TimestampDescending", # accepts TimestampDescending, TimestampAscending
  max_datapoints: 1,
  label_options: {
    timezone: "GetMetricDataLabelTimezone",
  },
})

resp.metric_data_results #=> Array
resp.metric_data_results[0].id #=> String
resp.metric_data_results[0].label #=> String
resp.metric_data_results[0].timestamps #=> Array
resp.metric_data_results[0].timestamps[0] #=> Time
resp.metric_data_results[0].values #=> Array
resp.metric_data_results[0].values[0] #=> Float
resp.metric_data_results[0].status_code #=> String, one of "Complete", "InternalError", "PartialData", "Forbidden"
resp.metric_data_results[0].messages #=> Array
resp.metric_data_results[0].messages[0].code #=> String
resp.metric_data_results[0].messages[0].value #=> String
resp.next_token #=> String
resp.messages #=> Array
resp.messages[0].code #=> String
resp.messages[0].value #=> String

Parameters:

• params (Hash) (defaults to: {}) —

  ({})

Options Hash (params):

• :metric_data_queries (required, Array<Types::MetricDataQuery>) —

  The metric queries to be returned. A single GetMetricData call can include as many as 500 MetricDataQuery structures. Each of these structures can specify either a metric to retrieve, a Metrics Insights query, or a math expression to perform on retrieved data.

• :start_time (required, Time, DateTime, Date, Integer, String) —

  The time stamp indicating the earliest data to be returned.

  The value specified is inclusive; results include data points with the specified time stamp.

  CloudWatch rounds the specified time stamp as follows:

  • Start time less than 15 days ago - Round down to the nearest whole minute. For example, 12:32:34 is rounded down to 12:32:00.

  • Start time between 15 and 63 days ago - Round down to the nearest 5-minute clock interval. For example, 12:32:34 is rounded down to 12:30:00.

  • Start time greater than 63 days ago - Round down to the nearest 1-hour clock interval. For example, 12:32:34 is rounded down to 12:00:00.

  If you set Period to 5, 10, 20, or 30, the start time of your request is rounded down to the nearest time that corresponds to even 5-, 10-, 20-, or 30-second divisions of a minute. For example, if you make a query at (HH:mm:ss) 01:05:23 for the previous 10-second period, the start time of your request is rounded down and you receive data from 01:05:10 to 01:05:20. If you make a query at 15:07:17 for the previous 5 minutes of data, using a period of 5 seconds, you receive data timestamped between 15:02:15 and 15:07:15.

  For better performance, specify StartTime and EndTime values that align with the value of the metric's Period and sync up with the beginning and end of an hour. For example, if the Period of a metric is 5 minutes, specifying 12:05 or 12:30 as StartTime can get a faster response from CloudWatch than setting 12:07 or 12:29 as the StartTime.

• :end_time (required, Time, DateTime, Date, Integer, String) —

  The time stamp indicating the latest data to be returned.

  The value specified is exclusive; results include data points up to the specified time stamp.

  For better performance, specify StartTime and EndTime values that align with the value of the metric's Period and sync up with the beginning and end of an hour. For example, if the Period of a metric is 5 minutes, specifying 12:05 or 12:30 as EndTime can get a faster response from CloudWatch than setting 12:07 or 12:29 as the EndTime.

• :next_token (String) —

  Include this value, if it was returned by the previous GetMetricData operation, to get the next set of data points.

• :scan_by (String) —

  The order in which data points should be returned. TimestampDescending returns the newest data first and paginates when the MaxDatapoints limit is reached. TimestampAscending returns the oldest data first and paginates when the MaxDatapoints limit is reached.

  If you omit this parameter, the default of TimestampDescending is used.

• :max_datapoints (Integer) —

  The maximum number of data points the request should return before paginating. If you omit this, the default of 100,800 is used.

• :label_options (Types::LabelOptions) —

  This structure includes the Timezone parameter, which you can use to specify your time zone so that the labels of returned data display the correct time for your time zone.

Returns:

• (Types::GetMetricDataOutput) —

  Returns a response object which responds to the following methods:

  • #metric_data_results => Array<Types::MetricDataResult>
  • #next_token => String
  • #messages => Array<Types::MessageData>

See Also:

• AWS API Documentation

resp = client.get_metric_statistics({
  namespace: "Namespace", # required
  metric_name: "MetricName", # required
  dimensions: [
    {
      name: "DimensionName", # required
      value: "DimensionValue", # required
    },
  ],
  start_time: Time.now, # required
  end_time: Time.now, # required
  period: 1, # required
  statistics: ["SampleCount"], # accepts SampleCount, Average, Sum, Minimum, Maximum
  extended_statistics: ["ExtendedStatistic"],
  unit: "Seconds", # accepts Seconds, Microseconds, Milliseconds, Bytes, Kilobytes, Megabytes, Gigabytes, Terabytes, Bits, Kilobits, Megabits, Gigabits, Terabits, Percent, Count, Bytes/Second, Kilobytes/Second, Megabytes/Second, Gigabytes/Second, Terabytes/Second, Bits/Second, Kilobits/Second, Megabits/Second, Gigabits/Second, Terabits/Second, Count/Second, None
})

resp.label #=> String
resp.datapoints #=> Array
resp.datapoints[0].timestamp #=> Time
resp.datapoints[0].sample_count #=> Float
resp.datapoints[0].average #=> Float
resp.datapoints[0].sum #=> Float
resp.datapoints[0].minimum #=> Float
resp.datapoints[0].maximum #=> Float
resp.datapoints[0].unit #=> String, one of "Seconds", "Microseconds", "Milliseconds", "Bytes", "Kilobytes", "Megabytes", "Gigabytes", "Terabytes", "Bits", "Kilobits", "Megabits", "Gigabits", "Terabits", "Percent", "Count", "Bytes/Second", "Kilobytes/Second", "Megabytes/Second", "Gigabytes/Second", "Terabytes/Second", "Bits/Second", "Kilobits/Second", "Megabits/Second", "Gigabits/Second", "Terabits/Second", "Count/Second", "None"
resp.datapoints[0].extended_statistics #=> Hash
resp.datapoints[0].extended_statistics["ExtendedStatistic"] #=> Float

Parameters:

• params (Hash) (defaults to: {}) —

  ({})

Options Hash (params):

• :namespace (required, String) —

  The namespace of the metric, with or without spaces.

• :metric_name (required, String) —

  The name of the metric, with or without spaces.

• :dimensions (Array<Types::Dimension>) —

  The dimensions. If the metric contains multiple dimensions, you must include a value for each dimension. CloudWatch treats each unique combination of dimensions as a separate metric. If a specific combination of dimensions was not published, you can't retrieve statistics for it. You must specify the same dimensions that were used when the metrics were created. For an example, see Dimension Combinations in the Amazon CloudWatch User Guide. For more information about specifying dimensions, see Publishing Metrics in the Amazon CloudWatch User Guide.

• :start_time (required, Time, DateTime, Date, Integer, String) —

  The time stamp that determines the first data point to return. Start times are evaluated relative to the time that CloudWatch receives the request.

  The value specified is inclusive; results include data points with the specified time stamp. In a raw HTTP query, the time stamp must be in ISO 8601 UTC format (for example, 2016-10-03T23:00:00Z).

  CloudWatch rounds the specified time stamp as follows:

  • Start time less than 15 days ago - Round down to the nearest whole minute. For example, 12:32:34 is rounded down to 12:32:00.

  • Start time between 15 and 63 days ago - Round down to the nearest 5-minute clock interval. For example, 12:32:34 is rounded down to 12:30:00.

  • Start time greater than 63 days ago - Round down to the nearest 1-hour clock interval. For example, 12:32:34 is rounded down to 12:00:00.

  If you set Period to 5, 10, 20, or 30, the start time of your request is rounded down to the nearest time that corresponds to even 5-, 10-, 20-, or 30-second divisions of a minute. For example, if you make a query at (HH:mm:ss) 01:05:23 for the previous 10-second period, the start time of your request is rounded down and you receive data from 01:05:10 to 01:05:20. If you make a query at 15:07:17 for the previous 5 minutes of data, using a period of 5 seconds, you receive data timestamped between 15:02:15 and 15:07:15.

• :end_time (required, Time, DateTime, Date, Integer, String) —

  The time stamp that determines the last data point to return.

  The value specified is exclusive; results include data points up to the specified time stamp. In a raw HTTP query, the time stamp must be in ISO 8601 UTC format (for example, 2016-10-10T23:00:00Z).

• :period (required, Integer) —

  The granularity, in seconds, of the returned data points. For metrics with regular resolution, a period can be as short as one minute (60 seconds) and must be a multiple of 60. For high-resolution metrics that are collected at intervals of less than one minute, the period can be 1, 5, 10, 20, 30, 60, or any multiple of 60. High-resolution metrics are those metrics stored by a PutMetricData call that includes a StorageResolution of 1 second.

  If the StartTime parameter specifies a time stamp that is greater than 3 hours ago, you must specify the period as follows or no data points in that time range is returned:

  • Start time between 3 hours and 15 days ago - Use a multiple of 60 seconds (1 minute).

  • Start time between 15 and 63 days ago - Use a multiple of 300 seconds (5 minutes).

  • Start time greater than 63 days ago - Use a multiple of 3600 seconds (1 hour).

• :statistics (Array<String>) —

  The metric statistics, other than percentile. For percentile statistics, use ExtendedStatistics. When calling GetMetricStatistics, you must specify either Statistics or ExtendedStatistics, but not both.

• :extended_statistics (Array<String>) —

  The percentile statistics. Specify values between p0.0 and p100. When calling GetMetricStatistics, you must specify either Statistics or ExtendedStatistics, but not both. Percentile statistics are not available for metrics when any of the metric values are negative numbers.

• :unit (String) —

  The unit for a given metric. If you omit Unit, all data that was collected with any unit is returned, along with the corresponding units that were specified when the data was reported to CloudWatch. If you specify a unit, the operation returns only data that was collected with that unit specified. If you specify a unit that does not match the data collected, the results of the operation are null. CloudWatch does not perform unit conversions.

Returns:

• (Types::GetMetricStatisticsOutput) —

  Returns a response object which responds to the following methods:

  • #label => String
  • #datapoints => Array<Types::Datapoint>

See Also:

• AWS API Documentation

resp = client.get_metric_stream({
  name: "MetricStreamName", # required
})

resp.arn #=> String
resp.name #=> String
resp.include_filters #=> Array
resp.include_filters[0].namespace #=> String
resp.include_filters[0].metric_names #=> Array
resp.include_filters[0].metric_names[0] #=> String
resp.exclude_filters #=> Array
resp.exclude_filters[0].namespace #=> String
resp.exclude_filters[0].metric_names #=> Array
resp.exclude_filters[0].metric_names[0] #=> String
resp.firehose_arn #=> String
resp.role_arn #=> String
resp.state #=> String
resp.creation_date #=> Time
resp.last_update_date #=> Time
resp.output_format #=> String, one of "json", "opentelemetry0.7", "opentelemetry1.0"
resp.statistics_configurations #=> Array
resp.statistics_configurations[0].include_metrics #=> Array
resp.statistics_configurations[0].include_metrics[0].namespace #=> String
resp.statistics_configurations[0].include_metrics[0].metric_name #=> String
resp.statistics_configurations[0].additional_statistics #=> Array
resp.statistics_configurations[0].additional_statistics[0] #=> String
resp.include_linked_accounts_metrics #=> Boolean

Parameters:

• params (Hash) (defaults to: {}) —

  ({})

Options Hash (params):

• :name (required, String) —

  The name of the metric stream to retrieve information about.

Returns:

• (Types::GetMetricStreamOutput) —

  Returns a response object which responds to the following methods:

  • #arn => String
  • #name => String
  • #include_filters => Array<Types::MetricStreamFilter>
  • #exclude_filters => Array<Types::MetricStreamFilter>
  • #firehose_arn => String
  • #role_arn => String
  • #state => String
  • #creation_date => Time
  • #last_update_date => Time
  • #output_format => String
  • #statistics_configurations => Array<Types::MetricStreamStatisticsConfiguration>
  • #include_linked_accounts_metrics => Boolean