google-apis-monitoring_v3 0.33.0 → 0.64.0

data/lib/google/apis/monitoring_v3/classes.rb

@@ -140,6 +140,8 @@ module Google
         # 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_query_language is present, it must be the only condition.
+        # If condition_monitoring_query_language is present, it must be the only
+        # condition.
         # Corresponds to the JSON property `conditions`
         # @return [Array<Google::Apis::MonitoringV3::Condition>]
         attr_accessor :conditions
@@ -152,12 +154,17 @@ module Google
         # A short name or phrase used to identify the policy in dashboards,
         # notifications, and incidents. To avoid confusion, don't use the same display
         # name for multiple policies in the same project. The name is limited to 512
-        # Unicode characters.
+        # Unicode characters.The convention for the display_name of a
+        # PrometheusQueryLanguageCondition is "`rule group name`/`alert name`", where
+        # the `rule group name` and `alert name` should be taken from the corresponding
+        # Prometheus configuration file. This convention is not enforced. In any case
+        # the display_name is not a unique key of the AlertPolicy.
         # Corresponds to the JSON property `displayName`
         # @return [String]
         attr_accessor :display_name
       
-        # A content string and a MIME type that describes the content string's format.
+        # Documentation that is included in the notifications and incidents pertaining
+        # to this policy.
         # Corresponds to the JSON property `documentation`
         # @return [Google::Apis::MonitoringV3::Documentation]
         attr_accessor :documentation
@@ -196,11 +203,22 @@ module Google
         # @return [Array<String>]
         attr_accessor :notification_channels
       
+        # Optional. The severity of an alert policy indicates how important incidents
+        # generated by that policy are. The severity level will be displayed on the
+        # Incident detail page and in notifications.
+        # Corresponds to the JSON property `severity`
+        # @return [String]
+        attr_accessor :severity
+      
         # User-supplied key/value data to be used for organizing and identifying the
         # AlertPolicy objects.The field can contain up to 64 entries. Each key and value
         # is limited to 63 Unicode characters or 128 bytes, whichever is smaller. Labels
         # and values can contain only lowercase letters, numerals, underscores, and
-        # dashes. Keys must begin with a letter.
+        # dashes. Keys must begin with a letter.Note that Prometheus `alert name` is a
+        # valid Prometheus label names (https://prometheus.io/docs/concepts/data_model/#
+        # metric-names-and-labels), whereas Prometheus `rule group` is an unrestricted
+        # UTF-8 string. This means that they cannot be stored as-is in user labels,
+        # because they may contain characters that are not allowed in user-label values.
         # Corresponds to the JSON property `userLabels`
         # @return [Hash<String,String>]
         attr_accessor :user_labels
@@ -231,6 +249,7 @@ module Google
           @mutation_record = args[:mutation_record] if args.key?(:mutation_record)
           @name = args[:name] if args.key?(:name)
           @notification_channels = args[:notification_channels] if args.key?(:notification_channels)
+          @severity = args[:severity] if args.key?(:severity)
           @user_labels = args[:user_labels] if args.key?(:user_labels)
           @validity = args[:validity] if args.key?(:validity)
         end
@@ -247,6 +266,11 @@ module Google
         # @return [String]
         attr_accessor :auto_close
       
+        # Control how notifications will be sent out, on a per-channel basis.
+        # Corresponds to the JSON property `notificationChannelStrategy`
+        # @return [Array<Google::Apis::MonitoringV3::NotificationChannelStrategy>]
+        attr_accessor :notification_channel_strategy
+      
         # Control over the rate of notifications sent to this alert policy's
         # notification channels.
         # Corresponds to the JSON property `notificationRateLimit`
@@ -260,6 +284,7 @@ module Google
         # Update properties of this object
         def update!(**args)
           @auto_close = args[:auto_close] if args.key?(:auto_close)
+          @notification_channel_strategy = args[:notification_channel_strategy] if args.key?(:notification_channel_strategy)
           @notification_rate_limit = args[:notification_rate_limit] if args.key?(:notification_rate_limit)
         end
       end
@@ -325,6 +350,39 @@ module Google
         end
       end
       
+      # A well-known service type, defined by its service type and service labels.
+      # Documentation and examples here (https://cloud.google.com/stackdriver/docs/
+      # solutions/slo-monitoring/api/api-structures#basic-svc-w-basic-sli).
+      class BasicService
+        include Google::Apis::Core::Hashable
+      
+        # Labels that specify the resource that emits the monitoring data which is used
+        # for SLO reporting of this Service. Documentation and valid values for given
+        # service types here (https://cloud.google.com/stackdriver/docs/solutions/slo-
+        # monitoring/api/api-structures#basic-svc-w-basic-sli).
+        # Corresponds to the JSON property `serviceLabels`
+        # @return [Hash<String,String>]
+        attr_accessor :service_labels
+      
+        # The type of service that this basic service defines, e.g. APP_ENGINE service
+        # type. Documentation and valid values here (https://cloud.google.com/
+        # stackdriver/docs/solutions/slo-monitoring/api/api-structures#basic-svc-w-basic-
+        # sli).
+        # Corresponds to the JSON property `serviceType`
+        # @return [String]
+        attr_accessor :service_type
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @service_labels = args[:service_labels] if args.key?(:service_labels)
+          @service_type = args[:service_type] if args.key?(:service_type)
+        end
+      end
+      
       # An SLI measuring performance on a well-known service type. Performance will be
       # computed on the basis of pre-defined metrics. The type of the service_resource
       # determines the metrics to use and the service_resource.labels and
