google-cloud-monitoring 0.34.2 → 0.35.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 4cf2e9e65b679c4389ee6378cb6b56b1965bc39dc45e9fb72b30bf2293e38dd2
-  data.tar.gz: 3723f5a141bf86d52203432b5ce5532ffd087caed26468e0fabee6a22a9f697d
+  metadata.gz: fee166ee580d75f5444f9e5e83666e171ab57011f7052630cd88ad81ea1c07ee
+  data.tar.gz: 53070f57c04736c8253f139ef784cc92595ef338e9088878534a3d47eb124112
 SHA512:
-  metadata.gz: 9aba23bae35b4c5400307abe9c7f28456163104f2b9916b33aa2dae91b948ea25b1214e25721399afffd58d9c3f9b20289b4c482489d28bc461fe5b2110844bb
-  data.tar.gz: 464d802d076fc6cea130b28c5639ec36c6f860f25890d749c08d77271e7df7a8b9982617bf848445d16112895c5c2d7134cd8fd00e19e015cb0feb95a19397e0
+  metadata.gz: 200a7c5e1017f81a1c2a1d17c704b6a928a72bb03994c28d601c061d6be781177838d4663b4582d4ca6d4ba77ad51783abb7d13a69ba9656a4456b7b515a8c28
+  data.tar.gz: 17193c67b1f292123856337ef6dc65baf8afaaba6608ae2aef5e16e931ead582d42c501270becca67833842381245dc32a7b1cbbde75bae2c8e7064a8877dad3

data/lib/google/cloud/monitoring/v3/alert_policy_service_client.rb

@@ -286,7 +286,7 @@ module Google
           # Lists the existing alerting policies for the project.
           #
           # @param name [String]
-          #   The project whose alert policies are to be listed. The format is
+          #   Required. The project whose alert policies are to be listed. The format is
           #
           #       projects/[PROJECT_ID]
           #
@@ -365,7 +365,7 @@ module Google
           # Gets a single alerting policy.
           #
           # @param name [String]
-          #   The alerting policy to retrieve. The format is
+          #   Required. The alerting policy to retrieve. The format is
           #
           #       projects/[PROJECT_ID]/alertPolicies/[ALERT_POLICY_ID]
           # @param options [Google::Gax::CallOptions]
@@ -397,7 +397,7 @@ module Google
           # Creates a new alerting policy.
           #
           # @param name [String]
-          #   The project in which to create the alerting policy. The format is
+          #   Required. The project in which to create the alerting policy. The format is
           #   `projects/[PROJECT_ID]`.
           #
           #   Note that this field names the parent container in which the alerting
@@ -406,7 +406,7 @@ module Google
           #   representation of this name as a prefix but adds a suffix of the form
           #   `/alertPolicies/[POLICY_ID]`, identifying the policy in the container.
           # @param alert_policy [Google::Monitoring::V3::AlertPolicy | Hash]
-          #   The requested alerting policy. You should omit the `name` field in this
+          #   Required. The requested alerting policy. You should omit the `name` field in this
           #   policy. The name will be returned in the new policy, including
           #   a new [ALERT_POLICY_ID] value.
           #   A hash of the same form as `Google::Monitoring::V3::AlertPolicy`
@@ -445,7 +445,7 @@ module Google
           # Deletes an alerting policy.
           #
           # @param name [String]
-          #   The alerting policy to delete. The format is:
+          #   Required. The alerting policy to delete. The format is:
           #
           #       projects/[PROJECT_ID]/alertPolicies/[ALERT_POLICY_ID]
           #

data/lib/google/cloud/monitoring/v3/doc/google/monitoring/v3/alert.rb

@@ -60,10 +60,14 @@ module Google
       #     OR according to the `combiner` field. If the combined conditions evaluate
       #     to true, then an incident is created. A policy can have from one to six
       #     conditions.
+      #     If |condition_time_series_uery_language| is present, it must be the only
+      #     |condition|.
       # @!attribute [rw] combiner
       #   @return [Google::Monitoring::V3::AlertPolicy::ConditionCombinerType]
       #     How to combine the results of multiple conditions to determine if an
       #     incident should be opened.
+      #     If condition_time_series_query_language is present, this must be
+      #     COMBINE_UNSPECIFIED.
       # @!attribute [rw] enabled
       #   @return [Google::Protobuf::BoolValue]
       #     Whether or not the policy is enabled. On write, the default interpretation

data/lib/google/cloud/monitoring/v3/doc/google/monitoring/v3/alert_service.rb

@@ -19,7 +19,7 @@ module Google
       # The protocol for the `CreateAlertPolicy` request.
       # @!attribute [rw] name
       #   @return [String]
