google-cloud-monitoring-v3 0.4.0 → 0.5.0

data/lib/google/cloud/monitoring/v3/uptime_check_service/client.rb

@@ -48,13 +48,12 @@ module Google
             # See {::Google::Cloud::Monitoring::V3::UptimeCheckService::Client::Configuration}
             # for a description of the configuration fields.
             #
-            # ## Example
+            # @example
             #
-            # To modify the configuration for all UptimeCheckService clients:
-            #
-            #     ::Google::Cloud::Monitoring::V3::UptimeCheckService::Client.configure do |config|
-            #       config.timeout = 10.0
-            #     end
+            #   # Modify the configuration for all UptimeCheckService clients
+            #   ::Google::Cloud::Monitoring::V3::UptimeCheckService::Client.configure do |config|
+            #     config.timeout = 10.0
+            #   end
             #
             # @yield [config] Configure the Client client.
             # @yieldparam config [Client::Configuration]
@@ -74,18 +73,12 @@ module Google
 
                 default_config.rpcs.list_uptime_check_configs.timeout = 30.0
                 default_config.rpcs.list_uptime_check_configs.retry_policy = {
-                  initial_delay: 0.1,
-              max_delay: 30.0,
-              multiplier: 1.3,
-              retry_codes: [4, 14]
+                  initial_delay: 0.1, max_delay: 30.0, multiplier: 1.3, retry_codes: [14]
                 }
 
                 default_config.rpcs.get_uptime_check_config.timeout = 30.0
                 default_config.rpcs.get_uptime_check_config.retry_policy = {
-                  initial_delay: 0.1,
-              max_delay: 30.0,
-              multiplier: 1.3,
-              retry_codes: [4, 14]
+                  initial_delay: 0.1, max_delay: 30.0, multiplier: 1.3, retry_codes: [14]
                 }
 
                 default_config.rpcs.create_uptime_check_config.timeout = 30.0
@@ -94,18 +87,12 @@ module Google
 
                 default_config.rpcs.delete_uptime_check_config.timeout = 30.0
                 default_config.rpcs.delete_uptime_check_config.retry_policy = {
-                  initial_delay: 0.1,
-              max_delay: 30.0,
-              multiplier: 1.3,
-              retry_codes: [4, 14]
+                  initial_delay: 0.1, max_delay: 30.0, multiplier: 1.3, retry_codes: [14]
                 }
 
                 default_config.rpcs.list_uptime_check_ips.timeout = 30.0
                 default_config.rpcs.list_uptime_check_ips.retry_policy = {
-                  initial_delay: 0.1,
-              max_delay: 30.0,
-              multiplier: 1.3,
-              retry_codes: [4, 14]
+                  initial_delay: 0.1, max_delay: 30.0, multiplier: 1.3, retry_codes: [14]
                 }
 
                 default_config
@@ -137,19 +124,15 @@ module Google
             ##
             # Create a new UptimeCheckService client object.
             #
-            # ## Examples
-            #
-            # To create a new UptimeCheckService client with the default
-            # configuration:
+            # @example
             #
-            #     client = ::Google::Cloud::Monitoring::V3::UptimeCheckService::Client.new
+            #   # Create a client using the default configuration
+            #   client = ::Google::Cloud::Monitoring::V3::UptimeCheckService::Client.new
             #
-            # To create a new UptimeCheckService client with a custom
-            # configuration:
-            #
-            #     client = ::Google::Cloud::Monitoring::V3::UptimeCheckService::Client.new do |config|
-            #       config.timeout = 10.0
-            #     end
+            #   # Create a client using a custom configuration
+            #   client = ::Google::Cloud::Monitoring::V3::UptimeCheckService::Client.new do |config|
+            #     config.timeout = 10.0
+            #   end
             #
             # @yield [config] Configure the UptimeCheckService client.
             # @yieldparam config [Client::Configuration]
@@ -169,14 +152,13 @@ module Google
 
               # Create credentials
               credentials = @config.credentials
