google-cloud-monitoring-v3 1.1.0 → 1.3.0

data/proto_docs/google/api/field_info.rb

@@ -0,0 +1,88 @@
+# frozen_string_literal: true
+
+# Copyright 2024 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+# Auto-generated by gapic-generator-ruby. DO NOT EDIT!
+
+
+module Google
+  module Api
+    # Rich semantic information of an API field beyond basic typing.
+    # @!attribute [rw] format
+    #   @return [::Google::Api::FieldInfo::Format]
+    #     The standard format of a field value. This does not explicitly configure
+    #     any API consumer, just documents the API's format for the field it is
+    #     applied to.
+    # @!attribute [rw] referenced_types
+    #   @return [::Array<::Google::Api::TypeReference>]
+    #     The type(s) that the annotated, generic field may represent.
+    #
+    #     Currently, this must only be used on fields of type `google.protobuf.Any`.
+    #     Supporting other generic types may be considered in the future.
+    class FieldInfo
+      include ::Google::Protobuf::MessageExts
+      extend ::Google::Protobuf::MessageExts::ClassMethods
+
+      # The standard format of a field value. The supported formats are all backed
+      # by either an RFC defined by the IETF or a Google-defined AIP.
+      module Format
+        # Default, unspecified value.
+        FORMAT_UNSPECIFIED = 0
+
+        # Universally Unique Identifier, version 4, value as defined by
+        # https://datatracker.ietf.org/doc/html/rfc4122. The value may be
+        # normalized to entirely lowercase letters. For example, the value
+        # `F47AC10B-58CC-0372-8567-0E02B2C3D479` would be normalized to
+        # `f47ac10b-58cc-0372-8567-0e02b2c3d479`.
+        UUID4 = 1
+
+        # Internet Protocol v4 value as defined by [RFC
+        # 791](https://datatracker.ietf.org/doc/html/rfc791). The value may be
+        # condensed, with leading zeros in each octet stripped. For example,
+        # `001.022.233.040` would be condensed to `1.22.233.40`.
+        IPV4 = 2
+
+        # Internet Protocol v6 value as defined by [RFC
+        # 2460](https://datatracker.ietf.org/doc/html/rfc2460). The value may be
+        # normalized to entirely lowercase letters with zeros compressed, following
+        # [RFC 5952](https://datatracker.ietf.org/doc/html/rfc5952). For example,
+        # the value `2001:0DB8:0::0` would be normalized to `2001:db8::`.
+        IPV6 = 3
+
+        # An IP address in either v4 or v6 format as described by the individual
+        # values defined herein. See the comments on the IPV4 and IPV6 types for
+        # allowed normalizations of each.
+        IPV4_OR_IPV6 = 4
+      end
+    end
+
+    # A reference to a message type, for use in {::Google::Api::FieldInfo FieldInfo}.
+    # @!attribute [rw] type_name
+    #   @return [::String]
+    #     The name of the type that the annotated, generic field may represent.
+    #     If the type is in the same protobuf package, the value can be the simple
+    #     message name e.g., `"MyMessage"`. Otherwise, the value must be the
+    #     fully-qualified message name e.g., `"google.library.v1.Book"`.
+    #
+    #     If the type(s) are unknown to the service (e.g. the field accepts generic
+    #     user input), use the wildcard `"*"` to denote this behavior.
+    #
+    #     See [AIP-202](https://google.aip.dev/202#type-references) for more details.
+    class TypeReference
+      include ::Google::Protobuf::MessageExts
+      extend ::Google::Protobuf::MessageExts::ClassMethods
+    end
+  end
+end

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

@@ -240,6 +240,9 @@ module Google
           # @!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.
+          # @!attribute [rw] condition_sql
+          #   @return [::Google::Cloud::Monitoring::V3::AlertPolicy::Condition::SqlCondition]
+          #     A condition that periodically evaluates a SQL query result.
           class Condition
             include ::Google::Protobuf::MessageExts
             extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -585,6 +588,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 +613,113 @@ 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.
