google-cloud-monitoring-v3 1.2.0 → 1.4.0

data/proto_docs/google/monitoring/v3/alert.rb

@@ -225,21 +225,36 @@ module Google
           # @!attribute [rw] condition_threshold
           #   @return [::Google::Cloud::Monitoring::V3::AlertPolicy::Condition::MetricThreshold]
           #     A condition that compares a time series against a threshold.
+          #
+          #     Note: The following fields are mutually exclusive: `condition_threshold`, `condition_absent`, `condition_matched_log`, `condition_monitoring_query_language`, `condition_prometheus_query_language`, `condition_sql`. If a field in that set is populated, all other fields in the set will automatically be cleared.
           # @!attribute [rw] condition_absent
           #   @return [::Google::Cloud::Monitoring::V3::AlertPolicy::Condition::MetricAbsence]
           #     A condition that checks that a time series continues to
           #     receive new data points.
+          #
+          #     Note: The following fields are mutually exclusive: `condition_absent`, `condition_threshold`, `condition_matched_log`, `condition_monitoring_query_language`, `condition_prometheus_query_language`, `condition_sql`. If a field in that set is populated, all other fields in the set will automatically be cleared.
           # @!attribute [rw] condition_matched_log
           #   @return [::Google::Cloud::Monitoring::V3::AlertPolicy::Condition::LogMatch]
           #     A condition that checks for log messages matching given constraints. If
           #     set, no other conditions can be present.
+          #
+          #     Note: The following fields are mutually exclusive: `condition_matched_log`, `condition_threshold`, `condition_absent`, `condition_monitoring_query_language`, `condition_prometheus_query_language`, `condition_sql`. If a field in that set is populated, all other fields in the set will automatically be cleared.
           # @!attribute [rw] condition_monitoring_query_language
           #   @return [::Google::Cloud::Monitoring::V3::AlertPolicy::Condition::MonitoringQueryLanguageCondition]
           #     A condition that uses the Monitoring Query Language to define
           #     alerts.
+          #
+          #     Note: The following fields are mutually exclusive: `condition_monitoring_query_language`, `condition_threshold`, `condition_absent`, `condition_matched_log`, `condition_prometheus_query_language`, `condition_sql`. If a field in that set is populated, all other fields in the set will automatically be cleared.
           # @!attribute [rw] condition_prometheus_query_language
           #   @return [::Google::Cloud::Monitoring::V3::AlertPolicy::Condition::PrometheusQueryLanguageCondition]
           #     A condition that uses the Prometheus query language to define alerts.
+          #
+          #     Note: The following fields are mutually exclusive: `condition_prometheus_query_language`, `condition_threshold`, `condition_absent`, `condition_matched_log`, `condition_monitoring_query_language`, `condition_sql`. If a field in that set is populated, all other fields in the set will automatically be cleared.
+          # @!attribute [rw] condition_sql
+          #   @return [::Google::Cloud::Monitoring::V3::AlertPolicy::Condition::SqlCondition]
+          #     A condition that periodically evaluates a SQL query result.
+          #
+          #     Note: The following fields are mutually exclusive: `condition_sql`, `condition_threshold`, `condition_absent`, `condition_matched_log`, `condition_monitoring_query_language`, `condition_prometheus_query_language`. If a field in that set is populated, all other fields in the set will automatically be cleared.
           class Condition
             include ::Google::Protobuf::MessageExts
             extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -250,10 +265,14 @@ module Google
             #   @return [::Integer]
             #     The absolute number of time series that must fail
             #     the predicate for the condition to be triggered.
+            #
+            #     Note: The following fields are mutually exclusive: `count`, `percent`. If a field in that set is populated, all other fields in the set will automatically be cleared.
             # @!attribute [rw] percent
             #   @return [::Float]
             #     The percentage of time series that must fail the
             #     predicate for the condition to be triggered.
+            #
+            #     Note: The following fields are mutually exclusive: `percent`, `count`. If a field in that set is populated, all other fields in the set will automatically be cleared.
             class Trigger
               include ::Google::Protobuf::MessageExts
               extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -585,6 +604,17 @@ module Google
             #     [valid Prometheus label
             #     name](https://prometheus.io/docs/concepts/data_model/#metric-names-and-labels).
             #     This field may not exceed 2048 Unicode characters in length.