-              # Use self-signed JWT if the scope and endpoint are unchanged from default,
+              # Use self-signed JWT if the endpoint is unchanged from default,
               # but only if the default endpoint does not have a region prefix.
-              enable_self_signed_jwt = @config.scope == Client.configure.scope &&
-                                       @config.endpoint == Client.configure.endpoint &&
+              enable_self_signed_jwt = @config.endpoint == Client.configure.endpoint &&
                                        !@config.endpoint.split(".").first.include?("-")
               credentials ||= Credentials.default scope: @config.scope,
                                                   enable_self_signed_jwt: enable_self_signed_jwt
-              if credentials.is_a?(String) || credentials.is_a?(Hash)
+              if credentials.is_a?(::String) || credentials.is_a?(::Hash)
                 credentials = Credentials.new credentials, scope: @config.scope
               end
               @quota_project_id = @config.quota_project
@@ -213,7 +195,8 @@ module Google
             #   the default parameter values, pass an empty Hash as a request object (see above).
             #
             #   @param parent [::String]
-            #     Required. The project whose Uptime check configurations are listed. The format is:
+            #     Required. The [project](https://cloud.google.com/monitoring/api/v3#project_name)
+            #     whose Uptime check configurations are listed. The format is:
             #
             #         projects/[PROJECT_ID_OR_NUMBER]
             #   @param page_size [::Integer]
@@ -260,7 +243,9 @@ module Google
               options.apply_defaults timeout:      @config.rpcs.list_uptime_check_configs.timeout,
                                      metadata:     metadata,
                                      retry_policy: @config.rpcs.list_uptime_check_configs.retry_policy
-              options.apply_defaults metadata:     @config.metadata,
+
+              options.apply_defaults timeout:      @config.timeout,
+                                     metadata:     @config.metadata,
                                      retry_policy: @config.retry_policy
 
               @uptime_check_service_stub.call_rpc :list_uptime_check_configs, request, options: options do |response, operation|
@@ -329,7 +314,9 @@ module Google
               options.apply_defaults timeout:      @config.rpcs.get_uptime_check_config.timeout,
                                      metadata:     metadata,
                                      retry_policy: @config.rpcs.get_uptime_check_config.retry_policy
-              options.apply_defaults metadata:     @config.metadata,
+
+              options.apply_defaults timeout:      @config.timeout,
+                                     metadata:     @config.metadata,
                                      retry_policy: @config.retry_policy
 
               @uptime_check_service_stub.call_rpc :get_uptime_check_config, request, options: options do |response, operation|
@@ -359,7 +346,8 @@ module Google
             #   the default parameter values, pass an empty Hash as a request object (see above).
             #
             #   @param parent [::String]
-            #     Required. The project in which to create the Uptime check. The format is:
+            #     Required. The [project](https://cloud.google.com/monitoring/api/v3#project_name) in
+            #     which to create the Uptime check. The format is:
             #
             #         projects/[PROJECT_ID_OR_NUMBER]
             #   @param uptime_check_config [::Google::Cloud::Monitoring::V3::UptimeCheckConfig, ::Hash]
@@ -399,7 +387,9 @@ module Google
               options.apply_defaults timeout:      @config.rpcs.create_uptime_check_config.timeout,
                                      metadata:     metadata,
                                      retry_policy: @config.rpcs.create_uptime_check_config.retry_policy
-              options.apply_defaults metadata:     @config.metadata,
+
+              options.apply_defaults timeout:      @config.timeout,
+                                     metadata:     @config.metadata,
                                      retry_policy: @config.retry_policy
 
               @uptime_check_service_stub.call_rpc :create_uptime_check_config, request, options: options do |response, operation|
@@ -483,7 +473,9 @@ module Google
               options.apply_defaults timeout:      @config.rpcs.update_uptime_check_config.timeout,
                                      metadata:     metadata,
                                      retry_policy: @config.rpcs.update_uptime_check_config.retry_policy