+            # @!attribute [rw] hourly
+            #   @return [::Google::Cloud::Monitoring::V3::AlertPolicy::Condition::SqlCondition::Hourly]
+            #     Schedule the query to execute every so many hours.
+            # @!attribute [rw] daily
+            #   @return [::Google::Cloud::Monitoring::V3::AlertPolicy::Condition::SqlCondition::Daily]
+            #     Schedule the query to execute every so many days.
+            # @!attribute [rw] row_count_test
+            #   @return [::Google::Cloud::Monitoring::V3::AlertPolicy::Condition::SqlCondition::RowCountTest]
+            #     Test the row count against a threshold.
+            # @!attribute [rw] boolean_test
+            #   @return [::Google::Cloud::Monitoring::V3::AlertPolicy::Condition::SqlCondition::BooleanTest]
+            #     Test the boolean value in the indicated column.
+            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/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

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,15 @@ 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.
         class ListMetricDescriptorsRequest
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -334,7 +335,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 +364,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

@@ -351,7 +351,7 @@ 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>`".

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

@@ -379,10 +379,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/type/timeofday.rb

@@ -0,0 +1,45 @@
+# frozen_string_literal: true
+
+# Copyright 2024 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+# Auto-generated by gapic-generator-ruby. DO NOT EDIT!
+
+
+module Google
+  module Type
+    # Represents a time of day. The date and time zone are either not significant
+    # or are specified elsewhere. An API may choose to allow leap seconds. Related
+    # types are [google.type.Date][google.type.Date] and
+    # `google.protobuf.Timestamp`.
+    # @!attribute [rw] hours
+    #   @return [::Integer]
+    #     Hours of day in 24 hour format. Should be from 0 to 23. An API may choose
+    #     to allow the value "24:00:00" for scenarios like business closing time.
+    # @!attribute [rw] minutes
+    #   @return [::Integer]
+    #     Minutes of hour of day. Must be from 0 to 59.
+    # @!attribute [rw] seconds
+    #   @return [::Integer]
+    #     Seconds of minutes of the time. Must normally be from 0 to 59. An API may
+    #     allow the value 60 if it allows leap-seconds.
+    # @!attribute [rw] nanos
+    #   @return [::Integer]
+    #     Fractions of seconds in nanoseconds. Must be from 0 to 999,999,999.
+    class TimeOfDay
+      include ::Google::Protobuf::MessageExts
+      extend ::Google::Protobuf::MessageExts::ClassMethods
+    end
+  end
+end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: google-cloud-monitoring-v3
 version: !ruby/object:Gem::Version
-  version: 1.1.0
+  version: 1.3.0
 platform: ruby
 authors:
 - Google LLC
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2024-12-05 00:00:00.000000000 Z
+date: 2025-01-08 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: gapic-common
@@ -16,7 +16,7 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 0.21.1
+        version: 0.24.0
     - - "<"
       - !ruby/object:Gem::Version
         version: 2.a
@@ -26,7 +26,7 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 0.21.1
+        version: 0.24.0
     - - "<"
       - !ruby/object:Gem::Version
         version: 2.a
@@ -123,6 +123,7 @@ files:
 - proto_docs/google/api/client.rb
 - proto_docs/google/api/distribution.rb
 - proto_docs/google/api/field_behavior.rb
+- proto_docs/google/api/field_info.rb
 - proto_docs/google/api/label.rb
 - proto_docs/google/api/launch_stage.rb
 - proto_docs/google/api/metric.rb
@@ -155,6 +156,7 @@ files:
 - proto_docs/google/protobuf/wrappers.rb
 - proto_docs/google/rpc/status.rb
 - proto_docs/google/type/calendar_period.rb
+- proto_docs/google/type/timeofday.rb
 homepage: https://github.com/googleapis/google-cloud-ruby
 licenses:
 - Apache-2.0