+            # @!attribute [rw] disable_metric_validation
+            #   @return [::Boolean]
+            #     Optional. Whether to disable metric existence validation for this
+            #     condition.
+            #
+            #     This allows alerting policies to be defined on metrics that do not yet
+            #     exist, improving advanced customer workflows such as configuring
+            #     alerting policies using Terraform.
+            #
+            #     Users with the `monitoring.alertPolicyViewer` role are able to see the
+            #     name of the non-existent metric in the alerting policy condition.
             class PrometheusQueryLanguageCondition
               include ::Google::Protobuf::MessageExts
               extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -599,6 +629,123 @@ module Google
               end
             end
 
+            # A condition that allows alerting policies to be defined using GoogleSQL.
+            # SQL conditions examine a sliding window of logs using GoogleSQL.
+            # Alert policies with SQL conditions may incur additional billing.
+            # @!attribute [rw] query
+            #   @return [::String]
+            #     Required. The Log Analytics SQL query to run, as a string.  The query
+            #     must conform to the required shape. Specifically, the query must not
+            #     try to filter the input by time.  A filter will automatically be
+            #     applied to filter the input so that the query receives all rows
+            #     received since the last time the query was run.
+            #
+            #     For example, the following query extracts all log entries containing an
+            #     HTTP request:
+            #
+            #         SELECT
+            #           timestamp, log_name, severity, http_request, resource, labels
+            #         FROM
+            #           my-project.global._Default._AllLogs
+            #         WHERE
+            #           http_request IS NOT NULL
+            # @!attribute [rw] minutes
+            #   @return [::Google::Cloud::Monitoring::V3::AlertPolicy::Condition::SqlCondition::Minutes]
+            #     Schedule the query to execute every so many minutes.
+            #
+            #     Note: The following fields are mutually exclusive: `minutes`, `hourly`, `daily`. If a field in that set is populated, all other fields in the set will automatically be cleared.
+            # @!attribute [rw] hourly
+            #   @return [::Google::Cloud::Monitoring::V3::AlertPolicy::Condition::SqlCondition::Hourly]
+            #     Schedule the query to execute every so many hours.
+            #
+            #     Note: The following fields are mutually exclusive: `hourly`, `minutes`, `daily`. If a field in that set is populated, all other fields in the set will automatically be cleared.
+            # @!attribute [rw] daily
+            #   @return [::Google::Cloud::Monitoring::V3::AlertPolicy::Condition::SqlCondition::Daily]
+            #     Schedule the query to execute every so many days.
+            #
+            #     Note: The following fields are mutually exclusive: `daily`, `minutes`, `hourly`. If a field in that set is populated, all other fields in the set will automatically be cleared.
+            # @!attribute [rw] row_count_test
+            #   @return [::Google::Cloud::Monitoring::V3::AlertPolicy::Condition::SqlCondition::RowCountTest]
+            #     Test the row count against a threshold.
+            #
+            #     Note: The following fields are mutually exclusive: `row_count_test`, `boolean_test`. If a field in that set is populated, all other fields in the set will automatically be cleared.
+            # @!attribute [rw] boolean_test
+            #   @return [::Google::Cloud::Monitoring::V3::AlertPolicy::Condition::SqlCondition::BooleanTest]
+            #     Test the boolean value in the indicated column.
+            #
+            #     Note: The following fields are mutually exclusive: `boolean_test`, `row_count_test`. If a field in that set is populated, all other fields in the set will automatically be cleared.
+            class SqlCondition
+              include ::Google::Protobuf::MessageExts
+              extend ::Google::Protobuf::MessageExts::ClassMethods
+
+              # Used to schedule the query to run every so many minutes.
+              # @!attribute [rw] periodicity
+              #   @return [::Integer]
+              #     Required. Number of minutes between runs. The interval must be
+              #     greater than or equal to 5 minutes and less than or equal to 1440
+              #     minutes.
+              class Minutes
+                include ::Google::Protobuf::MessageExts
+                extend ::Google::Protobuf::MessageExts::ClassMethods
+              end
+
+              # Used to schedule the query to run every so many hours.
+              # @!attribute [rw] periodicity
+              #   @return [::Integer]
+              #     Required. The number of hours between runs. Must be greater than or
+              #     equal to 1 hour and less than or equal to 48 hours.
+              # @!attribute [rw] minute_offset
+              #   @return [::Integer]
+              #     Optional. The number of minutes after the hour (in UTC) to run the
+              #     query. Must be greater than or equal to 0 minutes and less than or
+              #     equal to 59 minutes.  If left unspecified, then an arbitrary offset
+              #     is used.
+              class Hourly
+                include ::Google::Protobuf::MessageExts
+                extend ::Google::Protobuf::MessageExts::ClassMethods
+              end
+
+              # Used to schedule the query to run every so many days.
+              # @!attribute [rw] periodicity
+              #   @return [::Integer]
+              #     Required. The number of days between runs. Must be greater than or
+              #     equal to 1 day and less than or equal to 31 days.
+              # @!attribute [rw] execution_time
+              #   @return [::Google::Type::TimeOfDay]
+              #     Optional. The time of day (in UTC) at which the query should run. If
+              #     left unspecified, the server picks an arbitrary time of day and runs
+              #     the query at the same time each day.
+              class Daily
+                include ::Google::Protobuf::MessageExts
+                extend ::Google::Protobuf::MessageExts::ClassMethods
+              end
+
+              # A test that checks if the number of rows in the result set
+              # violates some threshold.
+              # @!attribute [rw] comparison
+              #   @return [::Google::Cloud::Monitoring::V3::ComparisonType]
+              #     Required. The comparison to apply between the number of rows returned
+              #     by the query and the threshold.
+              # @!attribute [rw] threshold
+              #   @return [::Integer]
+              #     Required. The value against which to compare the row count.
+              class RowCountTest
+                include ::Google::Protobuf::MessageExts
+                extend ::Google::Protobuf::MessageExts::ClassMethods
+              end
+
+              # A test that uses an alerting result in a boolean column produced by
+              # the SQL query.
+              # @!attribute [rw] column
+              #   @return [::String]
+              #     Required. The name of the column containing the boolean value. If the
+              #     value in a row is NULL, that row is ignored.
+              class BooleanTest
+                include ::Google::Protobuf::MessageExts
+                extend ::Google::Protobuf::MessageExts::ClassMethods
+              end
+            end
+
             # A condition control that determines how metric-threshold conditions
             # are evaluated when data stops arriving.
             # This control doesn't affect metric-absence policies.