-              options.apply_defaults metadata:     @config.metadata,
+
+              options.apply_defaults timeout:      @config.timeout,
+                                     metadata:     @config.metadata,
                                      retry_policy: @config.retry_policy
 
               @uptime_check_service_stub.call_rpc :update_uptime_check_config, request, options: options do |response, operation|
@@ -553,7 +545,9 @@ module Google
               options.apply_defaults timeout:      @config.rpcs.delete_uptime_check_config.timeout,
                                      metadata:     metadata,
                                      retry_policy: @config.rpcs.delete_uptime_check_config.retry_policy
-              options.apply_defaults metadata:     @config.metadata,
+
+              options.apply_defaults timeout:      @config.timeout,
+                                     metadata:     @config.metadata,
                                      retry_policy: @config.retry_policy
 
               @uptime_check_service_stub.call_rpc :delete_uptime_check_config, request, options: options do |response, operation|
@@ -622,7 +616,9 @@ module Google
               options.apply_defaults timeout:      @config.rpcs.list_uptime_check_ips.timeout,
                                      metadata:     metadata,
                                      retry_policy: @config.rpcs.list_uptime_check_ips.retry_policy
-              options.apply_defaults metadata:     @config.metadata,
+
+              options.apply_defaults timeout:      @config.timeout,
+                                     metadata:     @config.metadata,
                                      retry_policy: @config.retry_policy
 
               @uptime_check_service_stub.call_rpc :list_uptime_check_ips, request, options: options do |response, operation|
@@ -647,22 +643,21 @@ module Google
             # Configuration can be applied globally to all clients, or to a single client
             # on construction.
             #
-            # # Examples
-            #
-            # To modify the global config, setting the timeout for list_uptime_check_configs
-            # to 20 seconds, and all remaining timeouts to 10 seconds:
-            #
-            #     ::Google::Cloud::Monitoring::V3::UptimeCheckService::Client.configure do |config|
-            #       config.timeout = 10.0
-            #       config.rpcs.list_uptime_check_configs.timeout = 20.0
-            #     end
-            #
-            # To apply the above configuration only to a new client:
-            #
-            #     client = ::Google::Cloud::Monitoring::V3::UptimeCheckService::Client.new do |config|
-            #       config.timeout = 10.0
-            #       config.rpcs.list_uptime_check_configs.timeout = 20.0
-            #     end
+            # @example
+            #
+            #   # Modify the global config, setting the timeout for
+            #   # list_uptime_check_configs to 20 seconds,
+            #   # and all remaining timeouts to 10 seconds.
+            #   ::Google::Cloud::Monitoring::V3::UptimeCheckService::Client.configure do |config|
+            #     config.timeout = 10.0
+            #     config.rpcs.list_uptime_check_configs.timeout = 20.0
+            #   end
+            #
+            #   # Apply the above configuration only to a new client.
+            #   client = ::Google::Cloud::Monitoring::V3::UptimeCheckService::Client.new do |config|
+            #     config.timeout = 10.0
+            #     config.rpcs.list_uptime_check_configs.timeout = 20.0
+            #   end
             #
             # @!attribute [rw] endpoint
             #   The hostname or hostname:port of the service endpoint.

data/lib/google/cloud/monitoring/v3/uptime_check_service/paths.rb

@@ -52,6 +52,20 @@ module Google
               "organizations/#{organization}"
             end
 
+            ##
+            # Create a fully-qualified Project resource string.
+            #
+            # The resource will be in the following format:
+            #
+            # `projects/{project}`
+            #
+            # @param project [String]
+            #
+            # @return [::String]
+            def project_path project:
+              "projects/#{project}"
+            end
+
             ##
             # Create a fully-qualified UptimeCheckConfig resource string.
             #

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

@@ -21,7 +21,7 @@ module Google
   module Cloud
     module Monitoring
       module V3
-        VERSION = "0.4.0"
+        VERSION = "0.5.0"
       end
     end
   end

