aws-sdk-cloudwatch 1.61.0 → 1.64.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 50ae0923d83ef82d62943fd1785b0e5dab2973ccc1386c9965e6bd390544c2fc
-  data.tar.gz: a844300cdf5f1e7f589e8a643849db0836c953dd15a0b4ef009d19620531139c
+  metadata.gz: 918f50d5e3f8d43f139fda5f9f3e5cd9b7e5dea0bb93ed7926df40c9d2a5156c
+  data.tar.gz: c992a354593a95ba169777d3a1b8e28e2136443796a808166dd8f8fcd2a599c0
 SHA512:
-  metadata.gz: 7d26bcd03fd1bee2ac19908fdc8283825539206843ecdf783ff41f4cff225120e54a0035494b9a82a8190f4b460be4390c337b8a0d2ae56f593d043e346e5342
-  data.tar.gz: 9ff5dee7a1286a52b46cbe55c742be2686a1b51720c5d2eea11b953985add1ad908a44a3035e9e1eec4942a5c4c510006de57873113676fb413984a618bdc8c0
+  metadata.gz: 3bd904fd9553fd6709653b1f2c4c9e835e8f0871a866871ae259f177fa0a4fe8faacf4385a2bd7e2a5e55b10aea598d986d280ac9ce695c394c75917734925e8
+  data.tar.gz: 06e82055db45c57c29cf0dff6a2468b40c887a7dd79b0a2abc89b23ced0b04906dd2f2616b6fad5505b66fbe251133045be966114b4ba30f4c954c0b8123623a

data/CHANGELOG.md

@@ -1,6 +1,21 @@
 Unreleased Changes
 ------------------
 
+1.64.0 (2022-04-14)
+------------------
+
+* Feature - Updates documentation for additional statistics in CloudWatch Metric Streams.
+
+1.63.0 (2022-04-13)
+------------------
+
+* Feature - Adds support for additional statistics in CloudWatch Metric Streams.
+
+1.62.0 (2022-02-24)
+------------------
+
+* Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
+
 1.61.0 (2022-02-03)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.61.0
+1.64.0

data/lib/aws-sdk-cloudwatch/alarm.rb

@@ -180,8 +180,17 @@ module Aws::CloudWatch
       data[:comparison_operator]
     end
 
-    # Sets how this alarm is to handle missing data points. If this
-    # parameter is omitted, the default behavior of `missing` is used.
+    # Sets how this alarm is to handle missing data points. The valid values
+    # are `breaching`, `notBreaching`, `ignore`, and `missing`. For more
+    # information, see [Configuring how CloudWatch alarms treat missing
+    # data][1].
+    #
+    # If this parameter is omitted, the default behavior of `missing` is
+    # used.
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/AlarmThatSendsEmail.html#alarms-and-missing-data
     # @return [String]
     def treat_missing_data
       data[:treat_missing_data]

data/lib/aws-sdk-cloudwatch/client.rb

@@ -27,6 +27,7 @@ require 'aws-sdk-core/plugins/client_metrics_plugin.rb'
 require 'aws-sdk-core/plugins/client_metrics_send_plugin.rb'
 require 'aws-sdk-core/plugins/transfer_encoding.rb'
 require 'aws-sdk-core/plugins/http_checksum.rb'
+require 'aws-sdk-core/plugins/checksum_algorithm.rb'
 require 'aws-sdk-core/plugins/defaults_mode.rb'
 require 'aws-sdk-core/plugins/recursion_detection.rb'
 require 'aws-sdk-core/plugins/signature_v4.rb'
@@ -75,6 +76,7 @@ module Aws::CloudWatch
     add_plugin(Aws::Plugins::ClientMetricsSendPlugin)
     add_plugin(Aws::Plugins::TransferEncoding)
     add_plugin(Aws::Plugins::HttpChecksum)