@@ -412,7 +470,7 @@ module Google
         # proportional to the value of the lower bound. Each bucket represents a
         # constant relative uncertainty on a specific value in the bucket.There are
         # num_finite_buckets + 2 (= N) buckets. Bucket i has the following boundaries:
-        # Upper bound (0 <= i < N-1): scale * (growth_factor ^ i). Lower bound (1 <= i <
+        # Upper bound (0 <= i < N-1): scale * (growth_factor ^ i).Lower bound (1 <= i <
         # N): scale * (growth_factor ^ (i - 1)).
         # Corresponds to the JSON property `exponentialBuckets`
         # @return [Google::Apis::MonitoringV3::Exponential]
@@ -422,7 +480,7 @@ module Google
         # overflow and underflow). Each bucket represents a constant absolute
         # uncertainty on the specific value in the bucket.There are num_finite_buckets +
         # 2 (= N) buckets. Bucket i has the following boundaries:Upper bound (0 <= i < N-
-        # 1): offset + (width * i). Lower bound (1 <= i < N): offset + (width * (i - 1)).
+        # 1): offset + (width * i).Lower bound (1 <= i < N): offset + (width * (i - 1)).
         # Corresponds to the JSON property `linearBuckets`
         # @return [Google::Apis::MonitoringV3::Linear]
         attr_accessor :linear_buckets
@@ -460,6 +518,41 @@ module Google
         end
       end
       
+      # A Synthetic Monitor deployed to a Cloud Functions V2 instance.
+      class CloudFunctionV2Target
+        include Google::Apis::Core::Hashable
+      
+        # An object representing a resource that can be used for monitoring, logging,
+        # billing, or other purposes. Examples include virtual machine instances,
+        # databases, and storage devices such as disks. The type field identifies a
+        # MonitoredResourceDescriptor object that describes the resource's schema.
+        # Information in the labels field identifies the actual resource and its
+        # attributes according to the schema. For example, a particular Compute Engine
+        # VM instance could be represented by the following object, because the
+        # MonitoredResourceDescriptor for "gce_instance" has labels "project_id", "
+        # instance_id" and "zone": ` "type": "gce_instance", "labels": ` "project_id": "
+        # my-project", "instance_id": "12345678901234", "zone": "us-central1-a" ``
+        # Corresponds to the JSON property `cloudRunRevision`
+        # @return [Google::Apis::MonitoringV3::MonitoredResource]
+        attr_accessor :cloud_run_revision
+      
+        # Required. Fully qualified GCFv2 resource name i.e. projects/`project`/
+        # locations/`location`/functions/`function` Required.
+        # Corresponds to the JSON property `name`
+        # @return [String]
+        attr_accessor :name
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @cloud_run_revision = args[:cloud_run_revision] if args.key?(:cloud_run_revision)
+          @name = args[:name] if args.key?(:name)
+        end
+      end
+      
       # Cloud Run service. Learn more at https://cloud.google.com/run.
       class CloudRun
         include Google::Apis::Core::Hashable
@@ -723,6 +816,32 @@ module Google
         # @return [Google::Apis::MonitoringV3::MonitoringQueryLanguageCondition]
         attr_accessor :condition_monitoring_query_language
       
+        # A condition type that allows alert policies to be defined using Prometheus
+        # Query Language (PromQL) (https://prometheus.io/docs/prometheus/latest/querying/
+        # basics/).The PrometheusQueryLanguageCondition message contains information
+        # from a Prometheus alerting rule and its associated rule group.A Prometheus
+        # alerting rule is described here (https://prometheus.io/docs/prometheus/latest/
+        # configuration/alerting_rules/). The semantics of a Prometheus alerting rule is
+        # described here (https://prometheus.io/docs/prometheus/latest/configuration/
+        # recording_rules/#rule).A Prometheus rule group is described here (https://
+        # prometheus.io/docs/prometheus/latest/configuration/recording_rules/). The
+        # semantics of a Prometheus rule group is described here (https://prometheus.io/
+        # docs/prometheus/latest/configuration/recording_rules/#rule_group).Because
+        # Cloud Alerting has no representation of a Prometheus rule group resource, we
+        # must embed the information of the parent rule group inside each of the
+        # conditions that refer to it. We must also update the contents of all
+        # Prometheus alerts in case the information of their rule group changes.The
+        # PrometheusQueryLanguageCondition protocol buffer combines the information of
+        # the corresponding rule group and alerting rule. The structure of the
+        # PrometheusQueryLanguageCondition protocol buffer does NOT mimic the structure
+        # of the Prometheus rule group and alerting rule YAML declarations. The
+        # PrometheusQueryLanguageCondition protocol buffer may change in the future to
+        # support future rule group and/or alerting rule features. There are no new such
+        # features at the present time (2023-06-26).
+        # Corresponds to the JSON property `conditionPrometheusQueryLanguage`
+        # @return [Google::Apis::MonitoringV3::PrometheusQueryLanguageCondition]
+        attr_accessor :condition_prometheus_query_language
+      
         # A condition type that compares a collection of time series against a threshold.
         # Corresponds to the JSON property `conditionThreshold`
         # @return [Google::Apis::MonitoringV3::MetricThreshold]