-      #     The project in which to create the alerting policy. The format is
+      #     Required. The project in which to create the alerting policy. The format is
       #     `projects/[PROJECT_ID]`.
       #
       #     Note that this field names the parent container in which the alerting
@@ -29,7 +29,7 @@ module Google
       #     `/alertPolicies/[POLICY_ID]`, identifying the policy in the container.
       # @!attribute [rw] alert_policy
       #   @return [Google::Monitoring::V3::AlertPolicy]
-      #     The requested alerting policy. You should omit the `name` field in this
+      #     Required. The requested alerting policy. You should omit the `name` field in this
       #     policy. The name will be returned in the new policy, including
       #     a new [ALERT_POLICY_ID] value.
       class CreateAlertPolicyRequest; end
@@ -37,7 +37,7 @@ module Google
       # The protocol for the `GetAlertPolicy` request.
       # @!attribute [rw] name
       #   @return [String]
-      #     The alerting policy to retrieve. The format is
+      #     Required. The alerting policy to retrieve. The format is
       #
       #         projects/[PROJECT_ID]/alertPolicies/[ALERT_POLICY_ID]
       class GetAlertPolicyRequest; end
@@ -45,7 +45,7 @@ module Google
       # The protocol for the `ListAlertPolicies` request.
       # @!attribute [rw] name
       #   @return [String]
-      #     The project whose alert policies are to be listed. The format is
+      #     Required. The project whose alert policies are to be listed. The format is
       #
       #         projects/[PROJECT_ID]
       #
@@ -125,7 +125,7 @@ module Google
       # The protocol for the `DeleteAlertPolicy` request.
       # @!attribute [rw] name
       #   @return [String]
-      #     The alerting policy to delete. The format is:
+      #     Required. The alerting policy to delete. The format is:
       #
       #         projects/[PROJECT_ID]/alertPolicies/[ALERT_POLICY_ID]
       #

data/lib/google/cloud/monitoring/v3/doc/google/monitoring/v3/common.rb

@@ -64,329 +64,372 @@ module Google
       #     later than the end time.
       class TimeInterval; end
 
-      # Describes how to combine multiple time series to provide different views of
-      # the data.  Aggregation consists of an alignment step on individual time
-      # series (`alignment_period` and `per_series_aligner`) followed by an optional
-      # reduction step of the data across the aligned time series
-      # (`cross_series_reducer` and `group_by_fields`).  For more details, see
-      # [Aggregation](https://cloud.google.com/monitoring/api/learn_more#aggregation).
+      # Describes how to combine multiple time series to provide a different view of
+      # the data.  Aggregation of time series is done in two steps. First, each time
+      # series in the set is _aligned_ to the same time interval boundaries, then the
+      # set of time series is optionally _reduced_ in number.
+      #
+      # Alignment consists of applying the `per_series_aligner` operation
+      # to each time series after its data has been divided into regular
+      # `alignment_period` time intervals. This process takes _all_ of the data
+      # points in an alignment period, applies a mathematical transformation such as
+      # averaging, minimum, maximum, delta, etc., and converts them into a single
+      # data point per period.
+      #
+      # Reduction is when the aligned and transformed time series can optionally be
+      # combined, reducing the number of time series through similar mathematical
+      # transformations. Reduction involves applying a `cross_series_reducer` to
+      # all the time series, optionally sorting the time series into subsets with
+      # `group_by_fields`, and applying the reducer to each subset.
+      #
+      # The raw time series data can contain a huge amount of information from
+      # multiple sources. Alignment and reduction transforms this mass of data into
+      # a more manageable and representative collection of data, for example "the
+      # 95% latency across the average of all tasks in a cluster". This
+      # representative data can be more easily graphed and comprehended, and the
+      # individual time series data is still available for later drilldown. For more
+      # details, see [Aggregating Time
+      # Series](/monitoring/api/v3/metrics#aggregating_time_series).
       # @!attribute [rw] alignment_period
       #   @return [Google::Protobuf::Duration]
-      #     The alignment period for per-{Google::Monitoring::V3::TimeSeries time series}
-      #     alignment. If present, `alignmentPeriod` must be at least 60
-      #     seconds.  After per-time series alignment, each time series will
-      #     contain data points only on the period boundaries. If
-      #     `perSeriesAligner` is not specified or equals `ALIGN_NONE`, then
-      #     this field is ignored. If `perSeriesAligner` is specified and
-      #     does not equal `ALIGN_NONE`, then this field must be defined;
-      #     otherwise an error is returned.
+      #     The `alignment_period` specifies a time interval, in seconds, that is used
+      #     to divide the data in all the
+      #     {Google::Monitoring::V3::TimeSeries time series} into consistent blocks of
+      #     time. This will be done before the per-series aligner can be applied to
+      #     the data.
+      #
+      #     The value must be at least 60 seconds. If a per-series aligner other than
+      #     `ALIGN_NONE` is specified, this field is required or an error is returned.
+      #     If no per-series aligner is specified, or the aligner `ALIGN_NONE` is
+      #     specified, then this field is ignored.
       # @!attribute [rw] per_series_aligner
       #   @return [Google::Monitoring::V3::Aggregation::Aligner]