+    add_plugin(Aws::Plugins::ChecksumAlgorithm)
     add_plugin(Aws::Plugins::DefaultsMode)
     add_plugin(Aws::Plugins::RecursionDetection)
     add_plugin(Aws::Plugins::SignatureV4)
@@ -1442,19 +1444,30 @@ module Aws::CloudWatch
       req.send_request(options)
     end
 
-    # You can use the `GetMetricData` API to retrieve as many as 500
-    # different metrics in a single request, with a total of as many as
-    # 100,800 data points. You can also optionally perform math expressions
-    # on the values of the returned statistics, to create new time series
-    # that represent new insights into your data. For example, using Lambda
-    # metrics, you could divide the Errors metric by the Invocations metric
-    # to get an error rate time series. For more information about metric
-    # math expressions, see [Metric Math Syntax and Functions][1] in the
-    # *Amazon CloudWatch User Guide*.
+    # You can use the `GetMetricData` API to retrieve CloudWatch metric
+    # values. The operation can also include a CloudWatch Metrics Insights
+    # query, and one or more metric math functions.
+    #
+    # A `GetMetricData` operation that does not include a query can retrieve
+    # as many as 500 different metrics in a single request, with a total of
+    # as many as 100,800 data points. You can also optionally perform metric
+    # math expressions on the values of the returned statistics, to create
+    # new time series that represent new insights into your data. For
+    # example, using Lambda metrics, you could divide the Errors metric by
+    # the Invocations metric to get an error rate time series. For more
+    # information about metric math expressions, see [Metric Math Syntax and
+    # Functions][1] in the *Amazon CloudWatch User Guide*.
+    #
+    # If you include a Metrics Insights query, each `GetMetricData`
+    # operation can include only one query. But the same `GetMetricData`
+    # operation can also retrieve other metrics. Metrics Insights queries
+    # can query only the most recent three hours of metric data. For more
+    # information about Metrics Insights, see [Query your metrics with
+    # CloudWatch Metrics Insights][2].
     #
     # Calls to the `GetMetricData` API have a different pricing structure
     # than calls to `GetMetricStatistics`. For more information about
-    # pricing, see [Amazon CloudWatch Pricing][2].
+    # pricing, see [Amazon CloudWatch Pricing][3].
     #
     # Amazon CloudWatch retains metric data as follows:
     #
@@ -1488,16 +1501,29 @@ module Aws::CloudWatch
     # collected, the results of the operation are null. CloudWatch does not
     # perform unit conversions.
     #
+    # **Using Metrics Insights queries with metric math**
+    #
+    # You can't mix a Metric Insights query and metric math syntax in the
+    # same expression, but you can reference results from a Metrics Insights
+    # query within other Metric math expressions. A Metrics Insights query
+    # without a **GROUP BY** clause returns a single time-series (TS), and
+    # can be used as input for a metric math expression that expects a
+    # single time series. A Metrics Insights query with a **GROUP BY**
+    # clause returns an array of time-series (TS\[\]), and can be used as
+    # input for a metric math expression that expects an array of time
+    # series.
+    #
     #
     #
     # [1]: https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/using-metric-math.html#metric-math-syntax
-    # [2]: https://aws.amazon.com/cloudwatch/pricing/
+    # [2]: https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/query_with_cloudwatch-metrics-insights.html
+    # [3]: https://aws.amazon.com/cloudwatch/pricing/
     #
     # @option params [required, Array<Types::MetricDataQuery>] :metric_data_queries
     #   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, or a math
-    #   expression to perform on retrieved data.
+    #   structures can specify either a metric to retrieve, a Metrics Insights
+    #   query, or a math expression to perform on retrieved data.
     #
     # @option params [required, Time,DateTime,Date,Integer,String] :start_time
     #   The time stamp indicating the earliest data to be returned.
@@ -1870,6 +1896,7 @@ module Aws::CloudWatch
     #   * {Types::GetMetricStreamOutput#creation_date #creation_date} => Time
     #   * {Types::GetMetricStreamOutput#last_update_date #last_update_date} => Time
     #   * {Types::GetMetricStreamOutput#output_format #output_format} => String