@@ -762,6 +881,7 @@ module Google
           @condition_absent = args[:condition_absent] if args.key?(:condition_absent)
           @condition_matched_log = args[:condition_matched_log] if args.key?(:condition_matched_log)
           @condition_monitoring_query_language = args[:condition_monitoring_query_language] if args.key?(:condition_monitoring_query_language)
+          @condition_prometheus_query_language = args[:condition_prometheus_query_language] if args.key?(:condition_prometheus_query_language)
           @condition_threshold = args[:condition_threshold] if args.key?(:condition_threshold)
           @display_name = args[:display_name] if args.key?(:display_name)
           @name = args[:name] if args.key?(:name)
@@ -932,8 +1052,33 @@ module Google
         end
       end
       
-      # Custom view of service telemetry. Currently a place-holder pending final
-      # design.
+      # Criteria specific to the AlertPolicys that this Snooze applies to. The Snooze
+      # will suppress alerts that come from one of the AlertPolicys whose names are
+      # supplied.
+      class Criteria
+        include Google::Apis::Core::Hashable
+      
+        # The specific AlertPolicy names for the alert that should be snoozed. The
+        # format is: projects/[PROJECT_ID_OR_NUMBER]/alertPolicies/[POLICY_ID] There is
+        # a limit of 16 policies per snooze. This limit is checked during snooze
+        # creation.
+        # Corresponds to the JSON property `policies`
+        # @return [Array<String>]
+        attr_accessor :policies
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @policies = args[:policies] if args.key?(:policies)
+        end
+      end
+      
+      # Use a custom service to designate a service that you want to monitor when none
+      # of the other service types (like App Engine, Cloud Run, or a GKE type) matches
+      # your intended service.
       class Custom
         include Google::Apis::Core::Hashable
       
@@ -1067,19 +1212,26 @@ module Google
         end
       end
       
-      # A content string and a MIME type that describes the content string's format.
+      # Documentation that is included in the notifications and incidents pertaining
+      # to this policy.
       class Documentation
         include Google::Apis::Core::Hashable
       
-        # The text of the documentation, interpreted according to mime_type. The content
+        # The body of the documentation, interpreted according to mime_type. The content
         # may not exceed 8,192 Unicode characters and may not exceed more than 10,240
         # bytes when encoded in UTF-8 format, whichever is smaller. This text can be
         # templatized by using variables (https://cloud.google.com/monitoring/alerts/doc-
-        # variables).
+        # variables#doc-vars).
         # Corresponds to the JSON property `content`
         # @return [String]
         attr_accessor :content
       
+        # Optional. Links to content such as playbooks, repositories, and other
+        # resources. This field can contain up to 3 entries.
+        # Corresponds to the JSON property `links`
+        # @return [Array<Google::Apis::MonitoringV3::Link>]
+        attr_accessor :links
+      
         # The format of the content field. Presently, only the value "text/markdown" is
         # supported. See Markdown (https://en.wikipedia.org/wiki/Markdown) for more
         # information.
@@ -1087,6 +1239,21 @@ module Google
         # @return [String]
         attr_accessor :mime_type
       
+        # Optional. The subject line of the notification. The subject line may not
+        # exceed 10,240 bytes. In notifications generated by this policy, the contents
+        # of the subject line after variable expansion will be truncated to 255 bytes or
+        # shorter at the latest UTF-8 character boundary. The 255-byte limit is
+        # recommended by this thread (https://stackoverflow.com/questions/1592291/what-
+        # is-the-email-subject-length-limit). It is both the limit imposed by some third-
+        # party ticketing products and it is common to define textual fields in
+        # databases as VARCHAR(255).The contents of the subject line can be templatized
+        # by using variables (https://cloud.google.com/monitoring/alerts/doc-variables#
+        # doc-vars). If this field is missing or empty, a default subject line will be
+        # generated.
+        # Corresponds to the JSON property `subject`
+        # @return [String]
+        attr_accessor :subject
+      
         def initialize(**args)
            update!(**args)
         end
@@ -1094,7 +1261,9 @@ module Google
         # Update properties of this object
         def update!(**args)
           @content = args[:content] if args.key?(:content)
+          @links = args[:links] if args.key?(:links)
           @mime_type = args[:mime_type] if args.key?(:mime_type)
+          @subject = args[:subject] if args.key?(:subject)
         end
       end
       
@@ -1243,7 +1412,7 @@ module Google
       # proportional to the value of the lower bound. Each bucket represents a
       # constant relative uncertainty on a specific value in the bucket.There are
       # num_finite_buckets + 2 (= N) buckets. Bucket i has the following boundaries:
-      # Upper bound (0 <= i < N-1): scale * (growth_factor ^ i). Lower bound (1 <= i <
+      # Upper bound (0 <= i < N-1): scale * (growth_factor ^ i).Lower bound (1 <= i <
       # N): scale * (growth_factor ^ (i - 1)).
       class Exponential
         include Google::Apis::Core::Hashable
@@ -1351,6 +1520,30 @@ module Google
         end
       end
       
+      # Options used when forecasting the time series and testing the predicted value
+      # against the threshold.
+      class ForecastOptions
+        include Google::Apis::Core::Hashable
+      
+        # Required. The length of time into the future to forecast whether a time series
+        # will violate the threshold. If the predicted value is found to violate the
+        # threshold, and the violation is observed in all forecasts made for the
+        # configured duration, then the time series is considered to be failing. The
+        # forecast horizon can range from 1 hour to 60 hours.
+        # Corresponds to the JSON property `forecastHorizon`
+        # @return [String]
+        attr_accessor :forecast_horizon
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @forecast_horizon = args[:forecast_horizon] if args.key?(:forecast_horizon)
+        end
+      end
+      
       # The GetNotificationChannelVerificationCode request.
       class GetNotificationChannelVerificationCodeRequest
         include Google::Apis::Core::Hashable
@@ -1684,6 +1877,15 @@ module Google
         # @return [String]
         attr_accessor :content_type
       
+        # A user provided content type header to use for the check. The invalid
+        # configurations outlined in the content_type field apply to custom_content_type,
+        # as well as the following: 1. content_type is URL_ENCODED and
+        # custom_content_type is set. 2. content_type is USER_PROVIDED and
+        # custom_content_type is not set.
+        # Corresponds to the JSON property `customContentType`
+        # @return [String]
+        attr_accessor :custom_content_type
+      
         # The list of headers to send as part of the Uptime check request. If two
         # headers have the same key and different values, they should be entered as a
         # single header, with the value being a comma-separated list of all the desired
@@ -1733,6 +1935,14 @@ module Google
         # @return [String]
         attr_accessor :request_method
       
+        # Contains information needed for generating either an OpenID Connect 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.
+        # Corresponds to the JSON property `serviceAgentAuthentication`
+        # @return [Google::Apis::MonitoringV3::ServiceAgentAuthentication]
+        attr_accessor :service_agent_authentication
+      
         # If true, use HTTPS instead of HTTP to run the check.
         # Corresponds to the JSON property `useSsl`
         # @return [Boolean]
@@ -1757,12 +1967,14 @@ module Google
           @auth_info = args[:auth_info] if args.key?(:auth_info)
           @body = args[:body] if args.key?(:body)
           @content_type = args[:content_type] if args.key?(:content_type)
+          @custom_content_type = args[:custom_content_type] if args.key?(:custom_content_type)
           @headers = args[:headers] if args.key?(:headers)
           @mask_headers = args[:mask_headers] if args.key?(:mask_headers)
           @path = args[:path] if args.key?(:path)
           @ping_config = args[:ping_config] if args.key?(:ping_config)
           @port = args[:port] if args.key?(:port)
           @request_method = args[:request_method] if args.key?(:request_method)
+          @service_agent_authentication = args[:service_agent_authentication] if args.key?(:service_agent_authentication)
           @use_ssl = args[:use_ssl] if args.key?(:use_ssl)
           @validate_ssl = args[:validate_ssl] if args.key?(:validate_ssl)
         end
@@ -1983,7 +2195,7 @@ module Google
       # overflow and underflow). Each bucket represents a constant absolute
       # uncertainty on the specific value in the bucket.There are num_finite_buckets +
       # 2 (= N) buckets. Bucket i has the following boundaries:Upper bound (0 <= i < N-
-      # 1): offset + (width * i). Lower bound (1 <= i < N): offset + (width * (i - 1)).
+      # 1): offset + (width * i).Lower bound (1 <= i < N): offset + (width * (i - 1)).
       class Linear
         include Google::Apis::Core::Hashable
       
@@ -2014,6 +2226,35 @@ module Google
         end
       end
       
+      # Links to content such as playbooks, repositories, and other resources.
+      class Link
+        include Google::Apis::Core::Hashable
+      
+        # A short display name for the link. The display name must not be empty or
+        # exceed 63 characters. Example: "playbook".
+        # Corresponds to the JSON property `displayName`
+        # @return [String]
+        attr_accessor :display_name
+      
+        # The url of a webpage. A url can be templatized by using variables in the path
+        # or the query parameters. The total length of a URL should not exceed 2083
+        # characters before and after variable expansion. Example: "https://my_domain.
+        # com/playbook?name=$`resource.name`"
+        # Corresponds to the JSON property `url`
+        # @return [String]
+        attr_accessor :url
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @display_name = args[:display_name] if args.key?(:display_name)
+          @url = args[:url] if args.key?(:url)
+        end
+      end
+      
       # The protocol for the ListAlertPolicies response.
       class ListAlertPoliciesResponse
         include Google::Apis::Core::Hashable