data/proto_docs/google/monitoring/v3/common.rb

@@ -25,20 +25,30 @@ module Google
         # @!attribute [rw] bool_value
         #   @return [::Boolean]
         #     A Boolean value: `true` or `false`.
+        #
+        #     Note: The following fields are mutually exclusive: `bool_value`, `int64_value`, `double_value`, `string_value`, `distribution_value`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         # @!attribute [rw] int64_value
         #   @return [::Integer]
         #     A 64-bit integer. Its range is approximately &plusmn;9.2x10<sup>18</sup>.
+        #
+        #     Note: The following fields are mutually exclusive: `int64_value`, `bool_value`, `double_value`, `string_value`, `distribution_value`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         # @!attribute [rw] double_value
         #   @return [::Float]
         #     A 64-bit double-precision floating-point number. Its magnitude
         #     is approximately &plusmn;10<sup>&plusmn;300</sup> and it has 16
         #     significant digits of precision.
+        #
+        #     Note: The following fields are mutually exclusive: `double_value`, `bool_value`, `int64_value`, `string_value`, `distribution_value`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         # @!attribute [rw] string_value
         #   @return [::String]
         #     A variable-length string value.
+        #
+        #     Note: The following fields are mutually exclusive: `string_value`, `bool_value`, `int64_value`, `double_value`, `distribution_value`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         # @!attribute [rw] distribution_value
         #   @return [::Google::Api::Distribution]
         #     A distribution value.
+        #
+        #     Note: The following fields are mutually exclusive: `distribution_value`, `bool_value`, `int64_value`, `double_value`, `string_value`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         class TypedValue
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods

data/proto_docs/google/monitoring/v3/group_service.rb

@@ -37,6 +37,8 @@ module Google
         #
         #     Returns groups whose `parent_name` field contains the group
         #     name.  If no groups have this parent, the results are empty.
+        #
+        #     Note: The following fields are mutually exclusive: `children_of_group`, `ancestors_of_group`, `descendants_of_group`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         # @!attribute [rw] ancestors_of_group
         #   @return [::String]
         #     A group name. The format is:
@@ -47,6 +49,8 @@ module Google
         #     The groups are returned in order, starting with the immediate parent and
         #     ending with the most distant ancestor.  If the specified group has no
         #     immediate parent, the results are empty.
+        #
+        #     Note: The following fields are mutually exclusive: `ancestors_of_group`, `children_of_group`, `descendants_of_group`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         # @!attribute [rw] descendants_of_group
         #   @return [::String]
         #     A group name. The format is:
@@ -56,6 +60,8 @@ module Google
         #     Returns the descendants of the specified group.  This is a superset of
         #     the results returned by the `children_of_group` filter, and includes
         #     children-of-children, and so forth.
+        #
+        #     Note: The following fields are mutually exclusive: `descendants_of_group`, `children_of_group`, `ancestors_of_group`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         # @!attribute [rw] page_size
         #   @return [::Integer]
         #     A positive number that is the maximum number of results to return.

data/proto_docs/google/monitoring/v3/metric.rb

@@ -93,7 +93,14 @@ module Google
         #   @return [::String]
         #     The units in which the metric value is reported. It is only applicable
         #     if the `value_type` is `INT64`, `DOUBLE`, or `DISTRIBUTION`. The `unit`
-        #     defines the representation of the stored metric values.
+        #     defines the representation of the stored metric values. This field can only
+        #     be changed through CreateTimeSeries when it is empty.
+        # @!attribute [rw] description
+        #   @return [::String]
+        #     Input only. A detailed description of the time series that will be
+        #     associated with the
+        #     {::Google::Api::MetricDescriptor google.api.MetricDescriptor} for the metric.
+        #     Once set, this field cannot be changed through CreateTimeSeries.
         class TimeSeries
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -166,12 +173,18 @@ module Google
         # @!attribute [rw] bool_value
         #   @return [::Boolean]
         #     A bool label value.
+        #
+        #     Note: The following fields are mutually exclusive: `bool_value`, `int64_value`, `string_value`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         # @!attribute [rw] int64_value
         #   @return [::Integer]
         #     An int64 label value.
+        #
+        #     Note: The following fields are mutually exclusive: `int64_value`, `bool_value`, `string_value`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         # @!attribute [rw] string_value
         #   @return [::String]
         #     A string label value.
+        #
+        #     Note: The following fields are mutually exclusive: `string_value`, `bool_value`, `int64_value`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         class LabelValue
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods

data/proto_docs/google/monitoring/v3/metric_service.rb

@@ -89,7 +89,7 @@ module Google
         #         projects/[PROJECT_ID_OR_NUMBER]
         # @!attribute [rw] filter
         #   @return [::String]
-        #     If this field is empty, all custom and
+        #     Optional. If this field is empty, all custom and
         #     system-defined metric descriptors are returned.
         #     Otherwise, the [filter](https://cloud.google.com/monitoring/api/v3/filters)
         #     specifies which metric descriptors are to be
@@ -99,14 +99,27 @@ module Google
         #         metric.type = starts_with("custom.googleapis.com/")
         # @!attribute [rw] page_size
         #   @return [::Integer]
-        #     A positive number that is the maximum number of results to return. The
-        #     default and maximum value is 10,000. If a page_size <= 0 or > 10,000 is
-        #     submitted, will instead return a maximum of 10,000 results.
+        #     Optional. A positive number that is the maximum number of results to
+        #     return. The default and maximum value is 10,000. If a page_size <= 0 or >
+        #     10,000 is submitted, will instead return a maximum of 10,000 results.
         # @!attribute [rw] page_token
         #   @return [::String]
-        #     If this field is not empty then it must contain the `nextPageToken` value
-        #     returned by a previous call to this method.  Using this field causes the
-        #     method to return additional results from the previous method call.
+        #     Optional. If this field is not empty then it must contain the
+        #     `nextPageToken` value returned by a previous call to this method.  Using
+        #     this field causes the method to return additional results from the previous
+        #     method call.
+        # @!attribute [rw] active_only
+        #   @return [::Boolean]
+        #     Optional. If true, only metrics and monitored resource types that have
+        #     recent data (within roughly 25 hours) will be included in the response.
+        #      - If a metric descriptor enumerates monitored resource types, only the
+        #        monitored resource types for which the metric type has recent data will
+        #        be included in the returned metric descriptor, and if none of them have
+        #        recent data, the metric descriptor will not be returned.
+        #      - If a metric descriptor does not enumerate the compatible monitored
+        #        resource types, it will be returned only if the metric type has recent
+        #        data for some monitored resource type. The returned descriptor will not
+        #        enumerate any monitored resource types.
         class ListMetricDescriptorsRequest
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -334,7 +347,10 @@ module Google
           end
         end
 