-      #     The approach to be used to align individual time series. Not all
-      #     alignment functions may be applied to all time series, depending
-      #     on the metric type and value type of the original time
-      #     series. Alignment may change the metric type or the value type of
+      #     An `Aligner` describes how to bring the data points in a single
+      #     time series into temporal alignment. Except for `ALIGN_NONE`, all
+      #     alignments cause all the data points in an `alignment_period` to be
+      #     mathematically grouped together, resulting in a single data point for
+      #     each `alignment_period` with end timestamp at the end of the period.
+      #
+      #     Not all alignment operations may be applied to all time series. The valid
+      #     choices depend on the `metric_kind` and `value_type` of the original time
+      #     series. Alignment can change the `metric_kind` or the `value_type` of
       #     the time series.
       #
       #     Time series data must be aligned in order to perform cross-time
-      #     series reduction. If `crossSeriesReducer` is specified, then
-      #     `perSeriesAligner` must be specified and not equal `ALIGN_NONE`
-      #     and `alignmentPeriod` must be specified; otherwise, an error is
+      #     series reduction. If `cross_series_reducer` is specified, then
+      #     `per_series_aligner` must be specified and not equal to `ALIGN_NONE`
+      #     and `alignment_period` must be specified; otherwise, an error is
       #     returned.
       # @!attribute [rw] cross_series_reducer
       #   @return [Google::Monitoring::V3::Aggregation::Reducer]
-      #     The approach to be used to combine time series. Not all reducer
-      #     functions may be applied to all time series, depending on the
-      #     metric type and the value type of the original time
-      #     series. Reduction may change the metric type of value type of the
-      #     time series.
+      #     The reduction operation to be used to combine time series into a single
+      #     time series, where the value of each data point in the resulting series is
+      #     a function of all the already aligned values in the input time series.
       #
-      #     Time series data must be aligned in order to perform cross-time
-      #     series reduction. If `crossSeriesReducer` is specified, then
-      #     `perSeriesAligner` must be specified and not equal `ALIGN_NONE`
-      #     and `alignmentPeriod` must be specified; otherwise, an error is
-      #     returned.
+      #     Not all reducer operations can be applied to all time series. The valid
+      #     choices depend on the `metric_kind` and the `value_type` of the original
+      #     time series. Reduction can yield a time series with a different
+      #     `metric_kind` or `value_type` than the input time series.
+      #
+      #     Time series data must first be aligned (see `per_series_aligner`) in order
+      #     to perform cross-time series reduction. If `cross_series_reducer` is
+      #     specified, then `per_series_aligner` must be specified, and must not be
+      #     `ALIGN_NONE`. An `alignment_period` must also be specified; otherwise, an
+      #     error is returned.
       # @!attribute [rw] group_by_fields
       #   @return [Array<String>]
-      #     The set of fields to preserve when `crossSeriesReducer` is
-      #     specified. The `groupByFields` determine how the time series are
+      #     The set of fields to preserve when `cross_series_reducer` is
+      #     specified. The `group_by_fields` determine how the time series are
       #     partitioned into subsets prior to applying the aggregation
-      #     function. Each subset contains time series that have the same
+      #     operation. Each subset contains time series that have the same
       #     value for each of the grouping fields. Each individual time
       #     series is a member of exactly one subset. The
-      #     `crossSeriesReducer` is applied to each subset of time series.
+      #     `cross_series_reducer` is applied to each subset of time series.
       #     It is not possible to reduce across different resource types, so
       #     this field implicitly contains `resource.type`.  Fields not
-      #     specified in `groupByFields` are aggregated away.  If
-      #     `groupByFields` is not specified and all the time series have
+      #     specified in `group_by_fields` are aggregated away.  If
+      #     `group_by_fields` is not specified and all the time series have
       #     the same resource type, then the time series are aggregated into
-      #     a single output time series. If `crossSeriesReducer` is not
+      #     a single output time series. If `cross_series_reducer` is not
       #     defined, this field is ignored.
       class Aggregation
