google-cloud-logging 1.10.6 → 2.1.0

data/lib/google/cloud/logging/v2/config_service_v2_client_config.json

@@ -1,106 +0,0 @@
-{
-  "interfaces": {
-    "google.logging.v2.ConfigServiceV2": {
-      "retry_codes": {
-        "idempotent": [
-          "DEADLINE_EXCEEDED",
-          "INTERNAL",
-          "UNAVAILABLE"
-        ],
-        "non_idempotent": [],
-        "idempotent2": [
-          "DEADLINE_EXCEEDED",
-          "UNAVAILABLE"
-        ]
-      },
-      "retry_params": {
-        "default": {
-          "initial_retry_delay_millis": 100,
-          "retry_delay_multiplier": 1.3,
-          "max_retry_delay_millis": 60000,
-          "initial_rpc_timeout_millis": 20000,
-          "rpc_timeout_multiplier": 1.0,
-          "max_rpc_timeout_millis": 20000,
-          "total_timeout_millis": 600000
-        }
-      },
-      "methods": {
-        "DeleteSink": {
-          "timeout_millis": 60000,
-          "retry_codes_name": "idempotent",
-          "retry_params_name": "default"
-        },
-        "UpdateSink": {
-          "timeout_millis": 60000,
-          "retry_codes_name": "idempotent",
-          "retry_params_name": "default"
-        },
-        "DeleteExclusion": {
-          "timeout_millis": 60000,
-          "retry_codes_name": "idempotent",
-          "retry_params_name": "default"
-        },
-        "ListBuckets": {
-          "timeout_millis": 60000,
-          "retry_codes_name": "idempotent2",
-          "retry_params_name": "default"
-        },
-        "GetBucket": {
-          "timeout_millis": 60000,
-          "retry_codes_name": "idempotent2",
-          "retry_params_name": "default"
-        },
-        "UpdateBucket": {
-          "timeout_millis": 60000,
-          "retry_codes_name": "non_idempotent",
-          "retry_params_name": "default"
-        },
-        "ListSinks": {
-          "timeout_millis": 60000,
-          "retry_codes_name": "idempotent2",
-          "retry_params_name": "default"
-        },
-        "GetSink": {
-          "timeout_millis": 60000,
-          "retry_codes_name": "idempotent2",
-          "retry_params_name": "default"
-        },
-        "CreateSink": {
-          "timeout_millis": 60000,
-          "retry_codes_name": "non_idempotent",
-          "retry_params_name": "default"
-        },
-        "ListExclusions": {
-          "timeout_millis": 60000,
-          "retry_codes_name": "idempotent2",
-          "retry_params_name": "default"
-        },
-        "GetExclusion": {
-          "timeout_millis": 60000,
-          "retry_codes_name": "idempotent2",
-          "retry_params_name": "default"
-        },
-        "CreateExclusion": {
-          "timeout_millis": 60000,
-          "retry_codes_name": "non_idempotent",
-          "retry_params_name": "default"
-        },
-        "UpdateExclusion": {
-          "timeout_millis": 60000,
-          "retry_codes_name": "non_idempotent",
-          "retry_params_name": "default"
-        },
-        "GetCmekSettings": {
-          "timeout_millis": 60000,
-          "retry_codes_name": "idempotent2",
-          "retry_params_name": "default"
-        },
-        "UpdateCmekSettings": {
-          "timeout_millis": 60000,
-          "retry_codes_name": "non_idempotent",
-          "retry_params_name": "default"
-        }
-      }
-    }
-  }
-}

data/lib/google/cloud/logging/v2/credentials.rb

@@ -1,39 +0,0 @@
-# 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.
-
-
-require "googleauth"
-
-module Google
-  module Cloud
-    module Logging
-      module V2
-        class Credentials < Google::Auth::Credentials
-          SCOPE = ["https://www.googleapis.com/auth/logging.admin"].freeze
-          PATH_ENV_VARS = %w(LOGGING_CREDENTIALS
-                             LOGGING_KEYFILE
-                             GOOGLE_CLOUD_CREDENTIALS
-                             GOOGLE_CLOUD_KEYFILE
-                             GCLOUD_KEYFILE)
-          JSON_ENV_VARS = %w(LOGGING_CREDENTIALS_JSON
-                             LOGGING_KEYFILE_JSON
-                             GOOGLE_CLOUD_CREDENTIALS_JSON
-                             GOOGLE_CLOUD_KEYFILE_JSON
-                             GCLOUD_KEYFILE_JSON)
-          DEFAULT_PATHS = ["~/.config/gcloud/application_default_credentials.json"]
-        end
-      end
-    end
-  end
-end

data/lib/google/cloud/logging/v2/doc/google/api/distribution.rb

