google-cloud-logging-v2 0.1.0

data/lib/google/logging/v2/logging_config_services_pb.rb

@@ -0,0 +1,113 @@
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# Source: google/logging/v2/logging_config.proto for package 'Google.Cloud.Logging.V2'
+# Original file comments:
+# Copyright 2020 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
+#
+#     http://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.
+#
+
+require 'grpc'
+require 'google/logging/v2/logging_config_pb'
+
+module Google
+  module Cloud
+    module Logging
+      module V2
+        module ConfigServiceV2
+          # Service for configuring sinks used to route log entries.
+          class Service
+
+            include GRPC::GenericService
+
+            self.marshal_class_method = :encode
+            self.unmarshal_class_method = :decode
+            self.service_name = 'google.logging.v2.ConfigServiceV2'
+
+            # Lists buckets (Beta).
+            rpc :ListBuckets, Google::Cloud::Logging::V2::ListBucketsRequest, Google::Cloud::Logging::V2::ListBucketsResponse
+            # Gets a bucket (Beta).
+            rpc :GetBucket, Google::Cloud::Logging::V2::GetBucketRequest, Google::Cloud::Logging::V2::LogBucket
+            # Updates a bucket. This method replaces the following fields in the
+            # existing bucket with values from the new bucket: `retention_period`
+            #
+            # If the retention period is decreased and the bucket is locked,
+            # FAILED_PRECONDITION will be returned.
+            #
+            # If the bucket has a LifecycleState of DELETE_REQUESTED, FAILED_PRECONDITION
+            # will be returned.
+            #
+            # A buckets region may not be modified after it is created.
+            # This method is in Beta.
+            rpc :UpdateBucket, Google::Cloud::Logging::V2::UpdateBucketRequest, Google::Cloud::Logging::V2::LogBucket
+            # Lists sinks.
+            rpc :ListSinks, Google::Cloud::Logging::V2::ListSinksRequest, Google::Cloud::Logging::V2::ListSinksResponse
+            # Gets a sink.
+            rpc :GetSink, Google::Cloud::Logging::V2::GetSinkRequest, Google::Cloud::Logging::V2::LogSink
+            # Creates a sink that exports specified log entries to a destination. The
+            # export of newly-ingested log entries begins immediately, unless the sink's
+            # `writer_identity` is not permitted to write to the destination. A sink can
+            # export log entries only from the resource owning the sink.
+            rpc :CreateSink, Google::Cloud::Logging::V2::CreateSinkRequest, Google::Cloud::Logging::V2::LogSink
+            # Updates a sink. This method replaces the following fields in the existing
+            # sink with values from the new sink: `destination`, and `filter`.
+            #
+            # The updated sink might also have a new `writer_identity`; see the
+            # `unique_writer_identity` field.
+            rpc :UpdateSink, Google::Cloud::Logging::V2::UpdateSinkRequest, Google::Cloud::Logging::V2::LogSink
+            # Deletes a sink. If the sink has a unique `writer_identity`, then that
+            # service account is also deleted.
+            rpc :DeleteSink, Google::Cloud::Logging::V2::DeleteSinkRequest, Google::Protobuf::Empty
+            # Lists all the exclusions in a parent resource.
+            rpc :ListExclusions, Google::Cloud::Logging::V2::ListExclusionsRequest, Google::Cloud::Logging::V2::ListExclusionsResponse
+            # Gets the description of an exclusion.
+            rpc :GetExclusion, Google::Cloud::Logging::V2::GetExclusionRequest, Google::Cloud::Logging::V2::LogExclusion
+            # Creates a new exclusion in a specified parent resource.
+            # Only log entries belonging to that resource can be excluded.
+            # You can have up to 10 exclusions in a resource.
+            rpc :CreateExclusion, Google::Cloud::Logging::V2::CreateExclusionRequest, Google::Cloud::Logging::V2::LogExclusion
+            # Changes one or more properties of an existing exclusion.
+            rpc :UpdateExclusion, Google::Cloud::Logging::V2::UpdateExclusionRequest, Google::Cloud::Logging::V2::LogExclusion
+            # Deletes an exclusion.
+            rpc :DeleteExclusion, Google::Cloud::Logging::V2::DeleteExclusionRequest, Google::Protobuf::Empty
+            # Gets the Logs Router CMEK settings for the given resource.
+            #
+            # Note: CMEK for the Logs Router can currently only be configured for GCP
+            # organizations. Once configured, it applies to all projects and folders in
+            # the GCP organization.
+            #
+            # See [Enabling CMEK for Logs
+            # Router](https://cloud.google.com/logging/docs/routing/managed-encryption) for more information.
+            rpc :GetCmekSettings, Google::Cloud::Logging::V2::GetCmekSettingsRequest, Google::Cloud::Logging::V2::CmekSettings
+            # Updates the Logs Router CMEK settings for the given resource.
+            #
+            # Note: CMEK for the Logs Router can currently only be configured for GCP
+            # organizations. Once configured, it applies to all projects and folders in
+            # the GCP organization.
+            #
+            # [UpdateCmekSettings][google.logging.v2.ConfigServiceV2.UpdateCmekSettings]
+            # will fail if 1) `kms_key_name` is invalid, or 2) the associated service
+            # account does not have the required
+            # `roles/cloudkms.cryptoKeyEncrypterDecrypter` role assigned for the key, or
+            # 3) access to the key is disabled.
+            #
+            # See [Enabling CMEK for Logs
+            # Router](https://cloud.google.com/logging/docs/routing/managed-encryption) for more information.
+            rpc :UpdateCmekSettings, Google::Cloud::Logging::V2::UpdateCmekSettingsRequest, Google::Cloud::Logging::V2::CmekSettings
+          end
+
+          Stub = Service.rpc_stub_class
+        end
+      end
+    end
+  end
+end