-        # The Aligner describes how to bring the data points in a single
-        # time series into temporal alignment.
+        # The `Aligner` specifies the operation that will be applied to the data
+        # points in each alignment period in a time series. Except for
+        # `ALIGN_NONE`, which specifies that no operation be applied, each alignment
+        # operation replaces the set of data values in each alignment period with
+        # a single value: the result of applying the operation to the data values.
+        # An aligned time series has a single data value at the end of each
+        # `alignment_period`.
+        #
+        # An alignment operation can change the data type of the values, too. For
+        # example, if you apply a counting operation to boolean values, the data
+        # `value_type` in the original time series is `BOOLEAN`, but the `value_type`
+        # in the aligned result is `INT64`.
         module Aligner
-          # No alignment. Raw data is returned. Not valid if cross-time
-          # series reduction is requested. The value type of the result is
-          # the same as the value type of the input.
+          # No alignment. Raw data is returned. Not valid if cross-series reduction
+          # is requested. The `value_type` of the result is the same as the
+          # `value_type` of the input.
           ALIGN_NONE = 0
 
-          # Align and convert to delta metric type. This alignment is valid
-          # for cumulative metrics and delta metrics. Aligning an existing
-          # delta metric to a delta metric requires that the alignment
-          # period be increased. The value type of the result is the same
-          # as the value type of the input.
+          # Align and convert to
+          # {Google::Api::MetricDescriptor::MetricKind::DELTA DELTA}.
+          # The output is `delta = y1 - y0`.
           #
-          # One can think of this aligner as a rate but without time units; that
-          # is, the output is conceptually (second_point - first_point).
+          # This alignment is valid for
+          # {Google::Api::MetricDescriptor::MetricKind::CUMULATIVE CUMULATIVE} and
+          # `DELTA` metrics. If the selected alignment period results in periods
+          # with no data, then the aligned value for such a period is created by
+          # interpolation. The `value_type`  of the aligned result is the same as
+          # the `value_type` of the input.
           ALIGN_DELTA = 1
 
-          # Align and convert to a rate. This alignment is valid for
-          # cumulative metrics and delta metrics with numeric values. The output is a
-          # gauge metric with value type
-          # {Google::Api::MetricDescriptor::ValueType::DOUBLE DOUBLE}.
+          # Align and convert to a rate. The result is computed as
+          # `rate = (y1 - y0)/(t1 - t0)`, or "delta over time".
+          # Think of this aligner as providing the slope of the line that passes
+          # through the value at the start and at the end of the `alignment_period`.
           #
-          # One can think of this aligner as conceptually providing the slope of
-          # the line that passes through the value at the start and end of the
-          # window. In other words, this is conceptually ((y1 - y0)/(t1 - t0)),
-          # and the output unit is one that has a "/time" dimension.
+          # This aligner is valid for `CUMULATIVE`
+          # and `DELTA` metrics with numeric values. If the selected alignment
+          # period results in periods with no data, then the aligned value for
+          # such a period is created by interpolation. The output is a `GAUGE`
+          # metric with `value_type` `DOUBLE`.
           #
-          # If, by rate, you are looking for percentage change, see the
-          # `ALIGN_PERCENT_CHANGE` aligner option.
+          # If, by "rate", you mean "percentage change", see the
+          # `ALIGN_PERCENT_CHANGE` aligner instead.
           ALIGN_RATE = 2
 
-          # Align by interpolating between adjacent points around the
-          # period boundary. This alignment is valid for gauge
-          # metrics with numeric values. The value type of the result is the same
-          # as the value type of the input.
+          # Align by interpolating between adjacent points around the alignment
+          # period boundary. This aligner is valid for `GAUGE` metrics with
+          # numeric values. The `value_type` of the aligned result is the same as the
+          # `value_type` of the input.
           ALIGN_INTERPOLATE = 3
 
-          # Align by shifting the oldest data point before the period
-          # boundary to the boundary. This alignment is valid for gauge
-          # metrics. The value type of the result is the same as the
-          # value type of the input.
+          # Align by moving the most recent data point before the end of the
+          # alignment period to the boundary at the end of the alignment
+          # period. This aligner is valid for `GAUGE` metrics. The `value_type` of
+          # the aligned result is the same as the `value_type` of the input.
           ALIGN_NEXT_OLDER = 4
 
-          # Align time series via aggregation. The resulting data point in
-          # the alignment period is the minimum of all data points in the
-          # period. This alignment is valid for gauge and delta metrics with numeric
-          # values. The value type of the result is the same as the value
-          # type of the input.
+          # Align the time series by returning the minimum value in each alignment
+          # period. This aligner is valid for `GAUGE` and `DELTA` metrics with
+          # numeric values. The `value_type` of the aligned result is the same as
+          # the `value_type` of the input.
           ALIGN_MIN = 10
 