+    #   * {Types::GetMetricStreamOutput#statistics_configurations #statistics_configurations} => Array&lt;Types::MetricStreamStatisticsConfiguration&gt;
     #
     # @example Request syntax with placeholder values
     #
@@ -1891,6 +1918,12 @@ module Aws::CloudWatch
     #   resp.creation_date #=> Time
     #   resp.last_update_date #=> Time
     #   resp.output_format #=> String, one of "json", "opentelemetry0.7"
+    #   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
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/monitoring-2010-08-01/GetMetricStream AWS API Documentation
     #
@@ -2368,7 +2401,10 @@ module Aws::CloudWatch
     # rule are met.
     #
     # The alarms specified in a composite alarm's rule expression can
-    # include metric alarms and other composite alarms.
+    # include metric alarms and other composite alarms. The rule expression
+    # of a composite alarm can include as many as 100 underlying alarms. Any
+    # single alarm can be included in the rule expressions of as many as 150
+    # composite alarms.
     #
     # Using composite alarms can reduce alarm noise. You can create multiple
     # metric alarms, and also create a composite alarm and set up alerts
@@ -2934,6 +2970,13 @@ module Aws::CloudWatch
     #
     #   Valid Values: `breaching | notBreaching | ignore | missing`
     #
+    #   <note markdown="1"> Alarms that evaluate metrics in the `AWS/DynamoDB` namespace always
+    #   `ignore` missing data even if you choose a different option for
+    #   `TreatMissingData`. When an `AWS/DynamoDB` metric has missing data,
+    #   alarms that evaluate that metric remain in their current state.
+    #
+    #    </note>
+    #
     #
     #
     #   [1]: https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/AlarmThatSendsEmail.html#alarms-and-missing-data
@@ -3205,6 +3248,13 @@ module Aws::CloudWatch
     # * Stream metrics from only the metric namespaces that you list in
     #   `IncludeFilters`.
     #
+    # By default, a metric stream always sends the `MAX`, `MIN`, `SUM`, and
+    # `SAMPLECOUNT` statistics for each metric that is streamed. You can use
+    # the `StatisticsConfigurations` parameter to have the metric stream
+    # also send additional statistics in the stream. Streaming additional
+    # statistics incurs additional costs. For more information, see [Amazon
+    # CloudWatch Pricing][2].
+    #
     # When you use `PutMetricStream` to create a new metric stream, the
     # stream is created in the `running` state. If you use it to update an
     # existing stream, the state of the stream is not changed.
@@ -3212,6 +3262,7 @@ module Aws::CloudWatch
     #
     #
     # [1]: https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Metric-Streams.html
+    # [2]: https://aws.amazon.com/cloudwatch/pricing/
     #
     # @option params [required, String] :name
     #   If you are creating a new metric stream, this is the name for the new
@@ -3280,6 +3331,25 @@ module Aws::CloudWatch
     #   [1]: https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_TagResource.html
     #   [2]: https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_UntagResource.html
     #
+    # @option params [Array<Types::MetricStreamStatisticsConfiguration>] :statistics_configurations
+    #   By default, a metric stream always sends the `MAX`, `MIN`, `SUM`, and
+    #   `SAMPLECOUNT` statistics for each metric that is streamed. You can use
+    #   this parameter to have the metric stream also send additional
+    #   statistics in the stream. This array can have up to 100 members.
+    #
+    #   For each entry in this array, you specify one or more metrics and the
+    #   list of additional statistics to stream for those metrics. The
+    #   additional statistics that you can stream depend on the stream's
+    #   `OutputFormat`. If the `OutputFormat` is `json`, you can stream any
+    #   additional statistic that is supported by CloudWatch, listed in [
+    #   CloudWatch statistics definitions][1]. If the `OutputFormat` is
+    #   `opentelemetry0.7`, you can stream percentile statistics such as p95,
+    #   p99.9 and so on.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/Statistics-definitions.html.html
+    #
     # @return [Types::PutMetricStreamOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
     #   * {Types::PutMetricStreamOutput#arn #arn} => String