@@ -1,164 +0,0 @@
-# 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.
-
-
-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](https://cloud.google.com(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
-      # `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
-        # 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; 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; 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; end
-      end
-    end
-  end
-end

data/lib/google/cloud/logging/v2/doc/google/api/label.rb

@@ -1,42 +0,0 @@
-# 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.
-
-
-module Google
-  module Api
-    # A description of a label.
-    # @!attribute [rw] key
-    #   @return [String]
-    #     The label key.
-    # @!attribute [rw] value_type
-    #   @return [Google::Api::LabelDescriptor::ValueType]
-    #     The type of data that can be assigned to the label.
-    # @!attribute [rw] description
-    #   @return [String]
-    #     A human-readable description for the label.
-    class LabelDescriptor
-      # Value types that can be used as label values.
-      module ValueType
-        # A variable-length string. This is the default.
-        STRING = 0
-
-        # Boolean; true or false.
-        BOOL = 1
-
-        # A 64-bit signed integer.
-        INT64 = 2
-      end
-    end
-  end
-end

data/lib/google/cloud/logging/v2/doc/google/api/metric.rb

@@ -1,233 +0,0 @@
-# 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.
-
-
-module Google
-  module Api
-    # Defines a metric type and its schema. Once a metric descriptor is created,
-    # deleting or altering it stops data collection and makes the metric type's
-    # existing data unusable.
-    # @!attribute [rw] name
-    #   @return [String]
-    #     The resource name of the metric descriptor.
-    # @!attribute [rw] type
-    #   @return [String]
-    #     The metric type, including its DNS name prefix. The type is not
-    #     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>]
-    #     The set of labels that can be used to describe a specific
-    #     instance of this metric type. For example, the
-    #     `appengine.googleapis.com/http/server/response_latencies` metric
-    #     type has a label for the HTTP response code, `response_code`, so
-    #     you can look at latencies for successful responses or just
-    #     for responses that failed.
-    # @!attribute [rw] metric_kind
-    #   @return [Google::Api::MetricDescriptor::MetricKind]
-    #     Whether the metric records instantaneous values, changes to a value, etc.
-    #     Some combinations of `metric_kind` and `value_type` might not be supported.
-    # @!attribute [rw] value_type
-    #   @return [Google::Api::MetricDescriptor::ValueType]
-    #     Whether the measurement is an integer, a floating-point number, etc.
-    #     Some combinations of `metric_kind` and `value_type` might not be supported.
-    # @!attribute [rw] unit
-    #   @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.
-    #
-    #     Different systems may 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 may 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 custome 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](http://unitsofmeasure.org/ucum.html) standard:
-    #
-    #     **Basic units (UNIT)**
-    #
-    #     * `bit`   bit
-    #     * `By`    byte
-    #     * `s`     second
-    #     * `min`   minute
-    #     * `h`     hour
-    #     * `d`     day
-    #
-    #     **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)
-    #     * `Pi`    pebi    (2^50)
-    #
-    #     **Grammar**
-    #
-    #     The grammar also includes these connectors:
-    #
-    #     * `/`    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:
-    #
-    #         Expression = Component { "." Component } { "/" Component } ;
-    #
-    #         Component = ( [ PREFIX ] UNIT | "%" ) [ Annotation ]
-    #                   | Annotation
-    #                   | "1"
-    #                   ;
-    #
-    #         Annotation = "{" NAME "}" ;
-    #
-    #     Notes:
-    #
-    #     * `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 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.
-    # @!attribute [rw] display_name
-    #   @return [String]
-    #     A concise name for the metric, which can be displayed in user interfaces.
-    #     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.
-    class MetricDescriptor
-      # Additional annotations that can be used to guide the usage of a metric.
-      # @!attribute [rw] launch_stage
-      #   @return [Google::Api::LaunchStage]
-      #     Deprecated. Please use the MetricDescriptor.launch_stage instead.
-      #     The launch stage of the metric definition.
-      # @!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; end
-
-      # The kind of measurement. It describes how the data is reported.
-      module MetricKind
-        # Do not use this default value.
-        METRIC_KIND_UNSPECIFIED = 0
-
-        # An instantaneous measurement of a value.
-        GAUGE = 1
-
-        # The change in a value during a time interval.
-        DELTA = 2
-
-        # A value accumulated over a time interval.  Cumulative
-        # measurements in a time series should have 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.
-        CUMULATIVE = 3
-      end
-
-      # The value type of a metric.
-      module ValueType
-        # Do not use this default value.
-        VALUE_TYPE_UNSPECIFIED = 0
-
-        # The value is a boolean.
-        # This value type can be used only if the metric kind is `GAUGE`.
-        BOOL = 1
-
-        # The value is a signed 64-bit integer.
-        INT64 = 2
-
-        # The value is a double precision floating point number.
-        DOUBLE = 3
-
-        # The value is a text string.
-        # This value type can be used only if the metric kind is `GAUGE`.
-        STRING = 4
-
-        # The value is a {Google::Api::Distribution `Distribution`}.
-        DISTRIBUTION = 5
-
-        # The value is money.
-        MONEY = 6
-      end
-    end
-  end
-end