data/lib/google/logging/v2/logging_metrics_pb.rb

@@ -0,0 +1,75 @@
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/logging/v2/logging_metrics.proto
+
+require 'google/protobuf'
+
+require 'google/api/client_pb'
+require 'google/api/distribution_pb'
+require 'google/api/field_behavior_pb'
+require 'google/api/metric_pb'
+require 'google/api/resource_pb'
+require 'google/protobuf/duration_pb'
+require 'google/protobuf/empty_pb'
+require 'google/protobuf/field_mask_pb'
+require 'google/protobuf/timestamp_pb'
+require 'google/api/annotations_pb'
+Google::Protobuf::DescriptorPool.generated_pool.build do
+  add_file("google/logging/v2/logging_metrics.proto", :syntax => :proto3) do
+    add_message "google.logging.v2.LogMetric" do
+      optional :name, :string, 1
+      optional :description, :string, 2
+      optional :filter, :string, 3
+      optional :metric_descriptor, :message, 5, "google.api.MetricDescriptor"
+      optional :value_extractor, :string, 6
+      map :label_extractors, :string, :string, 7
+      optional :bucket_options, :message, 8, "google.api.Distribution.BucketOptions"
+      optional :create_time, :message, 9, "google.protobuf.Timestamp"
+      optional :update_time, :message, 10, "google.protobuf.Timestamp"
+      optional :version, :enum, 4, "google.logging.v2.LogMetric.ApiVersion"
+    end
+    add_enum "google.logging.v2.LogMetric.ApiVersion" do
+      value :V2, 0
+      value :V1, 1
+    end
+    add_message "google.logging.v2.ListLogMetricsRequest" do
+      optional :parent, :string, 1
+      optional :page_token, :string, 2
+      optional :page_size, :int32, 3
+    end
+    add_message "google.logging.v2.ListLogMetricsResponse" do
+      repeated :metrics, :message, 1, "google.logging.v2.LogMetric"
+      optional :next_page_token, :string, 2
+    end
+    add_message "google.logging.v2.GetLogMetricRequest" do
+      optional :metric_name, :string, 1
+    end
+    add_message "google.logging.v2.CreateLogMetricRequest" do
+      optional :parent, :string, 1
+      optional :metric, :message, 2, "google.logging.v2.LogMetric"
+    end
+    add_message "google.logging.v2.UpdateLogMetricRequest" do
+      optional :metric_name, :string, 1
+      optional :metric, :message, 2, "google.logging.v2.LogMetric"
+    end
+    add_message "google.logging.v2.DeleteLogMetricRequest" do
+      optional :metric_name, :string, 1
+    end
+  end
+end
+
+module Google
+  module Cloud
+    module Logging
+      module V2
+        LogMetric = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.logging.v2.LogMetric").msgclass
+        LogMetric::ApiVersion = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.logging.v2.LogMetric.ApiVersion").enummodule
+        ListLogMetricsRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.logging.v2.ListLogMetricsRequest").msgclass
+        ListLogMetricsResponse = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.logging.v2.ListLogMetricsResponse").msgclass
+        GetLogMetricRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.logging.v2.GetLogMetricRequest").msgclass
+        CreateLogMetricRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.logging.v2.CreateLogMetricRequest").msgclass
+        UpdateLogMetricRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.logging.v2.UpdateLogMetricRequest").msgclass
+        DeleteLogMetricRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.logging.v2.DeleteLogMetricRequest").msgclass
+      end
+    end
+  end
+end