@@ -3307,6 +3377,17 @@ module Aws::CloudWatch
     #         value: "TagValue", # required
     #       },
     #     ],
+    #     statistics_configurations: [
+    #       {
+    #         include_metrics: [ # required
+    #           {
+    #             namespace: "Namespace", # required
+    #             metric_name: "MetricName", # required
+    #           },
+    #         ],
+    #         additional_statistics: ["MetricStreamStatistic"], # required
+    #       },
+    #     ],
     #   })
     #
     # @example Response structure
@@ -3552,7 +3633,7 @@ module Aws::CloudWatch
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-cloudwatch'
-      context[:gem_version] = '1.61.0'
+      context[:gem_version] = '1.64.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

data/lib/aws-sdk-cloudwatch/client_api.rb

@@ -193,6 +193,12 @@ module Aws::CloudWatch
     MetricStreamNames = Shapes::ListShape.new(name: 'MetricStreamNames')
     MetricStreamOutputFormat = Shapes::StringShape.new(name: 'MetricStreamOutputFormat')
     MetricStreamState = Shapes::StringShape.new(name: 'MetricStreamState')
+    MetricStreamStatistic = Shapes::StringShape.new(name: 'MetricStreamStatistic')
+    MetricStreamStatisticsAdditionalStatistics = Shapes::ListShape.new(name: 'MetricStreamStatisticsAdditionalStatistics')
+    MetricStreamStatisticsConfiguration = Shapes::StructureShape.new(name: 'MetricStreamStatisticsConfiguration')
+    MetricStreamStatisticsConfigurations = Shapes::ListShape.new(name: 'MetricStreamStatisticsConfigurations')
+    MetricStreamStatisticsIncludeMetrics = Shapes::ListShape.new(name: 'MetricStreamStatisticsIncludeMetrics')
+    MetricStreamStatisticsMetric = Shapes::StructureShape.new(name: 'MetricStreamStatisticsMetric')
     MetricWidget = Shapes::StringShape.new(name: 'MetricWidget')
     MetricWidgetImage = Shapes::BlobShape.new(name: 'MetricWidgetImage')
     Metrics = Shapes::ListShape.new(name: 'Metrics')
@@ -542,6 +548,7 @@ module Aws::CloudWatch
     GetMetricStreamOutput.add_member(:creation_date, Shapes::ShapeRef.new(shape: Timestamp, location_name: "CreationDate"))
     GetMetricStreamOutput.add_member(:last_update_date, Shapes::ShapeRef.new(shape: Timestamp, location_name: "LastUpdateDate"))
     GetMetricStreamOutput.add_member(:output_format, Shapes::ShapeRef.new(shape: MetricStreamOutputFormat, location_name: "OutputFormat"))
+    GetMetricStreamOutput.add_member(:statistics_configurations, Shapes::ShapeRef.new(shape: MetricStreamStatisticsConfigurations, location_name: "StatisticsConfigurations"))
     GetMetricStreamOutput.struct_class = Types::GetMetricStreamOutput
 
     GetMetricWidgetImageInput.add_member(:metric_widget, Shapes::ShapeRef.new(shape: MetricWidget, required: true, location_name: "MetricWidget"))
@@ -751,6 +758,20 @@ module Aws::CloudWatch
 
     MetricStreamNames.member = Shapes::ShapeRef.new(shape: MetricStreamName)
 