data/lib/google/monitoring/v3/alert_pb.rb

@@ -24,6 +24,7 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
       repeated :notification_channels, :string, 14
       optional :creation_record, :message, 10, "google.monitoring.v3.MutationRecord"
       optional :mutation_record, :message, 11, "google.monitoring.v3.MutationRecord"
+      optional :alert_strategy, :message, 21, "google.monitoring.v3.AlertPolicy.AlertStrategy"
     end
     add_message "google.monitoring.v3.AlertPolicy.Documentation" do
       optional :content, :string, 1
@@ -35,6 +36,7 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
       oneof :condition do
         optional :condition_threshold, :message, 1, "google.monitoring.v3.AlertPolicy.Condition.MetricThreshold"
         optional :condition_absent, :message, 2, "google.monitoring.v3.AlertPolicy.Condition.MetricAbsence"
+        optional :condition_matched_log, :message, 20, "google.monitoring.v3.AlertPolicy.Condition.LogMatch"
         optional :condition_monitoring_query_language, :message, 19, "google.monitoring.v3.AlertPolicy.Condition.MonitoringQueryLanguageCondition"
       end
     end
@@ -60,11 +62,21 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
       optional :duration, :message, 2, "google.protobuf.Duration"
       optional :trigger, :message, 3, "google.monitoring.v3.AlertPolicy.Condition.Trigger"
     end
+    add_message "google.monitoring.v3.AlertPolicy.Condition.LogMatch" do
+      optional :filter, :string, 1
+      map :label_extractors, :string, :string, 2
+    end
     add_message "google.monitoring.v3.AlertPolicy.Condition.MonitoringQueryLanguageCondition" do
       optional :query, :string, 1
       optional :duration, :message, 2, "google.protobuf.Duration"
       optional :trigger, :message, 3, "google.monitoring.v3.AlertPolicy.Condition.Trigger"
     end
+    add_message "google.monitoring.v3.AlertPolicy.AlertStrategy" do
+      optional :notification_rate_limit, :message, 1, "google.monitoring.v3.AlertPolicy.AlertStrategy.NotificationRateLimit"
+    end
+    add_message "google.monitoring.v3.AlertPolicy.AlertStrategy.NotificationRateLimit" do
+      optional :period, :message, 1, "google.protobuf.Duration"
+    end
     add_enum "google.monitoring.v3.AlertPolicy.ConditionCombinerType" do
       value :COMBINE_UNSPECIFIED, 0
       value :AND, 1
@@ -84,7 +96,10 @@ module Google
         AlertPolicy::Condition::Trigger = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.monitoring.v3.AlertPolicy.Condition.Trigger").msgclass
         AlertPolicy::Condition::MetricThreshold = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.monitoring.v3.AlertPolicy.Condition.MetricThreshold").msgclass
         AlertPolicy::Condition::MetricAbsence = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.monitoring.v3.AlertPolicy.Condition.MetricAbsence").msgclass
+        AlertPolicy::Condition::LogMatch = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.monitoring.v3.AlertPolicy.Condition.LogMatch").msgclass
         AlertPolicy::Condition::MonitoringQueryLanguageCondition = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.monitoring.v3.AlertPolicy.Condition.MonitoringQueryLanguageCondition").msgclass
+        AlertPolicy::AlertStrategy = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.monitoring.v3.AlertPolicy.AlertStrategy").msgclass
+        AlertPolicy::AlertStrategy::NotificationRateLimit = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.monitoring.v3.AlertPolicy.AlertStrategy.NotificationRateLimit").msgclass
         AlertPolicy::ConditionCombinerType = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.monitoring.v3.AlertPolicy.ConditionCombinerType").enummodule
       end
     end

data/lib/google/monitoring/v3/common_pb.rb

@@ -73,11 +73,6 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
       value :COMPARISON_EQ, 5
       value :COMPARISON_NE, 6
     end