data/lib/google/logging/v2/logging_metrics_services_pb.rb

@@ -0,0 +1,53 @@
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# Source: google/logging/v2/logging_metrics.proto for package 'Google.Cloud.Logging.V2'
+# Original file comments:
+# Copyright 2020 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
+#
+#     http://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.
+#
+
+require 'grpc'
+require 'google/logging/v2/logging_metrics_pb'
+
+module Google
+  module Cloud
+    module Logging
+      module V2
+        module MetricsServiceV2
+          # Service for configuring logs-based metrics.
+          class Service
+
+            include GRPC::GenericService
+
+            self.marshal_class_method = :encode
+            self.unmarshal_class_method = :decode
+            self.service_name = 'google.logging.v2.MetricsServiceV2'
+
+            # Lists logs-based metrics.
+            rpc :ListLogMetrics, Google::Cloud::Logging::V2::ListLogMetricsRequest, Google::Cloud::Logging::V2::ListLogMetricsResponse
+            # Gets a logs-based metric.
+            rpc :GetLogMetric, Google::Cloud::Logging::V2::GetLogMetricRequest, Google::Cloud::Logging::V2::LogMetric
+            # Creates a logs-based metric.
+            rpc :CreateLogMetric, Google::Cloud::Logging::V2::CreateLogMetricRequest, Google::Cloud::Logging::V2::LogMetric
+            # Creates or updates a logs-based metric.
+            rpc :UpdateLogMetric, Google::Cloud::Logging::V2::UpdateLogMetricRequest, Google::Cloud::Logging::V2::LogMetric
+            # Deletes a logs-based metric.
+            rpc :DeleteLogMetric, Google::Cloud::Logging::V2::DeleteLogMetricRequest, Google::Protobuf::Empty
+          end
+
+          Stub = Service.rpc_stub_class
+        end
+      end
+    end
+  end
+end

data/lib/google/logging/v2/logging_pb.rb

@@ -0,0 +1,83 @@
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/logging/v2/logging.proto
+
+require 'google/protobuf'
+
+require 'google/api/client_pb'
+require 'google/api/field_behavior_pb'
+require 'google/api/monitored_resource_pb'
+require 'google/api/resource_pb'
+require 'google/logging/v2/log_entry_pb'
+require 'google/logging/v2/logging_config_pb'
+require 'google/protobuf/duration_pb'
+require 'google/protobuf/empty_pb'
+require 'google/protobuf/timestamp_pb'
+require 'google/rpc/status_pb'
+require 'google/api/annotations_pb'
+Google::Protobuf::DescriptorPool.generated_pool.build do
+  add_file("google/logging/v2/logging.proto", :syntax => :proto3) do
+    add_message "google.logging.v2.DeleteLogRequest" do
+      optional :log_name, :string, 1
+    end
+    add_message "google.logging.v2.WriteLogEntriesRequest" do
+      optional :log_name, :string, 1
+      optional :resource, :message, 2, "google.api.MonitoredResource"
+      map :labels, :string, :string, 3
+      repeated :entries, :message, 4, "google.logging.v2.LogEntry"
+      optional :partial_success, :bool, 5
+      optional :dry_run, :bool, 6
+    end
+    add_message "google.logging.v2.WriteLogEntriesResponse" do
+    end
+    add_message "google.logging.v2.WriteLogEntriesPartialErrors" do
+      map :log_entry_errors, :int32, :message, 1, "google.rpc.Status"
+    end
+    add_message "google.logging.v2.ListLogEntriesRequest" do
+      repeated :resource_names, :string, 8
+      optional :filter, :string, 2
+      optional :order_by, :string, 3
+      optional :page_size, :int32, 4
+      optional :page_token, :string, 5
+    end
+    add_message "google.logging.v2.ListLogEntriesResponse" do
+      repeated :entries, :message, 1, "google.logging.v2.LogEntry"
+      optional :next_page_token, :string, 2
+    end
+    add_message "google.logging.v2.ListMonitoredResourceDescriptorsRequest" do
+      optional :page_size, :int32, 1
+      optional :page_token, :string, 2
+    end
+    add_message "google.logging.v2.ListMonitoredResourceDescriptorsResponse" do
+      repeated :resource_descriptors, :message, 1, "google.api.MonitoredResourceDescriptor"
+      optional :next_page_token, :string, 2
+    end
+    add_message "google.logging.v2.ListLogsRequest" do
+      optional :parent, :string, 1
+      optional :page_size, :int32, 2
+      optional :page_token, :string, 3
+    end
+    add_message "google.logging.v2.ListLogsResponse" do
+      repeated :log_names, :string, 3
+      optional :next_page_token, :string, 2
+    end
+  end
+end
+
+module Google
+  module Cloud
+    module Logging
+      module V2
+        DeleteLogRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.logging.v2.DeleteLogRequest").msgclass
+        WriteLogEntriesRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.logging.v2.WriteLogEntriesRequest").msgclass
+        WriteLogEntriesResponse = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.logging.v2.WriteLogEntriesResponse").msgclass
+        WriteLogEntriesPartialErrors = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.logging.v2.WriteLogEntriesPartialErrors").msgclass
+        ListLogEntriesRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.logging.v2.ListLogEntriesRequest").msgclass
+        ListLogEntriesResponse = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.logging.v2.ListLogEntriesResponse").msgclass
+        ListMonitoredResourceDescriptorsRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.logging.v2.ListMonitoredResourceDescriptorsRequest").msgclass
+        ListMonitoredResourceDescriptorsResponse = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.logging.v2.ListMonitoredResourceDescriptorsResponse").msgclass
+        ListLogsRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.logging.v2.ListLogsRequest").msgclass
+        ListLogsResponse = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.logging.v2.ListLogsResponse").msgclass
+      end
+    end
+  end
+end