-        # The `QueryTimeSeries` request.
+        # The `QueryTimeSeries` request. For information about the status of
+        # Monitoring Query Language (MQL), see the [MQL deprecation
+        # notice](https://cloud.google.com/stackdriver/docs/deprecations/mql).
+        # @deprecated This message is deprecated and may be removed in the next major version update.
         # @!attribute [rw] name
         #   @return [::String]
         #     Required. The
@@ -360,7 +376,10 @@ module Google
           extend ::Google::Protobuf::MessageExts::ClassMethods
         end
 
-        # The `QueryTimeSeries` response.
+        # The `QueryTimeSeries` response. For information about the status of
+        # Monitoring Query Language (MQL), see the [MQL deprecation
+        # notice](https://cloud.google.com/stackdriver/docs/deprecations/mql).
+        # @deprecated This message is deprecated and may be removed in the next major version update.
         # @!attribute [rw] time_series_descriptor
         #   @return [::Google::Cloud::Monitoring::V3::TimeSeriesDescriptor]
         #     The descriptor for the time series data.

data/proto_docs/google/monitoring/v3/service.rb

@@ -37,35 +37,55 @@ module Google
         # @!attribute [rw] custom
         #   @return [::Google::Cloud::Monitoring::V3::Service::Custom]
         #     Custom service type.
+        #
+        #     Note: The following fields are mutually exclusive: `custom`, `app_engine`, `cloud_endpoints`, `cluster_istio`, `mesh_istio`, `istio_canonical_service`, `cloud_run`, `gke_namespace`, `gke_workload`, `gke_service`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         # @!attribute [rw] app_engine
         #   @return [::Google::Cloud::Monitoring::V3::Service::AppEngine]
         #     Type used for App Engine services.
+        #
+        #     Note: The following fields are mutually exclusive: `app_engine`, `custom`, `cloud_endpoints`, `cluster_istio`, `mesh_istio`, `istio_canonical_service`, `cloud_run`, `gke_namespace`, `gke_workload`, `gke_service`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         # @!attribute [rw] cloud_endpoints
         #   @return [::Google::Cloud::Monitoring::V3::Service::CloudEndpoints]
         #     Type used for Cloud Endpoints services.
+        #
+        #     Note: The following fields are mutually exclusive: `cloud_endpoints`, `custom`, `app_engine`, `cluster_istio`, `mesh_istio`, `istio_canonical_service`, `cloud_run`, `gke_namespace`, `gke_workload`, `gke_service`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         # @!attribute [rw] cluster_istio
         #   @return [::Google::Cloud::Monitoring::V3::Service::ClusterIstio]
         #     Type used for Istio services that live in a Kubernetes cluster.
+        #
+        #     Note: The following fields are mutually exclusive: `cluster_istio`, `custom`, `app_engine`, `cloud_endpoints`, `mesh_istio`, `istio_canonical_service`, `cloud_run`, `gke_namespace`, `gke_workload`, `gke_service`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         # @!attribute [rw] mesh_istio
         #   @return [::Google::Cloud::Monitoring::V3::Service::MeshIstio]
         #     Type used for Istio services scoped to an Istio mesh.
+        #
+        #     Note: The following fields are mutually exclusive: `mesh_istio`, `custom`, `app_engine`, `cloud_endpoints`, `cluster_istio`, `istio_canonical_service`, `cloud_run`, `gke_namespace`, `gke_workload`, `gke_service`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         # @!attribute [rw] istio_canonical_service
         #   @return [::Google::Cloud::Monitoring::V3::Service::IstioCanonicalService]
         #     Type used for canonical services scoped to an Istio mesh.
         #     Metrics for Istio are
         #     [documented here](https://istio.io/latest/docs/reference/config/metrics/)
+        #
+        #     Note: The following fields are mutually exclusive: `istio_canonical_service`, `custom`, `app_engine`, `cloud_endpoints`, `cluster_istio`, `mesh_istio`, `cloud_run`, `gke_namespace`, `gke_workload`, `gke_service`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         # @!attribute [rw] cloud_run
         #   @return [::Google::Cloud::Monitoring::V3::Service::CloudRun]
         #     Type used for Cloud Run services.
+        #
+        #     Note: The following fields are mutually exclusive: `cloud_run`, `custom`, `app_engine`, `cloud_endpoints`, `cluster_istio`, `mesh_istio`, `istio_canonical_service`, `gke_namespace`, `gke_workload`, `gke_service`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         # @!attribute [rw] gke_namespace
         #   @return [::Google::Cloud::Monitoring::V3::Service::GkeNamespace]
         #     Type used for GKE Namespaces.