-    add_enum "google.monitoring.v3.ServiceTier" do
-      value :SERVICE_TIER_UNSPECIFIED, 0
-      value :SERVICE_TIER_BASIC, 1
-      value :SERVICE_TIER_PREMIUM, 2
-    end
   end
 end
 
@@ -91,7 +86,6 @@ module Google
         Aggregation::Aligner = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.monitoring.v3.Aggregation.Aligner").enummodule
         Aggregation::Reducer = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.monitoring.v3.Aggregation.Reducer").enummodule
         ComparisonType = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.monitoring.v3.ComparisonType").enummodule
-        ServiceTier = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.monitoring.v3.ServiceTier").enummodule
       end
     end
   end

data/lib/google/monitoring/v3/notification_pb.rb

@@ -6,7 +6,6 @@ require 'google/protobuf'
 require 'google/api/label_pb'
 require 'google/api/launch_stage_pb'
 require 'google/api/resource_pb'
-require 'google/monitoring/v3/common_pb'
 require 'google/monitoring/v3/mutation_record_pb'
 require 'google/protobuf/wrappers_pb'
 Google::Protobuf::DescriptorPool.generated_pool.build do
@@ -17,7 +16,6 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
       optional :display_name, :string, 2
       optional :description, :string, 3
       repeated :labels, :message, 4, "google.api.LabelDescriptor"
-      repeated :supported_tiers, :enum, 5, "google.monitoring.v3.ServiceTier"
       optional :launch_stage, :enum, 7, "google.api.LaunchStage"
     end
     add_message "google.monitoring.v3.NotificationChannel" do

data/lib/google/monitoring/v3/service_pb.rb

@@ -13,6 +13,7 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
       optional :name, :string, 1
       optional :display_name, :string, 2
       optional :telemetry, :message, 13, "google.monitoring.v3.Service.Telemetry"
+      map :user_labels, :string, :string, 14
       oneof :identifier do
         optional :custom, :message, 6, "google.monitoring.v3.Service.Custom"
         optional :app_engine, :message, 7, "google.monitoring.v3.Service.AppEngine"
@@ -54,6 +55,7 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
       optional :display_name, :string, 11
       optional :service_level_indicator, :message, 3, "google.monitoring.v3.ServiceLevelIndicator"
       optional :goal, :double, 4
+      map :user_labels, :string, :string, 12
       oneof :period do
         optional :rolling_period, :message, 5, "google.protobuf.Duration"
         optional :calendar_period, :enum, 6, "google.type.CalendarPeriod"

data/lib/google/monitoring/v3/uptime_service_pb.rb

@@ -7,6 +7,7 @@ require 'google/api/annotations_pb'
 require 'google/api/client_pb'
 require 'google/api/field_behavior_pb'
 require 'google/api/resource_pb'
+require 'google/longrunning/operations_pb'
 require 'google/monitoring/v3/uptime_pb'
 require 'google/protobuf/duration_pb'
 require 'google/protobuf/empty_pb'

data/proto_docs/google/api/distribution.rb

@@ -49,7 +49,7 @@ module Google
     #
     #         Sum[i=1..n]((x_i - mean)^2)
     #
-    #     Knuth, "The Art of Computer Programming", Vol. 2, page 323, 3rd edition
+    #     Knuth, "The Art of Computer Programming", Vol. 2, page 232, 3rd edition
     #     describes Welford's method for accumulating this sum in one pass.
     #
     #     If `count` is zero then this field must be zero.
@@ -207,7 +207,7 @@ module Google
       #   @return [::Array<::Google::Protobuf::Any>]
       #     Contextual information about the example value. Examples are:
       #
-      #       Trace ID: type.googleapis.com/google.devtools.cloudtrace.v1.Trace
+      #       Trace: type.googleapis.com/google.monitoring.v3.SpanContext
       #
       #       Literal string: type.googleapis.com/google.protobuf.StringValue
       #

data/proto_docs/google/api/field_behavior.rb