+    MetricStreamStatisticsAdditionalStatistics.member = Shapes::ShapeRef.new(shape: MetricStreamStatistic)
+
+    MetricStreamStatisticsConfiguration.add_member(:include_metrics, Shapes::ShapeRef.new(shape: MetricStreamStatisticsIncludeMetrics, required: true, location_name: "IncludeMetrics"))
+    MetricStreamStatisticsConfiguration.add_member(:additional_statistics, Shapes::ShapeRef.new(shape: MetricStreamStatisticsAdditionalStatistics, required: true, location_name: "AdditionalStatistics"))
+    MetricStreamStatisticsConfiguration.struct_class = Types::MetricStreamStatisticsConfiguration
+
+    MetricStreamStatisticsConfigurations.member = Shapes::ShapeRef.new(shape: MetricStreamStatisticsConfiguration)
+
+    MetricStreamStatisticsIncludeMetrics.member = Shapes::ShapeRef.new(shape: MetricStreamStatisticsMetric)
+
+    MetricStreamStatisticsMetric.add_member(:namespace, Shapes::ShapeRef.new(shape: Namespace, required: true, location_name: "Namespace"))
+    MetricStreamStatisticsMetric.add_member(:metric_name, Shapes::ShapeRef.new(shape: MetricName, required: true, location_name: "MetricName"))
+    MetricStreamStatisticsMetric.struct_class = Types::MetricStreamStatisticsMetric
+
     Metrics.member = Shapes::ShapeRef.new(shape: Metric)
 
     MissingRequiredParameterException.add_member(:message, Shapes::ShapeRef.new(shape: AwsQueryErrorMessage, location_name: "message"))
@@ -833,6 +854,7 @@ module Aws::CloudWatch
     PutMetricStreamInput.add_member(:role_arn, Shapes::ShapeRef.new(shape: AmazonResourceName, required: true, location_name: "RoleArn"))
     PutMetricStreamInput.add_member(:output_format, Shapes::ShapeRef.new(shape: MetricStreamOutputFormat, required: true, location_name: "OutputFormat"))
     PutMetricStreamInput.add_member(:tags, Shapes::ShapeRef.new(shape: TagList, location_name: "Tags"))
+    PutMetricStreamInput.add_member(:statistics_configurations, Shapes::ShapeRef.new(shape: MetricStreamStatisticsConfigurations, location_name: "StatisticsConfigurations"))
     PutMetricStreamInput.struct_class = Types::PutMetricStreamInput
 
     PutMetricStreamOutput.add_member(:arn, Shapes::ShapeRef.new(shape: AmazonResourceName, location_name: "Arn"))

data/lib/aws-sdk-cloudwatch/metric.rb

@@ -531,6 +531,13 @@ module Aws::CloudWatch
     #
     #   Valid Values: `breaching | notBreaching | ignore | missing`
     #
+    #   <note markdown="1"> Alarms that evaluate metrics in the `AWS/DynamoDB` namespace always
+    #   `ignore` missing data even if you choose a different option for
+    #   `TreatMissingData`. When an `AWS/DynamoDB` metric has missing data,
+    #   alarms that evaluate that metric remain in their current state.
+    #
+    #    </note>
+    #
     #
     #
     #   [1]: https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/AlarmThatSendsEmail.html#alarms-and-missing-data

data/lib/aws-sdk-cloudwatch/types.rb

@@ -1031,10 +1031,13 @@ module Aws::CloudWatch
     end
 
     # A dimension is a name/value pair that is part of the identity of a
-    # metric. You can assign up to 10 dimensions to a metric. Because
-    # dimensions are part of the unique identifier for a metric, whenever
-    # you add a unique name/value pair to one of your metrics, you are
-    # creating a new variation of that metric.
+    # metric. Because dimensions are part of the unique identifier for a
+    # metric, whenever you add a unique name/value pair to one of your
+    # metrics, you are creating a new variation of that metric. For example,
+    # many Amazon EC2 metrics publish `InstanceId` as a dimension name, and
+    # the actual instance ID as the value for that dimension.
+    #
+    # You can assign up to 10 dimensions to a metric.
     #
     # @note When making an API call, you may pass Dimension
     #   data as a hash:
@@ -1046,7 +1049,8 @@ module Aws::CloudWatch
     #
     # @!attribute [rw] name
     #   The name of the dimension. Dimension names must contain only ASCII
-    #   characters and must include at least one non-whitespace character.
+    #   characters, must include at least one non-whitespace character, and
+    #   cannot start with a colon (`:`).
     #   @return [String]
     #
     # @!attribute [rw] value
@@ -1429,8 +1433,8 @@ module Aws::CloudWatch
     # @!attribute [rw] metric_data_queries
     #   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, or a math
-    #   expression to perform on retrieved data.
+    #   structures can specify either a metric to retrieve, a Metrics
+    #   Insights query, or a math expression to perform on retrieved data.
     #   @return [Array<Types::MetricDataQuery>]
     #
     # @!attribute [rw] start_time
@@ -1784,8 +1788,26 @@ module Aws::CloudWatch
     #   @return [Time]
     #
     # @!attribute [rw] output_format
+    #   The output format for the stream. Valid values are `json` and
+    #   `opentelemetry0.7`. For more information about metric stream output
+    #   formats, see [ Metric streams output formats][1].
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-metric-streams-formats.html
     #   @return [String]
     #
+    # @!attribute [rw] statistics_configurations
+    #   Each entry in this array displays information about one or more
+    #   metrics that include additional statistics in the metric stream. For
+    #   more information about the additional statistics, see [ CloudWatch
+    #   statistics definitions][1].
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/Statistics-definitions.html.html
+    #   @return [Array<Types::MetricStreamStatisticsConfiguration>]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/monitoring-2010-08-01/GetMetricStreamOutput AWS API Documentation
     #
     class GetMetricStreamOutput < Struct.new(
@@ -1798,7 +1820,8 @@ module Aws::CloudWatch
       :state,
       :creation_date,
       :last_update_date,
-      :output_format)
+      :output_format,
+      :statistics_configurations)
       SENSITIVE = []
       include Aws::Structure
     end
@@ -2592,8 +2615,17 @@ module Aws::CloudWatch
     #   @return [String]
     #
     # @!attribute [rw] treat_missing_data
-    #   Sets how this alarm is to handle missing data points. If this
-    #   parameter is omitted, the default behavior of `missing` is used.
+    #   Sets how this alarm is to handle missing data points. The valid
+    #   values are `breaching`, `notBreaching`, `ignore`, and `missing`. For
+    #   more information, see [Configuring how CloudWatch alarms treat
+    #   missing data][1].
+    #
+    #   If this parameter is omitted, the default behavior of `missing` is
+    #   used.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/AlarmThatSendsEmail.html#alarms-and-missing-data
     #   @return [String]
     #
     # @!attribute [rw] evaluate_low_sample_count_percentile
@@ -2658,9 +2690,9 @@ module Aws::CloudWatch
     #
     # When used in `GetMetricData`, it indicates the metric data to return,
     # and whether this call is just retrieving a batch set of data for one
-    # metric, or is performing a math expression on metric data. A single
-    # `GetMetricData` call can include up to 500 `MetricDataQuery`
-    # structures.
+    # metric, or is performing a Metrics Insights query or a math
+    # expression. A single `GetMetricData` call can include up to 500
+    # `MetricDataQuery` structures.
     #
     # When used in `PutMetricAlarm`, it enables you to create an alarm based
     # on a metric math expression. Each `MetricDataQuery` in the array
@@ -2733,20 +2765,25 @@ module Aws::CloudWatch
     #   @return [Types::MetricStat]
     #
     # @!attribute [rw] expression
-    #   The math expression to be performed on the returned data, if this
-    #   object is performing a math expression. This expression can use the
-    #   `Id` of the other metrics to refer to those metrics, and can also
-    #   use the `Id` of other expressions to use the result of those
-    #   expressions. For more information about metric math expressions, see
-    #   [Metric Math Syntax and Functions][1] in the *Amazon CloudWatch User
+    #   This field can contain either a Metrics Insights query, or a metric
+    #   math expression to be performed on the returned data. For more
+    #   information about Metrics Insights queries, see [Metrics Insights
+    #   query components and syntax][1] in the *Amazon CloudWatch User
     #   Guide*.
     #