data/lib/google/logging/v2/logging_services_pb.rb

@@ -0,0 +1,65 @@
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# Source: google/logging/v2/logging.proto for package 'Google.Cloud.Logging.V2'
+# Original file comments:
+# Copyright 2020 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
+#
+#     http://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.
+#
+
+require 'grpc'
+require 'google/logging/v2/logging_pb'
+
+module Google
+  module Cloud
+    module Logging
+      module V2
+        module LoggingServiceV2
+          # Service for ingesting and querying logs.
+          class Service
+
+            include GRPC::GenericService
+
+            self.marshal_class_method = :encode
+            self.unmarshal_class_method = :decode
+            self.service_name = 'google.logging.v2.LoggingServiceV2'
+
+            # Deletes all the log entries in a log. The log reappears if it receives new
+            # entries. Log entries written shortly before the delete operation might not
+            # be deleted. Entries received after the delete operation with a timestamp
+            # before the operation will be deleted.
+            rpc :DeleteLog, Google::Cloud::Logging::V2::DeleteLogRequest, Google::Protobuf::Empty
+            # Writes log entries to Logging. This API method is the
+            # only way to send log entries to Logging. This method
+            # is used, directly or indirectly, by the Logging agent
+            # (fluentd) and all logging libraries configured to use Logging.
+            # A single request may contain log entries for a maximum of 1000
+            # different resources (projects, organizations, billing accounts or
+            # folders)
+            rpc :WriteLogEntries, Google::Cloud::Logging::V2::WriteLogEntriesRequest, Google::Cloud::Logging::V2::WriteLogEntriesResponse
+            # Lists log entries.  Use this method to retrieve log entries that originated
+            # from a project/folder/organization/billing account.  For ways to export log
+            # entries, see [Exporting Logs](https://cloud.google.com/logging/docs/export).
+            rpc :ListLogEntries, Google::Cloud::Logging::V2::ListLogEntriesRequest, Google::Cloud::Logging::V2::ListLogEntriesResponse
+            # Lists the descriptors for monitored resource types used by Logging.
+            rpc :ListMonitoredResourceDescriptors, Google::Cloud::Logging::V2::ListMonitoredResourceDescriptorsRequest, Google::Cloud::Logging::V2::ListMonitoredResourceDescriptorsResponse
+            # Lists the logs in projects, organizations, folders, or billing accounts.
+            # Only logs that have entries are listed.
+            rpc :ListLogs, Google::Cloud::Logging::V2::ListLogsRequest, Google::Cloud::Logging::V2::ListLogsResponse
+          end
+
+          Stub = Service.rpc_stub_class
+        end
+      end
+    end
+  end
+end