@@ -57,9 +57,15 @@ module Google
 
       # Denotes that a (repeated) field is an unordered list.
       # This indicates that the service may provide the elements of the list
-      # in any arbitrary order, rather than the order the user originally
+      # in any arbitrary  order, rather than the order the user originally
       # provided. Additionally, the list's order may or may not be stable.
       UNORDERED_LIST = 6
+
+      # Denotes that this field returns a non-empty default value if not set.
+      # This indicates that if the user provides the empty value in a request,
+      # a non-empty value will be returned. The user will not be aware of what
+      # non-empty value to expect.
+      NON_EMPTY_DEFAULT = 7
     end
   end
 end

data/proto_docs/google/api/launch_stage.rb

@@ -25,6 +25,12 @@ module Google
       # Do not use this default value.
       LAUNCH_STAGE_UNSPECIFIED = 0
 
+      # The feature is not yet implemented. Users can not use it.
+      UNIMPLEMENTED = 6
+
+      # Prelaunch features are hidden from users and are only visible internally.
+      PRELAUNCH = 7
+
       # Early Access features are limited to a closed group of testers. To use
       # these features, you must sign up in advance and sign a Trusted Tester
       # agreement (which includes confidentiality provisions). These features may
@@ -36,7 +42,7 @@ module Google
       # for widespread use. By Alpha, all significant design issues are resolved
       # and we are in the process of verifying functionality. Alpha customers
       # need to apply for access, agree to applicable terms, and have their
-      # projects whitelisted. Alpha releases don’t have to be feature complete,
+      # projects allowlisted. Alpha releases don’t have to be feature complete,
       # no SLAs are provided, and there are no technical support obligations, but
       # they will be far enough along that customers can actually use them in
       # test environments or for limited-use tests -- just like they would in

data/proto_docs/google/api/metric.rb

@@ -28,11 +28,12 @@ module Google
     # @!attribute [rw] type
     #   @return [::String]
     #     The metric type, including its DNS name prefix. The type is not
-    #     URL-encoded.  All user-defined custom metric types have the DNS name
-    #     `custom.googleapis.com`.  Metric types should use a natural hierarchical
-    #     grouping. For example:
+    #     URL-encoded. All user-defined metric types have the DNS name
+    #     `custom.googleapis.com` or `external.googleapis.com`. Metric types should
+    #     use a natural hierarchical grouping. For example:
     #
     #         "custom.googleapis.com/invoice/paid/amount"
+    #         "external.googleapis.com/prometheus/up"
     #         "appengine.googleapis.com/http/server/response_latencies"
     # @!attribute [rw] labels
     #   @return [::Array<::Google::Api::LabelDescriptor>]
@@ -52,10 +53,28 @@ module Google
     #     Some combinations of `metric_kind` and `value_type` might not be supported.
     # @!attribute [rw] unit
     #   @return [::String]
-    #     The unit in which the metric value is reported. It is only applicable
-    #     if the `value_type` is `INT64`, `DOUBLE`, or `DISTRIBUTION`. The
-    #     supported units are a subset of [The Unified Code for Units of
-    #     Measure](http://unitsofmeasure.org/ucum.html) standard:
+    #     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.
+    #
+    #     Different systems might scale the values to be more easily displayed (so a
+    #     value of `0.02kBy` _might_ be displayed as `20By`, and a value of
+    #     `3523kBy` _might_ be displayed as `3.5MBy`). However, if the `unit` is
+    #     `kBy`, then the value of the metric is always in thousands of bytes, no
+    #     matter how it might be displayed.
+    #
+    #     If you want a custom metric to record the exact number of CPU-seconds used
+    #     by a job, you can create an `INT64 CUMULATIVE` metric whose `unit` is
+    #     `s{CPU}` (or equivalently `1s{CPU}` or just `s`). If the job uses 12,005
+    #     CPU-seconds, then the value is written as `12005`.
+    #
+    #     Alternatively, if you want a custom metric to record data in a more
+    #     granular way, you can create a `DOUBLE CUMULATIVE` metric whose `unit` is
+    #     `ks{CPU}`, and then write the value `12.005` (which is `12005/1000`),
+    #     or use `Kis{CPU}` and write `11.723` (which is `12005/1024`).
+    #
+    #     The supported units are a subset of [The Unified Code for Units of
+    #     Measure](https://unitsofmeasure.org/ucum.html) standard:
     #
     #     **Basic units (UNIT)**
     #