+    #   A math expression can use the `Id` of the other metrics or queries
+    #   to refer to those metrics, and can also use the `Id` of other
+    #   expressions to use the result of those expressions. For more
+    #   information about metric math expressions, see [Metric Math Syntax
+    #   and Functions][2] in the *Amazon CloudWatch User Guide*.
+    #
     #   Within each MetricDataQuery object, you must specify either
     #   `Expression` or `MetricStat` but not both.
     #
     #
     #
-    #   [1]: https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/using-metric-math.html#metric-math-syntax
+    #   [1]: https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/cloudwatch-metrics-insights-querylanguage
+    #   [2]: https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/using-metric-math.html#metric-math-syntax
     #   @return [String]
     #
     # @!attribute [rw] label
@@ -3188,6 +3225,96 @@ module Aws::CloudWatch
       include Aws::Structure
     end
 
+    # By default, a metric stream always sends the `MAX`, `MIN`, `SUM`, and
+    # `SAMPLECOUNT` statistics for each metric that is streamed. This
+    # structure contains information for one metric that includes additional
+    # statistics in the stream. For more information about statistics, see
+    # CloudWatch, listed in [ CloudWatch statistics definitions][1].
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/Statistics-definitions.html.html
+    #
+    # @note When making an API call, you may pass MetricStreamStatisticsConfiguration
+    #   data as a hash:
+    #
+    #       {
+    #         include_metrics: [ # required
+    #           {
+    #             namespace: "Namespace", # required
+    #             metric_name: "MetricName", # required
+    #           },
+    #         ],
+    #         additional_statistics: ["MetricStreamStatistic"], # required
+    #       }
+    #
+    # @!attribute [rw] include_metrics
+    #   An array of metric name and namespace pairs that stream the
+    #   additional statistics listed in the value of the
+    #   `AdditionalStatistics` parameter. There can be as many as 100 pairs
+    #   in the array.
+    #
+    #   All metrics that match the combination of metric name and namespace
+    #   will be streamed with the additional statistics, no matter their
+    #   dimensions.
+    #   @return [Array<Types::MetricStreamStatisticsMetric>]
+    #
+    # @!attribute [rw] additional_statistics
+    #   The list of additional statistics that are to be streamed for the
+    #   metrics listed in the `IncludeMetrics` array in this structure. This
+    #   list can include as many as 20 statistics.
+    #
+    #   If the `OutputFormat` for the stream is `opentelemetry0.7`, the only
+    #   valid values are `p?? ` percentile statistics such as `p90`, `p99`
+    #   and so on.
+    #
+    #   If the `OutputFormat` for the stream is `json`, the valid values
+    #   include the abbreviations for all of the statistics listed in [
+    #   CloudWatch statistics definitions][1]. For example, this includes
+    #   `tm98, ` `wm90`, `PR(:300)`, and so on.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/Statistics-definitions.html.html
+    #   @return [Array<String>]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/monitoring-2010-08-01/MetricStreamStatisticsConfiguration AWS API Documentation
+    #
+    class MetricStreamStatisticsConfiguration < Struct.new(
+      :include_metrics,
+      :additional_statistics)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # This object contains the information for one metric that is to be
+    # streamed with additional statistics.
+    #
+    # @note When making an API call, you may pass MetricStreamStatisticsMetric
+    #   data as a hash:
+    #
+    #       {
+    #         namespace: "Namespace", # required
+    #         metric_name: "MetricName", # required
+    #       }
+    #
+    # @!attribute [rw] namespace
+    #   The namespace of the metric.
+    #   @return [String]
+    #
+    # @!attribute [rw] metric_name
+    #   The name of the metric.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/monitoring-2010-08-01/MetricStreamStatisticsMetric AWS API Documentation
+    #
+    class MetricStreamStatisticsMetric < Struct.new(
+      :namespace,
+      :metric_name)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # An input parameter that is required is missing.
     #
     # @!attribute [rw] message