-          # Align time series via aggregation. The resulting data point in
-          # the alignment period is the maximum of all data points in the
-          # period. This alignment is valid for gauge and delta metrics with numeric
-          # values. The value type of the result is the same as the value
-          # type of the input.
+          # Align the time series by returning the maximum value in each alignment
+          # period. This aligner is valid for `GAUGE` and `DELTA` metrics with
+          # numeric values. The `value_type` of the aligned result is the same as
+          # the `value_type` of the input.
           ALIGN_MAX = 11
 
-          # Align time series via aggregation. The resulting data point in
-          # the alignment period is the average or arithmetic mean of all
-          # data points in the period. This alignment is valid for gauge and delta
-          # metrics with numeric values. The value type of the output is
-          # {Google::Api::MetricDescriptor::ValueType::DOUBLE DOUBLE}.
+          # Align the time series by returning the mean value in each alignment
+          # period. This aligner is valid for `GAUGE` and `DELTA` metrics with
+          # numeric values. The `value_type` of the aligned result is `DOUBLE`.
           ALIGN_MEAN = 12
 
-          # Align time series via aggregation. The resulting data point in
-          # the alignment period is the count of all data points in the
-          # period. This alignment is valid for gauge and delta metrics with numeric
-          # or Boolean values. The value type of the output is
-          # {Google::Api::MetricDescriptor::ValueType::INT64 INT64}.
+          # Align the time series by returning the number of values in each alignment
+          # period. This aligner is valid for `GAUGE` and `DELTA` metrics with
+          # numeric or Boolean values. The `value_type` of the aligned result is
+          # `INT64`.
           ALIGN_COUNT = 13
 
-          # Align time series via aggregation. The resulting data point in
-          # the alignment period is the sum of all data points in the
-          # period. This alignment is valid for gauge and delta metrics with numeric
-          # and distribution values. The value type of the output is the
-          # same as the value type of the input.
+          # Align the time series by returning the sum of the values in each
+          # alignment period. This aligner is valid for `GAUGE` and `DELTA`
+          # metrics with numeric and distribution values. The `value_type` of the
+          # aligned result is the same as the `value_type` of the input.
           ALIGN_SUM = 14
 
-          # Align time series via aggregation. The resulting data point in
-          # the alignment period is the standard deviation of all data
-          # points in the period. This alignment is valid for gauge and delta metrics
-          # with numeric values. The value type of the output is
-          # {Google::Api::MetricDescriptor::ValueType::DOUBLE DOUBLE}.
+          # Align the time series by returning the standard deviation of the values
+          # in each alignment period. This aligner is valid for `GAUGE` and
+          # `DELTA` metrics with numeric values. The `value_type` of the output is
+          # `DOUBLE`.
           ALIGN_STDDEV = 15
 
-          # Align time series via aggregation. The resulting data point in
-          # the alignment period is the count of True-valued data points in the
-          # period. This alignment is valid for gauge metrics with
-          # Boolean values. The value type of the output is
-          # {Google::Api::MetricDescriptor::ValueType::INT64 INT64}.
+          # Align the time series by returning the number of `True` values in
+          # each alignment period. This aligner is valid for `GAUGE` metrics with
+          # Boolean values. The `value_type` of the output is `INT64`.
           ALIGN_COUNT_TRUE = 16
 
-          # Align time series via aggregation. The resulting data point in
-          # the alignment period is the count of False-valued data points in the
-          # period. This alignment is valid for gauge metrics with
-          # Boolean values. The value type of the output is
-          # {Google::Api::MetricDescriptor::ValueType::INT64 INT64}.
+          # Align the time series by returning the number of `False` values in
+          # each alignment period. This aligner is valid for `GAUGE` metrics with
+          # Boolean values. The `value_type` of the output is `INT64`.
           ALIGN_COUNT_FALSE = 24
 
-          # Align time series via aggregation. The resulting data point in
-          # the alignment period is the fraction of True-valued data points in the
-          # period. This alignment is valid for gauge metrics with Boolean values.
-          # The output value is in the range [0, 1] and has value type
-          # {Google::Api::MetricDescriptor::ValueType::DOUBLE DOUBLE}.
+          # Align the time series by returning the ratio of the number of `True`
+          # values to the total number of values in each alignment period. This
+          # aligner is valid for `GAUGE` metrics with Boolean values. The output
+          # value is in the range [0.0, 1.0] and has `value_type` `DOUBLE`.
           ALIGN_FRACTION_TRUE = 17
 