+        #
+        #     Note: The following fields are mutually exclusive: `gke_namespace`, `custom`, `app_engine`, `cloud_endpoints`, `cluster_istio`, `mesh_istio`, `istio_canonical_service`, `cloud_run`, `gke_workload`, `gke_service`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         # @!attribute [rw] gke_workload
         #   @return [::Google::Cloud::Monitoring::V3::Service::GkeWorkload]
         #     Type used for GKE Workloads.
+        #
+        #     Note: The following fields are mutually exclusive: `gke_workload`, `custom`, `app_engine`, `cloud_endpoints`, `cluster_istio`, `mesh_istio`, `istio_canonical_service`, `cloud_run`, `gke_namespace`, `gke_service`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         # @!attribute [rw] gke_service
         #   @return [::Google::Cloud::Monitoring::V3::Service::GkeService]
         #     Type used for GKE Services (the Kubernetes concept of a service).
+        #
+        #     Note: The following fields are mutually exclusive: `gke_service`, `custom`, `app_engine`, `cloud_endpoints`, `cluster_istio`, `mesh_istio`, `istio_canonical_service`, `cloud_run`, `gke_namespace`, `gke_workload`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         # @!attribute [rw] basic_service
         #   @return [::Google::Cloud::Monitoring::V3::Service::BasicService]
         #     Message that contains the service type and service labels of this service
@@ -351,16 +371,20 @@ module Google
         # @!attribute [rw] goal
         #   @return [::Float]
         #     The fraction of service that must be good in order for this objective to be
-        #     met. `0 < goal <= 0.999`.
+        #     met. `0 < goal <= 0.9999`.
         # @!attribute [rw] rolling_period
         #   @return [::Google::Protobuf::Duration]
         #     A rolling time period, semantically "in the past `<rolling_period>`".
         #     Must be an integer multiple of 1 day no larger than 30 days.
+        #
+        #     Note: The following fields are mutually exclusive: `rolling_period`, `calendar_period`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         # @!attribute [rw] calendar_period
         #   @return [::Google::Type::CalendarPeriod]
         #     A calendar period, semantically "since the start of the current
         #     `<calendar_period>`". At this time, only `DAY`, `WEEK`, `FORTNIGHT`, and
         #     `MONTH` are supported.
+        #
+        #     Note: The following fields are mutually exclusive: `calendar_period`, `rolling_period`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         # @!attribute [rw] user_labels
         #   @return [::Google::Protobuf::Map{::String => ::String}]
         #     Labels which have been used to annotate the service-level objective. Label
@@ -418,12 +442,18 @@ module Google
         # @!attribute [rw] basic_sli
         #   @return [::Google::Cloud::Monitoring::V3::BasicSli]
         #     Basic SLI on a well-known service type.
+        #
+        #     Note: The following fields are mutually exclusive: `basic_sli`, `request_based`, `windows_based`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         # @!attribute [rw] request_based
         #   @return [::Google::Cloud::Monitoring::V3::RequestBasedSli]
         #     Request-based SLIs
+        #
+        #     Note: The following fields are mutually exclusive: `request_based`, `basic_sli`, `windows_based`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         # @!attribute [rw] windows_based
         #   @return [::Google::Cloud::Monitoring::V3::WindowsBasedSli]
         #     Windows-based SLIs
+        #
+        #     Note: The following fields are mutually exclusive: `windows_based`, `basic_sli`, `request_based`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         class ServiceLevelIndicator
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -460,10 +490,14 @@ module Google
         #   @return [::Google::Cloud::Monitoring::V3::BasicSli::AvailabilityCriteria]
         #     Good service is defined to be the count of requests made to this service
         #     that return successfully.
+        #
+        #     Note: The following fields are mutually exclusive: `availability`, `latency`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         # @!attribute [rw] latency
         #   @return [::Google::Cloud::Monitoring::V3::BasicSli::LatencyCriteria]
         #     Good service is defined to be the count of requests made to this service
         #     that are fast enough with respect to `latency.threshold`.
+        #
+        #     Note: The following fields are mutually exclusive: `latency`, `availability`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         class BasicSli
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -503,12 +537,16 @@ module Google
         #   @return [::Google::Cloud::Monitoring::V3::TimeSeriesRatio]
         #     `good_total_ratio` is used when the ratio of `good_service` to
         #     `total_service` is computed from two `TimeSeries`.