@@ -3929,6 +4056,13 @@ module Aws::CloudWatch
     #
     #   Valid Values: `breaching | notBreaching | ignore | missing`
     #
+    #   <note markdown="1"> Alarms that evaluate metrics in the `AWS/DynamoDB` namespace always
+    #   `ignore` missing data even if you choose a different option for
+    #   `TreatMissingData`. When an `AWS/DynamoDB` metric has missing data,
+    #   alarms that evaluate that metric remain in their current state.
+    #
+    #    </note>
+    #
     #
     #
     #   [1]: https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/AlarmThatSendsEmail.html#alarms-and-missing-data
@@ -4109,6 +4243,17 @@ module Aws::CloudWatch
     #             value: "TagValue", # required
     #           },
     #         ],
+    #         statistics_configurations: [
+    #           {
+    #             include_metrics: [ # required
+    #               {
+    #                 namespace: "Namespace", # required
+    #                 metric_name: "MetricName", # required
+    #               },
+    #             ],
+    #             additional_statistics: ["MetricStreamStatistic"], # required
+    #           },
+    #         ],
     #       }
     #
     # @!attribute [rw] name
@@ -4187,6 +4332,27 @@ module Aws::CloudWatch
     #   [2]: https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_UntagResource.html
     #   @return [Array<Types::Tag>]
     #
+    # @!attribute [rw] statistics_configurations
+    #   By default, a metric stream always sends the `MAX`, `MIN`, `SUM`,
+    #   and `SAMPLECOUNT` statistics for each metric that is streamed. You
+    #   can use this parameter to have the metric stream also send
+    #   additional statistics in the stream. This array can have up to 100
+    #   members.
+    #
+    #   For each entry in this array, you specify one or more metrics and
+    #   the list of additional statistics to stream for those metrics. The
+    #   additional statistics that you can stream depend on the stream's
+    #   `OutputFormat`. If the `OutputFormat` is `json`, you can stream any
+    #   additional statistic that is supported by CloudWatch, listed in [
+    #   CloudWatch statistics definitions][1]. If the `OutputFormat` is
+    #   `opentelemetry0.7`, you can stream percentile statistics such as
+    #   p95, p99.9 and so on.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/Statistics-definitions.html.html
+    #   @return [Array<Types::MetricStreamStatisticsConfiguration>]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/monitoring-2010-08-01/PutMetricStreamInput AWS API Documentation
     #
     class PutMetricStreamInput < Struct.new(
@@ -4196,7 +4362,8 @@ module Aws::CloudWatch
       :firehose_arn,
       :role_arn,
       :output_format,
-      :tags)
+      :tags,
+      :statistics_configurations)
       SENSITIVE = []
       include Aws::Structure
     end

data/lib/aws-sdk-cloudwatch.rb

@@ -52,6 +52,6 @@ require_relative 'aws-sdk-cloudwatch/customizations'
 # @!group service
 module Aws::CloudWatch
 
-  GEM_VERSION = '1.61.0'
+  GEM_VERSION = '1.64.0'
 
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk-cloudwatch
 version: !ruby/object:Gem::Version
-  version: 1.61.0
+  version: 1.64.0
 platform: ruby
 authors:
 - Amazon Web Services
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2022-02-03 00:00:00.000000000 Z
+date: 2022-04-14 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: aws-sdk-core
@@ -19,7 +19,7 @@ dependencies:
         version: '3'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 3.126.0
+        version: 3.127.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
@@ -29,7 +29,7 @@ dependencies:
         version: '3'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 3.126.0
+        version: 3.127.0
 - !ruby/object:Gem::Dependency
   name: aws-sigv4
   requirement: !ruby/object:Gem::Requirement