-          # Align time series via aggregation. The resulting data point in
-          # the alignment period is the 99th percentile of all data
-          # points in the period. This alignment is valid for gauge and delta metrics
-          # with distribution values. The output is a gauge metric with value type
-          # {Google::Api::MetricDescriptor::ValueType::DOUBLE DOUBLE}.
+          # Align the time series by using [percentile
+          # aggregation](https://en.wikipedia.org/wiki/Percentile). The resulting
+          # data point in each alignment period is the 99th percentile of all data
+          # points in the period. This aligner is valid for `GAUGE` and `DELTA`
+          # metrics with distribution values. The output is a `GAUGE` metric with
+          # `value_type` `DOUBLE`.
           ALIGN_PERCENTILE_99 = 18
 
-          # Align time series via aggregation. The resulting data point in
-          # the alignment period is the 95th percentile of all data
-          # points in the period. This alignment is valid for gauge and delta metrics
-          # with distribution values. The output is a gauge metric with value type
-          # {Google::Api::MetricDescriptor::ValueType::DOUBLE DOUBLE}.
+          # Align the time series by using [percentile
+          # aggregation](https://en.wikipedia.org/wiki/Percentile). The resulting
+          # data point in each alignment period is the 95th percentile of all data
+          # points in the period. This aligner is valid for `GAUGE` and `DELTA`
+          # metrics with distribution values. The output is a `GAUGE` metric with
+          # `value_type` `DOUBLE`.
           ALIGN_PERCENTILE_95 = 19
 
-          # Align time series via aggregation. The resulting data point in
-          # the alignment period is the 50th percentile of all data
-          # points in the period. This alignment is valid for gauge and delta metrics
-          # with distribution values. The output is a gauge metric with value type
-          # {Google::Api::MetricDescriptor::ValueType::DOUBLE DOUBLE}.
+          # Align the time series by using [percentile
+          # aggregation](https://en.wikipedia.org/wiki/Percentile). The resulting
+          # data point in each alignment period is the 50th percentile of all data
+          # points in the period. This aligner is valid for `GAUGE` and `DELTA`
+          # metrics with distribution values. The output is a `GAUGE` metric with
+          # `value_type` `DOUBLE`.
           ALIGN_PERCENTILE_50 = 20
 
-          # Align time series via aggregation. The resulting data point in
-          # the alignment period is the 5th percentile of all data
-          # points in the period. This alignment is valid for gauge and delta metrics
-          # with distribution values. The output is a gauge metric with value type
-          # {Google::Api::MetricDescriptor::ValueType::DOUBLE DOUBLE}.
+          # Align the time series by using [percentile
+          # aggregation](https://en.wikipedia.org/wiki/Percentile). The resulting
+          # data point in each alignment period is the 5th percentile of all data
+          # points in the period. This aligner is valid for `GAUGE` and `DELTA`
+          # metrics with distribution values. The output is a `GAUGE` metric with
+          # `value_type` `DOUBLE`.
           ALIGN_PERCENTILE_05 = 21
 
-          # Align and convert to a percentage change. This alignment is valid for
-          # gauge and delta metrics with numeric values. This alignment conceptually
-          # computes the equivalent of "((current - previous)/previous)*100"
-          # where previous value is determined based on the alignmentPeriod.
-          # In the event that previous is 0 the calculated value is infinity with the
-          # exception that if both (current - previous) and previous are 0 the
-          # calculated value is 0.
-          # A 10 minute moving mean is computed at each point of the time window
+          # Align and convert to a percentage change. This aligner is valid for
+          # `GAUGE` and `DELTA` metrics with numeric values. This alignment returns
+          # `((current - previous)/previous) * 100`, where the value of `previous` is
+          # determined based on the `alignment_period`.
+          #
+          # If the values of `current` and `previous` are both 0, then the returned
+          # value is 0. If only `previous` is 0, the returned value is infinity.
+          #
+          # A 10-minute moving mean is computed at each point of the alignment period
           # prior to the above calculation to smooth the metric and prevent false
-          # positives from very short lived spikes.
-          # Only applicable for data that is >= 0. Any values < 0 are treated as
-          # no data. While delta metrics are accepted by this alignment special care
-          # should be taken that the values for the metric will always be positive.
-          # The output is a gauge metric with value type
-          # {Google::Api::MetricDescriptor::ValueType::DOUBLE DOUBLE}.
+          # positives from very short-lived spikes. The moving mean is only
+          # applicable for data whose values are `>= 0`. Any values `< 0` are
+          # treated as a missing datapoint, and are ignored. While `DELTA`
+          # metrics are accepted by this alignment, special care should be taken that
+          # the values for the metric will always be positive. The output is a
+          # `GAUGE` metric with `value_type` `DOUBLE`.
           ALIGN_PERCENT_CHANGE = 23
         end
 