@@ -65,36 +84,44 @@ module Google
     #     * `min`   minute
     #     * `h`     hour
     #     * `d`     day
+    #     * `1`     dimensionless
     #
     #     **Prefixes (PREFIX)**
     #
-    #     * `k`     kilo    (10**3)
-    #     * `M`     mega    (10**6)
-    #     * `G`     giga    (10**9)
-    #     * `T`     tera    (10**12)
-    #     * `P`     peta    (10**15)
-    #     * `E`     exa     (10**18)
-    #     * `Z`     zetta   (10**21)
-    #     * `Y`     yotta   (10**24)
-    #     * `m`     milli   (10**-3)
-    #     * `u`     micro   (10**-6)
-    #     * `n`     nano    (10**-9)
-    #     * `p`     pico    (10**-12)
-    #     * `f`     femto   (10**-15)
-    #     * `a`     atto    (10**-18)
-    #     * `z`     zepto   (10**-21)
-    #     * `y`     yocto   (10**-24)
-    #     * `Ki`    kibi    (2**10)
-    #     * `Mi`    mebi    (2**20)
-    #     * `Gi`    gibi    (2**30)
-    #     * `Ti`    tebi    (2**40)
+    #     * `k`     kilo    (10^3)
+    #     * `M`     mega    (10^6)
+    #     * `G`     giga    (10^9)
+    #     * `T`     tera    (10^12)
+    #     * `P`     peta    (10^15)
+    #     * `E`     exa     (10^18)
+    #     * `Z`     zetta   (10^21)
+    #     * `Y`     yotta   (10^24)
+    #
+    #     * `m`     milli   (10^-3)
+    #     * `u`     micro   (10^-6)
+    #     * `n`     nano    (10^-9)
+    #     * `p`     pico    (10^-12)
+    #     * `f`     femto   (10^-15)
+    #     * `a`     atto    (10^-18)
+    #     * `z`     zepto   (10^-21)
+    #     * `y`     yocto   (10^-24)
+    #
+    #     * `Ki`    kibi    (2^10)
+    #     * `Mi`    mebi    (2^20)
+    #     * `Gi`    gibi    (2^30)
+    #     * `Ti`    tebi    (2^40)
+    #     * `Pi`    pebi    (2^50)
     #
     #     **Grammar**
     #
     #     The grammar also includes these connectors:
     #
-    #     * `/`    division (as an infix operator, e.g. `1/s`).
-    #     * `.`    multiplication (as an infix operator, e.g. `GBy.d`)
+    #     * `/`    division or ratio (as an infix operator). For examples,
+    #              `kBy/{email}` or `MiBy/10ms` (although you should almost never
+    #              have `/s` in a metric `unit`; rates should always be computed at
+    #              query time from the underlying cumulative or delta value).
+    #     * `.`    multiplication or composition (as an infix operator). For
+    #              examples, `GBy.d` or `k{watt}.h`.
     #
     #     The grammar for a unit is as follows:
     #
@@ -109,14 +136,25 @@ module Google
     #
     #     Notes:
     #
-    #     * `Annotation` is just a comment if it follows a `UNIT` and is
-    #        equivalent to `1` if it is used alone. For examples,
-    #        `{requests}/s == 1/s`, `By{transmitted}/s == By/s`.
+    #     * `Annotation` is just a comment if it follows a `UNIT`. If the annotation
+    #        is used alone, then the unit is equivalent to `1`. For examples,
+    #        `{request}/s == 1/s`, `By{transmitted}/s == By/s`.
     #     * `NAME` is a sequence of non-blank printable ASCII characters not