+        #
+        #     Note: The following fields are mutually exclusive: `good_total_ratio`, `distribution_cut`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         # @!attribute [rw] distribution_cut
         #   @return [::Google::Cloud::Monitoring::V3::DistributionCut]
         #     `distribution_cut` is used when `good_service` is a count of values
         #     aggregated in a `Distribution` that fall into a good range. The
         #     `total_service` is the total count of all values aggregated in the
         #     `Distribution`.
+        #
+        #     Note: The following fields are mutually exclusive: `distribution_cut`, `good_total_ratio`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         class RequestBasedSli
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -571,17 +609,25 @@ module Google
         #     A [monitoring filter](https://cloud.google.com/monitoring/api/v3/filters)
         #     specifying a `TimeSeries` with `ValueType = BOOL`. The window is good if
         #     any `true` values appear in the window.
+        #
+        #     Note: The following fields are mutually exclusive: `good_bad_metric_filter`, `good_total_ratio_threshold`, `metric_mean_in_range`, `metric_sum_in_range`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         # @!attribute [rw] good_total_ratio_threshold
         #   @return [::Google::Cloud::Monitoring::V3::WindowsBasedSli::PerformanceThreshold]
         #     A window is good if its `performance` is high enough.
+        #
+        #     Note: The following fields are mutually exclusive: `good_total_ratio_threshold`, `good_bad_metric_filter`, `metric_mean_in_range`, `metric_sum_in_range`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         # @!attribute [rw] metric_mean_in_range
         #   @return [::Google::Cloud::Monitoring::V3::WindowsBasedSli::MetricRange]
         #     A window is good if the metric's value is in a good range, averaged
         #     across returned streams.
+        #
+        #     Note: The following fields are mutually exclusive: `metric_mean_in_range`, `good_bad_metric_filter`, `good_total_ratio_threshold`, `metric_sum_in_range`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         # @!attribute [rw] metric_sum_in_range
         #   @return [::Google::Cloud::Monitoring::V3::WindowsBasedSli::MetricRange]
         #     A window is good if the metric's value is in a good range, summed across
         #     returned streams.
+        #
+        #     Note: The following fields are mutually exclusive: `metric_sum_in_range`, `good_bad_metric_filter`, `good_total_ratio_threshold`, `metric_mean_in_range`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         # @!attribute [rw] window_period
         #   @return [::Google::Protobuf::Duration]
         #     Duration over which window quality is evaluated. Must be an integer
@@ -595,9 +641,13 @@ module Google
           # @!attribute [rw] performance
           #   @return [::Google::Cloud::Monitoring::V3::RequestBasedSli]
           #     `RequestBasedSli` to evaluate to judge window quality.
+          #
+          #     Note: The following fields are mutually exclusive: `performance`, `basic_sli_performance`. If a field in that set is populated, all other fields in the set will automatically be cleared.
           # @!attribute [rw] basic_sli_performance
           #   @return [::Google::Cloud::Monitoring::V3::BasicSli]
           #     `BasicSli` to evaluate to judge window quality.
+          #
+          #     Note: The following fields are mutually exclusive: `basic_sli_performance`, `performance`. If a field in that set is populated, all other fields in the set will automatically be cleared.
           # @!attribute [rw] threshold
           #   @return [::Float]
           #     If window `performance >= threshold`, the window is counted as good.

data/proto_docs/google/monitoring/v3/uptime.rb

@@ -139,18 +139,28 @@ module Google
         #       `k8s_service`
         #       `servicedirectory_service`
         #       `cloud_run_revision`
+        #
+        #     Note: The following fields are mutually exclusive: `monitored_resource`, `resource_group`, `synthetic_monitor`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         # @!attribute [rw] resource_group
         #   @return [::Google::Cloud::Monitoring::V3::UptimeCheckConfig::ResourceGroup]
         #     The group resource associated with the configuration.
+        #
+        #     Note: The following fields are mutually exclusive: `resource_group`, `monitored_resource`, `synthetic_monitor`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         # @!attribute [rw] synthetic_monitor
         #   @return [::Google::Cloud::Monitoring::V3::SyntheticMonitorTarget]
         #     Specifies a Synthetic Monitor to invoke.
+        #
+        #     Note: The following fields are mutually exclusive: `synthetic_monitor`, `monitored_resource`, `resource_group`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         # @!attribute [rw] http_check
         #   @return [::Google::Cloud::Monitoring::V3::UptimeCheckConfig::HttpCheck]
         #     Contains information needed to make an HTTP or HTTPS check.