@@ -2280,6 +2521,32 @@ module Google
         end
       end
       
+      # The results of a successful ListSnoozes call, containing the matching Snoozes.
+      class ListSnoozesResponse
+        include Google::Apis::Core::Hashable
+      
+        # Page token for repeated calls to ListSnoozes, to fetch additional pages of
+        # results. If this is empty or missing, there are no more pages.
+        # Corresponds to the JSON property `nextPageToken`
+        # @return [String]
+        attr_accessor :next_page_token
+      
+        # Snoozes matching this list call.
+        # Corresponds to the JSON property `snoozes`
+        # @return [Array<Google::Apis::MonitoringV3::Snooze>]
+        attr_accessor :snoozes
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @next_page_token = args[:next_page_token] if args.key?(:next_page_token)
+          @snoozes = args[:snoozes] if args.key?(:snoozes)
+        end
+      end
+      
       # The ListTimeSeries response.
       class ListTimeSeriesResponse
         include Google::Apis::Core::Hashable
@@ -2814,7 +3081,8 @@ module Google
         attr_accessor :duration
       
         # A condition control that determines how metric-threshold conditions are
-        # evaluated when data stops arriving.
+        # evaluated when data stops arriving. To use this control, the value of the
+        # duration field must be greater than or equal to 60 seconds.
         # Corresponds to the JSON property `evaluationMissingData`
         # @return [String]
         attr_accessor :evaluation_missing_data
@@ -2831,6 +3099,12 @@ module Google
         # @return [String]
         attr_accessor :filter
       
+        # Options used when forecasting the time series and testing the predicted value
+        # against the threshold.
+        # Corresponds to the JSON property `forecastOptions`
+        # @return [Google::Apis::MonitoringV3::ForecastOptions]
+        attr_accessor :forecast_options
+      
         # A value against which to compare the time series.
         # Corresponds to the JSON property `thresholdValue`
         # @return [Float]
@@ -2855,6 +3129,7 @@ module Google
           @duration = args[:duration] if args.key?(:duration)
           @evaluation_missing_data = args[:evaluation_missing_data] if args.key?(:evaluation_missing_data)
           @filter = args[:filter] if args.key?(:filter)
+          @forecast_options = args[:forecast_options] if args.key?(:forecast_options)
           @threshold_value = args[:threshold_value] if args.key?(:threshold_value)
           @trigger = args[:trigger] if args.key?(:trigger)
         end
@@ -2947,7 +3222,7 @@ module Google
       
         # Required. The monitored resource type. For example, the type "
         # cloudsql_database" represents databases in Google Cloud SQL. For a list of
-        # types, see Monitoring resource types (https://cloud.google.com/monitoring/api/
+        # types, see Monitored resource types (https://cloud.google.com/monitoring/api/
         # resources) and Logging resource types (https://cloud.google.com/logging/docs/
         # api/v2/resource-list).
         # Corresponds to the JSON property `type`
@@ -3252,6 +3527,36 @@ module Google
         end
       end
       
+      # Control over how the notification channels in notification_channels are
+      # notified when this alert fires, on a per-channel basis.
+      class NotificationChannelStrategy
+        include Google::Apis::Core::Hashable
+      
+        # The full REST resource name for the notification channels that these settings
+        # apply to. Each of these correspond to the name field in one of the
+        # NotificationChannel objects referenced in the notification_channels field of
+        # this AlertPolicy. The format is: projects/[PROJECT_ID_OR_NUMBER]/
+        # notificationChannels/[CHANNEL_ID]
+        # Corresponds to the JSON property `notificationChannelNames`
+        # @return [Array<String>]
+        attr_accessor :notification_channel_names
+      
+        # The frequency at which to send reminder notifications for open incidents.
+        # Corresponds to the JSON property `renotifyInterval`
+        # @return [String]
+        attr_accessor :renotify_interval
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @notification_channel_names = args[:notification_channel_names] if args.key?(:notification_channel_names)
+          @renotify_interval = args[:renotify_interval] if args.key?(:renotify_interval)
+        end
+      end
+      
       # Control over the rate of notifications sent to this alert policy's
       # notification channels.
       class NotificationRateLimit
@@ -3501,6 +3806,105 @@ module Google
         end
       end
       