-    #        containing '\\{' or '}'.
-    #     * `1` represents dimensionless value 1, such as in `1/s`.
-    #     * `%` represents dimensionless value 1/100, and annotates values giving
-    #        a percentage.
+    #        containing `{` or `}`.
+    #     * `1` represents a unitary [dimensionless
+    #        unit](https://en.wikipedia.org/wiki/Dimensionless_quantity) of 1, such
+    #        as in `1/s`. It is typically used when none of the basic units are
+    #        appropriate. For example, "new users per day" can be represented as
+    #        `1/d` or `{new-users}/d` (and a metric value `5` would mean "5 new
+    #        users). Alternatively, "thousands of page views per day" would be
+    #        represented as `1000/d` or `k1/d` or `k{page_views}/d` (and a metric
+    #        value of `5.3` would mean "5300 page views per day").
+    #     * `%` represents dimensionless value of 1/100, and annotates values giving
+    #        a percentage (so the metric values are typically in the range of 0..100,
+    #        and a metric value `3` means "3 percent").
+    #     * `10^2.%` indicates a metric contains a ratio, typically in the range
+    #        0..1, that will be multiplied by 100 and displayed as a percentage
+    #        (so a metric value `0.03` means "3 percent").
     # @!attribute [rw] description
     #   @return [::String]
     #     A detailed description of the metric, which can be used in documentation.
@@ -126,11 +164,46 @@ module Google
     #     Use sentence case without an ending period, for example "Request count".
     #     This field is optional but it is recommended to be set for any metrics
     #     associated with user-visible concepts, such as Quota.
+    # @!attribute [rw] metadata
+    #   @return [::Google::Api::MetricDescriptor::MetricDescriptorMetadata]
+    #     Optional. Metadata which can be used to guide usage of the metric.
+    # @!attribute [rw] launch_stage
+    #   @return [::Google::Api::LaunchStage]
+    #     Optional. The launch stage of the metric definition.
+    # @!attribute [rw] monitored_resource_types
+    #   @return [::Array<::String>]
+    #     Read-only. If present, then a [time
+    #     series][google.monitoring.v3.TimeSeries], which is identified partially by
+    #     a metric type and a {::Google::Api::MonitoredResourceDescriptor MonitoredResourceDescriptor}, that is associated
+    #     with this metric type can only be associated with one of the monitored
+    #     resource types listed here.
     class MetricDescriptor
       include ::Google::Protobuf::MessageExts
       extend ::Google::Protobuf::MessageExts::ClassMethods
 
+      # Additional annotations that can be used to guide the usage of a metric.
+      # @!attribute [rw] launch_stage
+      #   @return [::Google::Api::LaunchStage]
+      #     Deprecated. Must use the {::Google::Api::MetricDescriptor#launch_stage MetricDescriptor.launch_stage} instead.
+      # @!attribute [rw] sample_period
+      #   @return [::Google::Protobuf::Duration]
+      #     The sampling period of metric data points. For metrics which are written
+      #     periodically, consecutive data points are stored at this time interval,
+      #     excluding data loss due to errors. Metrics with a higher granularity have
+      #     a smaller sampling period.
+      # @!attribute [rw] ingest_delay
+      #   @return [::Google::Protobuf::Duration]
+      #     The delay of data points caused by ingestion. Data points older than this
+      #     age are guaranteed to be ingested and available to be read, excluding
+      #     data loss due to errors.
+      class MetricDescriptorMetadata
+        include ::Google::Protobuf::MessageExts
+        extend ::Google::Protobuf::MessageExts::ClassMethods
+      end
+
       # The kind of measurement. It describes how the data is reported.
+      # For information on setting the start time and end time based on
+      # the MetricKind, see {::Google::Cloud::Monitoring::V3::TimeInterval TimeInterval}.
       module MetricKind
         # Do not use this default value.
         METRIC_KIND_UNSPECIFIED = 0