data/proto_docs/README.md

@@ -0,0 +1,4 @@
+# Cloud Logging V2 Protocol Buffer Documentation
+
+These files are for the YARD documentation of the generated protobuf files.
+They are not intended to be required or loaded at runtime.

data/proto_docs/google/api/distribution.rb

@@ -0,0 +1,225 @@
+# frozen_string_literal: true
+
+# Copyright 2020 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
+    # `Distribution` contains summary statistics for a population of values. It
+    # optionally contains a histogram representing the distribution of those values
+    # across a set of buckets.
+    #
+    # The summary statistics are the count, mean, sum of the squared deviation from
+    # the mean, the minimum, and the maximum of the set of population of values.
+    # The histogram is based on a sequence of buckets and gives a count of values
+    # that fall into each bucket. The boundaries of the buckets are given either
+    # explicitly or by formulas for buckets of fixed or exponentially increasing
+    # widths.
+    #
+    # Although it is not forbidden, it is generally a bad idea to include
+    # non-finite values (infinities or NaNs) in the population of values, as this
+    # will render the `mean` and `sum_of_squared_deviation` fields meaningless.
+    # @!attribute [rw] count
+    #   @return [::Integer]
+    #     The number of values in the population. Must be non-negative. This value
+    #     must equal the sum of the values in `bucket_counts` if a histogram is
+    #     provided.
+    # @!attribute [rw] mean
+    #   @return [::Float]
+    #     The arithmetic mean of the values in the population. If `count` is zero
+    #     then this field must be zero.
+    # @!attribute [rw] sum_of_squared_deviation
+    #   @return [::Float]
+    #     The sum of squared deviations from the mean of the values in the
+    #     population. For values x_i this is:
+    #
+    #         Sum[i=1..n]((x_i - mean)^2)
+    #
+    #     Knuth, "The Art of Computer Programming", Vol. 2, page 323, 3rd edition
+    #     describes Welford's method for accumulating this sum in one pass.
+    #
+    #     If `count` is zero then this field must be zero.
+    # @!attribute [rw] range
+    #   @return [::Google::Api::Distribution::Range]
+    #     If specified, contains the range of the population values. The field
+    #     must not be present if the `count` is zero.
+    # @!attribute [rw] bucket_options
+    #   @return [::Google::Api::Distribution::BucketOptions]
+    #     Defines the histogram bucket boundaries. If the distribution does not
+    #     contain a histogram, then omit this field.
+    # @!attribute [rw] bucket_counts
+    #   @return [::Array<::Integer>]
+    #     The number of values in each bucket of the histogram, as described in
+    #     `bucket_options`. If the distribution does not have a histogram, then omit
+    #     this field. If there is a histogram, then the sum of the values in
+    #     `bucket_counts` must equal the value in the `count` field of the
+    #     distribution.
+    #
+    #     If present, `bucket_counts` should contain N values, where N is the number
+    #     of buckets specified in `bucket_options`. If you supply fewer than N
+    #     values, the remaining values are assumed to be 0.
+    #
+    #     The order of the values in `bucket_counts` follows the bucket numbering
+    #     schemes described for the three bucket types. The first value must be the
+    #     count for the underflow bucket (number 0). The next N-2 values are the
+    #     counts for the finite buckets (number 1 through N-2). The N'th value in
+    #     `bucket_counts` is the count for the overflow bucket (number N-1).
+    # @!attribute [rw] exemplars
+    #   @return [::Array<::Google::Api::Distribution::Exemplar>]
+    #     Must be in increasing order of `value` field.
+    class Distribution
+      include ::Google::Protobuf::MessageExts
+      extend ::Google::Protobuf::MessageExts::ClassMethods
+
+      # The range of the population values.
+      # @!attribute [rw] min
+      #   @return [::Float]
+      #     The minimum of the population values.
+      # @!attribute [rw] max
+      #   @return [::Float]
+      #     The maximum of the population values.
+      class Range
+        include ::Google::Protobuf::MessageExts
+        extend ::Google::Protobuf::MessageExts::ClassMethods
+      end
+
+      # `BucketOptions` describes the bucket boundaries used to create a histogram
+      # for the distribution. The buckets can be in a linear sequence, an
+      # exponential sequence, or each bucket can be specified explicitly.
+      # `BucketOptions` does not include the number of values in each bucket.
+      #
+      # A bucket has an inclusive lower bound and exclusive upper bound for the
+      # values that are counted for that bucket. The upper bound of a bucket must
+      # be strictly greater than the lower bound. The sequence of N buckets for a
+      # distribution consists of an underflow bucket (number 0), zero or more
+      # finite buckets (number 1 through N - 2) and an overflow bucket (number N -
+      # 1). The buckets are contiguous: the lower bound of bucket i (i > 0) is the
+      # same as the upper bound of bucket i - 1. The buckets span the whole range
+      # of finite values: lower bound of the underflow bucket is -infinity and the
+      # upper bound of the overflow bucket is +infinity. The finite buckets are
+      # so-called because both bounds are finite.
+      # @!attribute [rw] linear_buckets
+      #   @return [::Google::Api::Distribution::BucketOptions::Linear]
+      #     The linear bucket.
+      # @!attribute [rw] exponential_buckets
+      #   @return [::Google::Api::Distribution::BucketOptions::Exponential]
+      #     The exponential buckets.
+      # @!attribute [rw] explicit_buckets
+      #   @return [::Google::Api::Distribution::BucketOptions::Explicit]
+      #     The explicit buckets.
+      class BucketOptions
+        include ::Google::Protobuf::MessageExts
+        extend ::Google::Protobuf::MessageExts::ClassMethods
+
+        # Specifies a linear sequence of buckets that all have the same width
+        # (except 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)).
+        # @!attribute [rw] num_finite_buckets
+        #   @return [::Integer]
+        #     Must be greater than 0.
+        # @!attribute [rw] width
+        #   @return [::Float]
+        #     Must be greater than 0.
+        # @!attribute [rw] offset
+        #   @return [::Float]
+        #     Lower bound of the first bucket.
+        class Linear
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Specifies an exponential sequence of buckets that have a width that is
+        # 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 < N):       scale * (growth_factor ^ (i - 1)).
+        # @!attribute [rw] num_finite_buckets
+        #   @return [::Integer]
+        #     Must be greater than 0.
+        # @!attribute [rw] growth_factor
+        #   @return [::Float]
+        #     Must be greater than 1.
+        # @!attribute [rw] scale
+        #   @return [::Float]
+        #     Must be greater than 0.
+        class Exponential
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Specifies a set of buckets with arbitrary widths.
+        #
+        # There are `size(bounds) + 1` (= N) buckets. Bucket `i` has the following
+        # boundaries:
+        #
+        #    Upper bound (0 <= i < N-1):     bounds[i]
+        #    Lower bound (1 <= i < N);       bounds[i - 1]
+        #
+        # The `bounds` field must contain at least one element. If `bounds` has
+        # only one element, then there are no finite buckets, and that single
+        # element is the common boundary of the overflow and underflow buckets.
+        # @!attribute [rw] bounds
+        #   @return [::Array<::Float>]
+        #     The values must be monotonically increasing.
+        class Explicit
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+      end
+
+      # Exemplars are example points that may be used to annotate aggregated
+      # distribution values. They are metadata that gives information about a
+      # particular value added to a Distribution bucket, such as a trace ID that
+      # was active when a value was added. They may contain further information,
+      # such as a example values and timestamps, origin, etc.
+      # @!attribute [rw] value
+      #   @return [::Float]
+      #     Value of the exemplar point. This value determines to which bucket the
+      #     exemplar belongs.
+      # @!attribute [rw] timestamp
+      #   @return [::Google::Protobuf::Timestamp]
+      #     The observation (sampling) time of the above value.
+      # @!attribute [rw] attachments
+      #   @return [::Array<::Google::Protobuf::Any>]
+      #     Contextual information about the example value. Examples are:
+      #
+      #       Trace ID: type.googleapis.com/google.devtools.cloudtrace.v1.Trace
+      #
+      #       Literal string: type.googleapis.com/google.protobuf.StringValue
+      #
+      #       Labels dropped during aggregation:
+      #         type.googleapis.com/google.monitoring.v3.DroppedLabels
+      #
+      #     There may be only a single attachment of any given message type in a
+      #     single exemplar, and this is enforced by the system.
+      class Exemplar
+        include ::Google::Protobuf::MessageExts
+        extend ::Google::Protobuf::MessageExts::ClassMethods
+      end
+    end
+  end
+end