+      # A condition type that allows alert policies to be defined using Prometheus
+      # Query Language (PromQL) (https://prometheus.io/docs/prometheus/latest/querying/
+      # basics/).The PrometheusQueryLanguageCondition message contains information
+      # from a Prometheus alerting rule and its associated rule group.A Prometheus
+      # alerting rule is described here (https://prometheus.io/docs/prometheus/latest/
+      # configuration/alerting_rules/). The semantics of a Prometheus alerting rule is
+      # described here (https://prometheus.io/docs/prometheus/latest/configuration/
+      # recording_rules/#rule).A Prometheus rule group is described here (https://
+      # prometheus.io/docs/prometheus/latest/configuration/recording_rules/). The
+      # semantics of a Prometheus rule group is described here (https://prometheus.io/
+      # docs/prometheus/latest/configuration/recording_rules/#rule_group).Because
+      # Cloud Alerting has no representation of a Prometheus rule group resource, we
+      # must embed the information of the parent rule group inside each of the
+      # conditions that refer to it. We must also update the contents of all
+      # Prometheus alerts in case the information of their rule group changes.The
+      # PrometheusQueryLanguageCondition protocol buffer combines the information of
+      # the corresponding rule group and alerting rule. The structure of the
+      # PrometheusQueryLanguageCondition protocol buffer does NOT mimic the structure
+      # of the Prometheus rule group and alerting rule YAML declarations. The
+      # PrometheusQueryLanguageCondition protocol buffer may change in the future to
+      # support future rule group and/or alerting rule features. There are no new such
+      # features at the present time (2023-06-26).
+      class PrometheusQueryLanguageCondition
+        include Google::Apis::Core::Hashable
+      
+        # Optional. The alerting rule name of this alert in the corresponding Prometheus
+        # configuration file.Some external tools may require this field to be populated
+        # correctly in order to refer to the original Prometheus configuration file. The
+        # rule group name and the alert name are necessary to update the relevant
+        # AlertPolicies in case the definition of the rule group changes in the future.
+        # This field is optional. If this field is not empty, then it must be a 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.
+        # Corresponds to the JSON property `alertRule`
+        # @return [String]
+        attr_accessor :alert_rule
+      
+        # Optional. Alerts are considered firing once their PromQL expression was
+        # evaluated to be "true" for this long. Alerts whose PromQL expression was not
+        # evaluated to be "true" for long enough are considered pending. Must be a non-
+        # negative duration or missing. This field is optional. Its default value is
+        # zero.
+        # Corresponds to the JSON property `duration`
+        # @return [String]
+        attr_accessor :duration
+      
+        # Optional. How often this rule should be evaluated. Must be a positive multiple
+        # of 30 seconds or missing. This field is optional. Its default value is 30
+        # seconds. If this PrometheusQueryLanguageCondition was generated from a
+        # Prometheus alerting rule, then this value should be taken from the enclosing
+        # rule group.
+        # Corresponds to the JSON property `evaluationInterval`
+        # @return [String]
+        attr_accessor :evaluation_interval
+      
+        # Optional. Labels to add to or overwrite in the PromQL query result. Label
+        # names must be valid (https://prometheus.io/docs/concepts/data_model/#metric-
+        # names-and-labels). Label values can be templatized by using variables (https://
+        # cloud.google.com/monitoring/alerts/doc-variables#doc-vars). The only available
+        # variable names are the names of the labels in the PromQL result, including "
+        # __name__" and "value". "labels" may be empty.
+        # Corresponds to the JSON property `labels`
+        # @return [Hash<String,String>]
+        attr_accessor :labels
+      
+        # Required. The PromQL expression to evaluate. Every evaluation cycle this
+        # expression is evaluated at the current time, and all resultant time series
+        # become pending/firing alerts. This field must not be empty.
+        # Corresponds to the JSON property `query`
+        # @return [String]
+        attr_accessor :query
+      
+        # Optional. The rule group name of this alert in the corresponding Prometheus
+        # configuration file.Some external tools may require this field to be populated
+        # correctly in order to refer to the original Prometheus configuration file. The
+        # rule group name and the alert name are necessary to update the relevant
+        # AlertPolicies in case the definition of the rule group changes in the future.
+        # This field is optional. If this field is not empty, then it must contain a
+        # valid UTF-8 string. This field may not exceed 2048 Unicode characters in
+        # length.
+        # Corresponds to the JSON property `ruleGroup`
+        # @return [String]
+        attr_accessor :rule_group
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @alert_rule = args[:alert_rule] if args.key?(:alert_rule)
+          @duration = args[:duration] if args.key?(:duration)
+          @evaluation_interval = args[:evaluation_interval] if args.key?(:evaluation_interval)
+          @labels = args[:labels] if args.key?(:labels)
+          @query = args[:query] if args.key?(:query)
+          @rule_group = args[:rule_group] if args.key?(:rule_group)
+        end
+      end
+      
       # The QueryTimeSeries request.
       class QueryTimeSeriesRequest
         include Google::Apis::Core::Hashable
@@ -3713,6 +4117,13 @@ module Google
         # @return [Google::Apis::MonitoringV3::AppEngine]
         attr_accessor :app_engine
       
+        # A well-known service type, defined by its service type and service labels.
+        # Documentation and examples here (https://cloud.google.com/stackdriver/docs/
+        # solutions/slo-monitoring/api/api-structures#basic-svc-w-basic-sli).
+        # Corresponds to the JSON property `basicService`
+        # @return [Google::Apis::MonitoringV3::BasicService]
+        attr_accessor :basic_service
+      
         # Cloud Endpoints service. Learn more at https://cloud.google.com/endpoints.
         # Corresponds to the JSON property `cloudEndpoints`
         # @return [Google::Apis::MonitoringV3::CloudEndpoints]
@@ -3730,8 +4141,9 @@ module Google
         # @return [Google::Apis::MonitoringV3::ClusterIstio]
         attr_accessor :cluster_istio
       