-        # A Reducer describes how to aggregate data points from multiple
-        # time series into a single time series.
+        # A Reducer operation describes how to aggregate data points from multiple
+        # time series into a single time series, where the value of each data point
+        # in the resulting series is a function of all the already aligned values in
+        # the input time series.
         module Reducer
-          # No cross-time series reduction. The output of the aligner is
+          # No cross-time series reduction. The output of the `Aligner` is
           # returned.
           REDUCE_NONE = 0
 
-          # Reduce by computing the mean across time series for each
-          # alignment period. This reducer is valid for delta and
-          # gauge metrics with numeric or distribution values. The value type of the
-          # output is {Google::Api::MetricDescriptor::ValueType::DOUBLE DOUBLE}.
+          # Reduce by computing the mean value across time series for each
+          # alignment period. This reducer is valid for
+          # {Google::Api::MetricDescriptor::MetricKind::DELTA DELTA} and
+          # {Google::Api::MetricDescriptor::MetricKind::GAUGE GAUGE} metrics with
+          # numeric or distribution values. The `value_type` of the output is
+          # {Google::Api::MetricDescriptor::ValueType::DOUBLE DOUBLE}.
           REDUCE_MEAN = 1
 
-          # Reduce by computing the minimum across time series for each
-          # alignment period. This reducer is valid for delta and
-          # gauge metrics with numeric values. The value type of the output
-          # is the same as the value type of the input.
+          # Reduce by computing the minimum value across time series for each
+          # alignment period. This reducer is valid for `DELTA` and `GAUGE` metrics
+          # with numeric values. The `value_type` of the output is the same as the
+          # `value_type` of the input.
           REDUCE_MIN = 2
 
-          # Reduce by computing the maximum across time series for each
-          # alignment period. This reducer is valid for delta and
-          # gauge metrics with numeric values. The value type of the output
-          # is the same as the value type of the input.
+          # Reduce by computing the maximum value across time series for each
+          # alignment period. This reducer is valid for `DELTA` and `GAUGE` metrics
+          # with numeric values. The `value_type` of the output is the same as the
+          # `value_type` of the input.
           REDUCE_MAX = 3
 
           # Reduce by computing the sum across time series for each
-          # alignment period. This reducer is valid for delta and
-          # gauge metrics with numeric and distribution values. The value type of
-          # the output is the same as the value type of the input.
+          # alignment period. This reducer is valid for `DELTA` and `GAUGE` metrics
+          # with numeric and distribution values. The `value_type` of the output is
+          # the same as the `value_type` of the input.
           REDUCE_SUM = 4
 
           # Reduce by computing the standard deviation across time series
-          # for each alignment period. This reducer is valid for delta
-          # and gauge metrics with numeric or distribution values. The value type of
-          # the output is {Google::Api::MetricDescriptor::ValueType::DOUBLE DOUBLE}.
+          # for each alignment period. This reducer is valid for `DELTA` and
+          # `GAUGE` metrics with numeric or distribution values. The `value_type`
+          # of the output is `DOUBLE`.
           REDUCE_STDDEV = 5
 
-          # Reduce by computing the count of data points across time series
-          # for each alignment period. This reducer is valid for delta
-          # and gauge metrics of numeric, Boolean, distribution, and string value
-          # type. The value type of the output is
-          # {Google::Api::MetricDescriptor::ValueType::INT64 INT64}.
+          # Reduce by computing the number of data points across time series
+          # for each alignment period. This reducer is valid for `DELTA` and
+          # `GAUGE` metrics of numeric, Boolean, distribution, and string
+          # `value_type`. The `value_type` of the output is `INT64`.
           REDUCE_COUNT = 6
 
-          # Reduce by computing the count of True-valued data points across time
-          # series for each alignment period. This reducer is valid for delta
-          # and gauge metrics of Boolean value type. The value type of
-          # the output is {Google::Api::MetricDescriptor::ValueType::INT64 INT64}.
+          # Reduce by computing the number of `True`-valued data points across time
+          # series for each alignment period. This reducer is valid for `DELTA` and
+          # `GAUGE` metrics of Boolean `value_type`. The `value_type` of the output
+          # is `INT64`.
           REDUCE_COUNT_TRUE = 7
 
