google-cloud-logging 1.2.3 → 1.3.0

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

@@ -4,6 +4,7 @@
       "retry_codes": {
         "idempotent": [
           "DEADLINE_EXCEEDED",
+          "INTERNAL",
           "UNAVAILABLE"
         ],
         "non_idempotent": []
@@ -13,35 +14,69 @@
           "initial_retry_delay_millis": 100,
           "retry_delay_multiplier": 1.2,
           "max_retry_delay_millis": 1000,
-          "initial_rpc_timeout_millis": 2000,
+          "initial_rpc_timeout_millis": 30000,
           "rpc_timeout_multiplier": 1.5,
-          "max_rpc_timeout_millis": 30000,
-          "total_timeout_millis": 45000
+          "max_rpc_timeout_millis": 60000,
+          "total_timeout_millis": 90000
+        },
+        "write_sink": {
+          "initial_retry_delay_millis": 100,
+          "retry_delay_multiplier": 1.2,
+          "max_retry_delay_millis": 1000,
+          "initial_rpc_timeout_millis": 30000,
+          "rpc_timeout_multiplier": 1.5,
+          "max_rpc_timeout_millis": 60000,
+          "total_timeout_millis": 120000
         }
       },
       "methods": {
         "ListSinks": {
-          "timeout_millis": 30000,
+          "timeout_millis": 60000,
           "retry_codes_name": "idempotent",
           "retry_params_name": "default"
         },
         "GetSink": {
-          "timeout_millis": 30000,
+          "timeout_millis": 60000,
           "retry_codes_name": "idempotent",
           "retry_params_name": "default"
         },
         "CreateSink": {
-          "timeout_millis": 30000,
+          "timeout_millis": 120000,
           "retry_codes_name": "non_idempotent",
           "retry_params_name": "default"
         },
         "UpdateSink": {
-          "timeout_millis": 30000,
+          "timeout_millis": 120000,
           "retry_codes_name": "non_idempotent",
           "retry_params_name": "default"
         },
         "DeleteSink": {
-          "timeout_millis": 30000,
+          "timeout_millis": 60000,
+          "retry_codes_name": "idempotent",
+          "retry_params_name": "default"
+        },
+        "ListExclusions": {
+          "timeout_millis": 60000,
+          "retry_codes_name": "idempotent",
+          "retry_params_name": "default"
+        },
+        "GetExclusion": {
+          "timeout_millis": 60000,
+          "retry_codes_name": "idempotent",
+          "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"
+        },
+        "DeleteExclusion": {
+          "timeout_millis": 60000,
           "retry_codes_name": "idempotent",
           "retry_params_name": "default"
         }

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

@@ -0,0 +1,172 @@
+# Copyright 2017, Google Inc. All rights reserved.
+#
+# 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.
+
+module Google
+  module Api
+    # Distribution contains summary statistics for a population of values and,
+    # optionally, a histogram representing the distribution of those values across
+    # a specified set of histogram 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 specifying parameters for a method of computing them
+    # (buckets of fixed width or buckets of exponentially increasing width).
+    #
+    # 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.
+    # @!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.
+    # @!attribute [rw] bucket_counts
+    #   @return [Array<Integer>]
+    #     If +bucket_options+ is given, then the sum of the values in +bucket_counts+
+    #     must equal the value in +count+.  If +bucket_options+ is not given, no
+    #     +bucket_counts+ fields may be given.
+    #
+    #     Bucket counts are given in order under the numbering scheme described
+    #     above (the underflow bucket has number 0; the finite buckets, if any,
+    #     have numbers 1 through N-2; the overflow bucket has number N-1).
+    #
+    #     The size of +bucket_counts+ must be no greater than N as defined in
+    #     +bucket_options+.
+    #
+    #     Any suffix of trailing zero bucket_count fields may be omitted.
+    class Distribution
+      # 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; end
+
+      # A Distribution may optionally contain a histogram of the values in the
+      # population.  The histogram is given in +bucket_counts+ as counts of values
+      # that fall into one of a sequence of non-overlapping buckets.  The sequence
+      # of buckets is described by +bucket_options+.
+      #
+      # A bucket specifies an inclusive lower bound and exclusive upper bound for
+      # the values that are counted for that bucket.  The upper bound of a bucket
+      # is 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.
+      #
+      # +BucketOptions+ describes bucket boundaries in one of three ways.  Two
+      # describe the boundaries by giving parameters for a formula to generate
+      # boundaries and one gives the bucket boundaries explicitly.
+      #
+      # If +bucket_boundaries+ is not given, then no +bucket_counts+ may be given.
+      # @!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
+        # Specify a 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.
+        #
+        # Defines +num_finite_buckets + 2+ (= N) buckets with these boundaries for
+        # bucket +i+:
+        #
+        #    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
+
+        # Specify a 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.
+        #
+        # Defines +num_finite_buckets + 2+ (= N) buckets with these boundaries for
+        # bucket i:
+        #
+        #    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
+
+        # A set of buckets with arbitrary widths.
+        #
+        # Defines +size(bounds) + 1+ (= N) buckets with these boundaries for
+        # bucket i:
+        #
+        #    Upper bound (0 <= i < N-1):     bounds[i]
+        #    Lower bound (1 <= i < N);       bounds[i - 1]
+        #
+        # There must be at least one element in +bounds+.  If +bounds+ has only one
+        # element, 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/metric.rb

@@ -0,0 +1,187 @@
+# Copyright 2017, Google Inc. All rights reserved.
+#
+# 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.
+
+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. Depending on the
+    #     implementation, the name typically includes: (1) the parent resource name
+    #     that defines the scope of the metric type or of its data; and (2) the
+    #     metric's URL-encoded type, which also appears in the +type+ field of this
+    #     descriptor. For example, following is the resource name of a custom
+    #     metric within the GCP project +my-project+:
+    #
+    #         "projects/my-project/metricDescriptors/custom.googleapis.com%2Finvoice%2Fpaid%2Famount"
+    # @!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:
+    #
+    #         "custom.googleapis.com/invoice/paid/amount"
+    #         "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 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:
+    #
+    #     **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)
+    #
+    #     **Grammar**
+    #
+    #     The grammar includes the dimensionless unit +1+, such as +1/s+.
+    #
+    #     The grammar also includes these connectors:
+    #
+    #     * +/+    division (as an infix operator, e.g. +1/s+).
+    #     * +.+    multiplication (as an infix operator, e.g. +GBy.d+)
+    #
+    #     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+ and is
+    #       equivalent to +1+ if it is used alone. For examples,
+    #       +{requests}/s == 1/s+, +By{transmitted}/s == By/s+.
+    #     * +NAME+ is a sequence of non-blank printable ASCII characters not
+    #       containing '{' or '}'.
+    # @!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".
+    class MetricDescriptor
+      # 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
+
+    # A specific metric, identified by specifying values for all of the
+    # labels of a {Google::Api::MetricDescriptor +MetricDescriptor+}.
+    # @!attribute [rw] type
+    #   @return [String]
+    #     An existing metric type, see {Google::Api::MetricDescriptor}.
+    #     For example, +custom.googleapis.com/invoice/paid/amount+.
+    # @!attribute [rw] labels
+    #   @return [Hash{String => String}]
+    #     The set of label values that uniquely identify this metric. All
+    #     labels listed in the +MetricDescriptor+ must be assigned values.
+    class Metric; end
+  end
+end

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

@@ -14,7 +14,7 @@
 
 module Google
   module Api
-    # An object that describes the schema of a MonitoredResource object using a
+    # An object that describes the schema of a {Google::Api::MonitoredResource MonitoredResource} object using a
     # type name and a set of labels.  For example, the monitored resource
     # descriptor for Google Compute Engine VM instances has a type of
     # +"gce_instance"+ and specifies the use of the labels +"instance_id"+ and
@@ -56,11 +56,11 @@ module Google
     # An object representing a resource that can be used for monitoring, logging,
     # billing, or other purposes. Examples include virtual machine instances,
     # databases, and storage devices such as disks. The +type+ field identifies a
-    # MonitoredResourceDescriptor object that describes the resource's
+    # {Google::Api::MonitoredResourceDescriptor MonitoredResourceDescriptor} object that describes the resource's
     # schema. Information in the +labels+ field identifies the actual resource and
     # its attributes according to the schema. For example, a particular Compute
     # Engine VM instance could be represented by the following object, because the
-    # MonitoredResourceDescriptor for +"gce_instance"+ has labels
+    # {Google::Api::MonitoredResourceDescriptor MonitoredResourceDescriptor} for +"gce_instance"+ has labels
     # +"instance_id"+ and +"zone"+:
     #
     #     { "type": "gce_instance",
@@ -69,7 +69,7 @@ module Google
     # @!attribute [rw] type
     #   @return [String]
     #     Required. The monitored resource type. This field must match
-    #     the +type+ field of a MonitoredResourceDescriptor object. For
+    #     the +type+ field of a {Google::Api::MonitoredResourceDescriptor MonitoredResourceDescriptor} object. For
     #     example, the type of a Cloud SQL database is +"cloudsql_database"+.
     # @!attribute [rw] labels
     #   @return [Hash{String => String}]