-        # Custom view of service telemetry. Currently a place-holder pending final
-        # design.
+        # Use a custom service to designate a service that you want to monitor when none
+        # of the other service types (like App Engine, Cloud Run, or a GKE type) matches
+        # your intended service.
         # Corresponds to the JSON property `custom`
         # @return [Google::Apis::MonitoringV3::Custom]
         attr_accessor :custom
@@ -3775,8 +4187,8 @@ module Google
         # @return [Google::Apis::MonitoringV3::MeshIstio]
         attr_accessor :mesh_istio
       
-        # Resource name for this Service. The format is: projects/[PROJECT_ID_OR_NUMBER]/
-        # services/[SERVICE_ID]
+        # Identifier. Resource name for this Service. The format is: projects/[
+        # PROJECT_ID_OR_NUMBER]/services/[SERVICE_ID]
         # Corresponds to the JSON property `name`
         # @return [String]
         attr_accessor :name
@@ -3803,6 +4215,7 @@ module Google
         # Update properties of this object
         def update!(**args)
           @app_engine = args[:app_engine] if args.key?(:app_engine)
+          @basic_service = args[:basic_service] if args.key?(:basic_service)
           @cloud_endpoints = args[:cloud_endpoints] if args.key?(:cloud_endpoints)
           @cloud_run = args[:cloud_run] if args.key?(:cloud_run)
           @cluster_istio = args[:cluster_istio] if args.key?(:cluster_istio)
@@ -3819,6 +4232,28 @@ module Google
         end
       end
       
+      # Contains information needed for generating either an OpenID Connect 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.
+      class ServiceAgentAuthentication
+        include Google::Apis::Core::Hashable
+      
+        # Type of authentication.
+        # Corresponds to the JSON property `type`
+        # @return [String]
+        attr_accessor :type
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @type = args[:type] if args.key?(:type)
+        end
+      end
+      
       # A Service-Level Indicator (SLI) describes the "performance" of a service. For
       # some services, the SLI is well-defined. In such cases, the SLI can be
       # described easily by referencing the well-known SLI and providing the needed
@@ -3889,13 +4324,14 @@ module Google
         attr_accessor :display_name
       
         # 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.
         # Corresponds to the JSON property `goal`
         # @return [Float]
         attr_accessor :goal
       
-        # Resource name for this ServiceLevelObjective. The format is: projects/[
-        # PROJECT_ID_OR_NUMBER]/services/[SERVICE_ID]/serviceLevelObjectives/[SLO_NAME]
+        # Identifier. Resource name for this ServiceLevelObjective. The format is:
+        # projects/[PROJECT_ID_OR_NUMBER]/services/[SERVICE_ID]/serviceLevelObjectives/[
+        # SLO_NAME]
         # Corresponds to the JSON property `name`
         # @return [String]
         attr_accessor :name
@@ -3948,6 +4384,79 @@ module Google
         end
       end
       
+      # A Snooze will prevent any alerts from being opened, and close any that are
+      # already open. The Snooze will work on alerts that match the criteria defined
+      # in the Snooze. The Snooze will be active from interval.start_time through
+      # interval.end_time.
+      class Snooze
+        include Google::Apis::Core::Hashable
+      
+        # Criteria specific to the AlertPolicys that this Snooze applies to. The Snooze
+        # will suppress alerts that come from one of the AlertPolicys whose names are
+        # supplied.
+        # Corresponds to the JSON property `criteria`
+        # @return [Google::Apis::MonitoringV3::Criteria]
+        attr_accessor :criteria
+      
+        # Required. A display name for the Snooze. This can be, at most, 512 unicode
+        # characters.
+        # Corresponds to the JSON property `displayName`
+        # @return [String]
+        attr_accessor :display_name
+      
+        # Describes a time interval: Reads: A half-open time interval. It includes the
+        # end time but excludes the start time: (startTime, endTime]. The start time
+        # must be specified, must be earlier than the end time, and should be no older
+        # than the data retention period for the metric. Writes: A closed time interval.
+        # It extends from the start time to the end time, and includes both: [startTime,
+        # endTime]. Valid time intervals depend on the MetricKind (https://cloud.google.
+        # com/monitoring/api/ref_v3/rest/v3/projects.metricDescriptors#MetricKind) of
+        # the metric value. The end time must not be earlier than the start time, and
+        # the end time must not be more than 25 hours in the past or more than five
+        # minutes in the future. For GAUGE metrics, the startTime value is technically
+        # optional; if no value is specified, the start time defaults to the value of
+        # the end time, and the interval represents a single point in time. If both
+        # start and end times are specified, they must be identical. Such an interval is
+        # valid only for GAUGE metrics, which are point-in-time measurements. The end
+        # time of a new interval must be at least a millisecond after the end time of
+        # the previous interval. For DELTA metrics, the start time and end time must
+        # specify a non-zero interval, with subsequent points specifying contiguous and
+        # non-overlapping intervals. For DELTA metrics, the start time of the next
+        # interval must be at least a millisecond after the end time of the previous
+        # interval. For CUMULATIVE metrics, the start time and end time must specify a
+        # non-zero interval, with subsequent points specifying the same start time and
+        # increasing end times, until an event resets the cumulative value to zero and
+        # sets a new start time for the following points. The new start time must be at
+        # least a millisecond after the end time of the previous interval. The start
+        # time of a new interval must be at least a millisecond after the end time of
+        # the previous interval because intervals are closed. If the start time of a new
+        # interval is the same as the end time of the previous interval, then data
+        # written at the new start time could overwrite data written at the previous end
+        # time.
+        # Corresponds to the JSON property `interval`
+        # @return [Google::Apis::MonitoringV3::TimeInterval]
+        attr_accessor :interval
+      
+        # Required. Identifier. The name of the Snooze. The format is: projects/[
+        # PROJECT_ID_OR_NUMBER]/snoozes/[SNOOZE_ID] The ID of the Snooze will be
+        # generated by the system.
+        # Corresponds to the JSON property `name`
+        # @return [String]
+        attr_accessor :name
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @criteria = args[:criteria] if args.key?(:criteria)
+          @display_name = args[:display_name] if args.key?(:display_name)
+          @interval = args[:interval] if args.key?(:interval)
+          @name = args[:name] if args.key?(:name)
+        end
+      end
+      
       # SourceContext represents information about the source of a protobuf element,
       # like the file in which it is defined.
       class SourceContext