-          # Reduce by computing the count of False-valued data points across time
-          # series for each alignment period. This reducer is valid for delta
-          # and gauge metrics of Boolean value type. The value type of
-          # the output is {Google::Api::MetricDescriptor::ValueType::INT64 INT64}.
+          # Reduce by computing the number of `False`-valued data points across time
+          # series for each alignment period. This reducer is valid for `DELTA` and
+          # `GAUGE` metrics of Boolean `value_type`. The `value_type` of the output
+          # is `INT64`.
           REDUCE_COUNT_FALSE = 15
 
-          # Reduce by computing the fraction of True-valued data points across time
-          # series for each alignment period. This reducer is valid for delta
-          # and gauge metrics of Boolean value type. The output value is in the
-          # range [0, 1] and has value type
-          # {Google::Api::MetricDescriptor::ValueType::DOUBLE DOUBLE}.
+          # Reduce by computing the ratio of the number of `True`-valued data points
+          # to the total number of data points for each alignment period. This
+          # reducer is valid for `DELTA` and `GAUGE` metrics of Boolean `value_type`.
+          # The output value is in the range [0.0, 1.0] and has `value_type`
+          # `DOUBLE`.
           REDUCE_FRACTION_TRUE = 8
 
-          # Reduce by computing 99th percentile of data points across time series
-          # for each alignment period. This reducer is valid for gauge and delta
-          # metrics of numeric and distribution type. The value of the output is
-          # {Google::Api::MetricDescriptor::ValueType::DOUBLE DOUBLE}
+          # Reduce by computing the [99th
+          # percentile](https://en.wikipedia.org/wiki/Percentile) of data points
+          # across time series for each alignment period. This reducer is valid for
+          # `GAUGE` and `DELTA` metrics of numeric and distribution type. The value
+          # of the output is `DOUBLE`.
           REDUCE_PERCENTILE_99 = 9
 
-          # Reduce by computing 95th percentile of data points across time series
-          # for each alignment period. This reducer is valid for gauge and delta
-          # metrics of numeric and distribution type. The value of the output is
-          # {Google::Api::MetricDescriptor::ValueType::DOUBLE DOUBLE}
+          # Reduce by computing the [95th
+          # percentile](https://en.wikipedia.org/wiki/Percentile) of data points
+          # across time series for each alignment period. This reducer is valid for
+          # `GAUGE` and `DELTA` metrics of numeric and distribution type. The value
+          # of the output is `DOUBLE`.
           REDUCE_PERCENTILE_95 = 10
 
-          # Reduce by computing 50th percentile of data points across time series
-          # for each alignment period. This reducer is valid for gauge and delta
-          # metrics of numeric and distribution type. The value of the output is
-          # {Google::Api::MetricDescriptor::ValueType::DOUBLE DOUBLE}
+          # Reduce by computing the [50th
+          # percentile](https://en.wikipedia.org/wiki/Percentile) of data points
+          # across time series for each alignment period. This reducer is valid for
+          # `GAUGE` and `DELTA` metrics of numeric and distribution type. The value
+          # of the output is `DOUBLE`.
           REDUCE_PERCENTILE_50 = 11
 
-          # Reduce by computing 5th percentile of data points across time series
-          # for each alignment period. This reducer is valid for gauge and delta
-          # metrics of numeric and distribution type. The value of the output is
-          # {Google::Api::MetricDescriptor::ValueType::DOUBLE DOUBLE}
+          # Reduce by computing the [5th
+          # percentile](https://en.wikipedia.org/wiki/Percentile) of data points
+          # across time series for each alignment period. This reducer is valid for
+          # `GAUGE` and `DELTA` metrics of numeric and distribution type. The value
+          # of the output is `DOUBLE`.
           REDUCE_PERCENTILE_05 = 12
         end
       end
 
-      # Specifies an ordering relationship on two arguments, here called left and
-      # right.
+      # Specifies an ordering relationship on two arguments, called `left` and
+      # `right`.
       module ComparisonType
         # No ordering relationship is specified.
         COMPARISON_UNSPECIFIED = 0
 
-        # The left argument is greater than the right argument.
+        # True if the left argument is greater than the right argument.
         COMPARISON_GT = 1
 
-        # The left argument is greater than or equal to the right argument.
+        # True if the left argument is greater than or equal to the right argument.
         COMPARISON_GE = 2
 
-        # The left argument is less than the right argument.
+        # True if the left argument is less than the right argument.
         COMPARISON_LT = 3
 
-        # The left argument is less than or equal to the right argument.
+        # True if the left argument is less than or equal to the right argument.
         COMPARISON_LE = 4
 
-        # The left argument is equal to the right argument.
+        # True if the left argument is equal to the right argument.
         COMPARISON_EQ = 5
 
-        # The left argument is not equal to the right argument.
+        # True if the left argument is not equal to the right argument.
         COMPARISON_NE = 6
       end