+        #
+        #     Note: The following fields are mutually exclusive: `http_check`, `tcp_check`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         # @!attribute [rw] tcp_check
         #   @return [::Google::Cloud::Monitoring::V3::UptimeCheckConfig::TcpCheck]
         #     Contains information needed to make a TCP check.
+        #
+        #     Note: The following fields are mutually exclusive: `tcp_check`, `http_check`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         # @!attribute [rw] period
         #   @return [::Google::Protobuf::Duration]
         #     How often, in seconds, the Uptime check is performed.
@@ -347,9 +357,13 @@ module Google
             # @!attribute [rw] status_value
             #   @return [::Integer]
             #     A status code to accept.
+            #
+            #     Note: The following fields are mutually exclusive: `status_value`, `status_class`. If a field in that set is populated, all other fields in the set will automatically be cleared.
             # @!attribute [rw] status_class
             #   @return [::Google::Cloud::Monitoring::V3::UptimeCheckConfig::HttpCheck::ResponseStatusCode::StatusClass]
             #     A class of status codes to accept.
+            #
+            #     Note: The following fields are mutually exclusive: `status_class`, `status_value`. If a field in that set is populated, all other fields in the set will automatically be cleared.
             class ResponseStatusCode
               include ::Google::Protobuf::MessageExts
               extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -379,10 +393,11 @@ module Google
               end
             end
 
-            # Contains information needed for generating an
+            # Contains information needed for generating either an
             # [OpenID Connect
-            # token](https://developers.google.com/identity/protocols/OpenIDConnect).
-            # The OIDC token will be generated for the Monitoring service agent service
+            # token](https://developers.google.com/identity/protocols/OpenIDConnect) or
+            # [OAuth token](https://developers.google.com/identity/protocols/oauth2).
+            # The token will be generated for the Monitoring service agent service
             # account.
             # @!attribute [rw] type
             #   @return [::Google::Cloud::Monitoring::V3::UptimeCheckConfig::HttpCheck::ServiceAgentAuthentication::ServiceAgentAuthenticationType]

data/proto_docs/google/protobuf/struct.rb

@@ -53,21 +53,33 @@ module Google
     # @!attribute [rw] null_value
     #   @return [::Google::Protobuf::NullValue]
     #     Represents a null value.
+    #
+    #     Note: The following fields are mutually exclusive: `null_value`, `number_value`, `string_value`, `bool_value`, `struct_value`, `list_value`. If a field in that set is populated, all other fields in the set will automatically be cleared.
     # @!attribute [rw] number_value
     #   @return [::Float]
     #     Represents a double value.
+    #
+    #     Note: The following fields are mutually exclusive: `number_value`, `null_value`, `string_value`, `bool_value`, `struct_value`, `list_value`. If a field in that set is populated, all other fields in the set will automatically be cleared.
     # @!attribute [rw] string_value
     #   @return [::String]
     #     Represents a string value.
+    #
+    #     Note: The following fields are mutually exclusive: `string_value`, `null_value`, `number_value`, `bool_value`, `struct_value`, `list_value`. If a field in that set is populated, all other fields in the set will automatically be cleared.
     # @!attribute [rw] bool_value
     #   @return [::Boolean]
     #     Represents a boolean value.
+    #
+    #     Note: The following fields are mutually exclusive: `bool_value`, `null_value`, `number_value`, `string_value`, `struct_value`, `list_value`. If a field in that set is populated, all other fields in the set will automatically be cleared.
     # @!attribute [rw] struct_value
     #   @return [::Google::Protobuf::Struct]
     #     Represents a structured value.
+    #
+    #     Note: The following fields are mutually exclusive: `struct_value`, `null_value`, `number_value`, `string_value`, `bool_value`, `list_value`. If a field in that set is populated, all other fields in the set will automatically be cleared.
     # @!attribute [rw] list_value
     #   @return [::Google::Protobuf::ListValue]
     #     Represents a repeated `Value`.
+    #
+    #     Note: The following fields are mutually exclusive: `list_value`, `null_value`, `number_value`, `string_value`, `bool_value`, `struct_value`. If a field in that set is populated, all other fields in the set will automatically be cleared.
     class Value
       include ::Google::Protobuf::MessageExts
       extend ::Google::Protobuf::MessageExts::ClassMethods