@@ -4033,6 +4542,25 @@ module Google
         end
       end
       
+      # Describes a Synthetic Monitor to be invoked by Uptime.
+      class SyntheticMonitorTarget
+        include Google::Apis::Core::Hashable
+      
+        # A Synthetic Monitor deployed to a Cloud Functions V2 instance.
+        # Corresponds to the JSON property `cloudFunctionV2`
+        # @return [Google::Apis::MonitoringV3::CloudFunctionV2Target]
+        attr_accessor :cloud_function_v2
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @cloud_function_v2 = args[:cloud_function_v2] if args.key?(:cloud_function_v2)
+        end
+      end
+      
       # Information required for a TCP Uptime check request.
       class TcpCheck
         include Google::Apis::Core::Hashable
@@ -4355,6 +4883,11 @@ module Google
       class Type
         include Google::Apis::Core::Hashable
       
+        # The source edition string, only valid when syntax is SYNTAX_EDITIONS.
+        # Corresponds to the JSON property `edition`
+        # @return [String]
+        attr_accessor :edition
+      
         # The list of fields.
         # Corresponds to the JSON property `fields`
         # @return [Array<Google::Apis::MonitoringV3::Field>]
@@ -4392,6 +4925,7 @@ module Google
       
         # Update properties of this object
         def update!(**args)
+          @edition = args[:edition] if args.key?(:edition)
           @fields = args[:fields] if args.key?(:fields)
           @name = args[:name] if args.key?(:name)
           @oneofs = args[:oneofs] if args.key?(:oneofs)
@@ -4517,10 +5051,10 @@ module Google
         # @return [Google::Apis::MonitoringV3::MonitoredResource]
         attr_accessor :monitored_resource
       
-        # A unique resource name for this Uptime check configuration. The format is:
-        # projects/[PROJECT_ID_OR_NUMBER]/uptimeCheckConfigs/[UPTIME_CHECK_ID] [
-        # PROJECT_ID_OR_NUMBER] is the Workspace host project associated with the Uptime
-        # check.This field should be omitted when creating the Uptime check
+        # Identifier. A unique resource name for this Uptime check configuration. The
+        # format is: projects/[PROJECT_ID_OR_NUMBER]/uptimeCheckConfigs/[UPTIME_CHECK_ID]
+        # [PROJECT_ID_OR_NUMBER] is the Workspace host project associated with the
+        # Uptime check.This field should be omitted when creating the Uptime check
         # configuration; on create, the resource name is assigned by the server and
         # included in the response.
         # Corresponds to the JSON property `name`
@@ -4548,6 +5082,11 @@ module Google
         # @return [Array<String>]
         attr_accessor :selected_regions
       
+        # Describes a Synthetic Monitor to be invoked by Uptime.
+        # Corresponds to the JSON property `syntheticMonitor`
+        # @return [Google::Apis::MonitoringV3::SyntheticMonitorTarget]
+        attr_accessor :synthetic_monitor
+      
         # Information required for a TCP Uptime check request.
         # Corresponds to the JSON property `tcpCheck`
         # @return [Google::Apis::MonitoringV3::TcpCheck]
@@ -4585,6 +5124,7 @@ module Google
           @period = args[:period] if args.key?(:period)
           @resource_group = args[:resource_group] if args.key?(:resource_group)
           @selected_regions = args[:selected_regions] if args.key?(:selected_regions)
+          @synthetic_monitor = args[:synthetic_monitor] if args.key?(:synthetic_monitor)
           @tcp_check = args[:tcp_check] if args.key?(:tcp_check)
           @timeout = args[:timeout] if args.key?(:timeout)
           @user_labels = args[:user_labels] if args.key?(:user_labels)