google-cloud-logging 1.5.1 → 1.5.2

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

@@ -12,21 +12,21 @@
       "retry_params": {
         "default": {
           "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": 90000
+          "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
         },
         "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
+          "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": {
@@ -47,7 +47,7 @@
         },
         "UpdateSink": {
           "timeout_millis": 120000,
-          "retry_codes_name": "non_idempotent",
+          "retry_codes_name": "idempotent",
           "retry_params_name": "default"
         },
         "DeleteSink": {

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

@@ -0,0 +1,38 @@
+# Copyright 2018 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,4 +1,4 @@
-# Copyright 2017 Google LLC
+# Copyright 2018 Google LLC
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.

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

@@ -1,4 +1,4 @@
-# Copyright 2017 Google LLC
+# Copyright 2018 Google LLC
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.

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

@@ -1,4 +1,4 @@
-# Copyright 2017 Google LLC
+# Copyright 2018 Google LLC
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.
@@ -19,14 +19,7 @@ module Google
     # 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-id+:
-    #
-    #         "projects/my-project-id/metricDescriptors/custom.googleapis.com%2Finvoice%2Fpaid%2Famount"
+    #     The resource name of the metric descriptor.
     # @!attribute [rw] type
     #   @return [String]
     #     The metric type, including its DNS name prefix. The type is not
@@ -93,8 +86,6 @@ module Google
     #
     #     **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+).
@@ -104,7 +95,7 @@ module Google
     #
     #         Expression = Component { "." Component } { "/" Component } ;
     #
-    #         Component = [ PREFIX ] UNIT [ Annotation ]
+    #         Component = ( [ PREFIX ] UNIT | "%" ) [ Annotation ]
     #                   | Annotation
     #                   | "1"
     #                   ;
@@ -118,6 +109,9 @@ module Google
     #       +{requests}/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.
     # @!attribute [rw] description
     #   @return [String]
     #     A detailed description of the metric, which can be used in documentation.
@@ -125,6 +119,8 @@ module Google
     #   @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.
     class MetricDescriptor
       # The kind of measurement. It describes how the data is reported.
       module MetricKind

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

@@ -1,4 +1,4 @@
-# Copyright 2017 Google LLC
+# Copyright 2018 Google LLC
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.
@@ -70,12 +70,36 @@ module Google
     #   @return [String]
     #     Required. The monitored resource type. This field must match
     #     the +type+ field of a {Google::Api::MonitoredResourceDescriptor MonitoredResourceDescriptor} object. For
-    #     example, the type of a Cloud SQL database is +"cloudsql_database"+.
+    #     example, the type of a Compute Engine VM instance is +gce_instance+.
     # @!attribute [rw] labels
     #   @return [Hash{String => String}]
     #     Required. Values for all of the labels listed in the associated monitored
-    #     resource descriptor. For example, Cloud SQL databases use the labels
-    #     +"database_id"+ and +"zone"+.
+    #     resource descriptor. For example, Compute Engine VM instances use the
+    #     labels +"project_id"+, +"instance_id"+, and +"zone"+.
     class MonitoredResource; end
+
+    # Auxiliary metadata for a {Google::Api::MonitoredResource MonitoredResource} object.
+    # {Google::Api::MonitoredResource MonitoredResource} objects contain the minimum set of information to
+    # uniquely identify a monitored resource instance. There is some other useful
+    # auxiliary metadata. Google Stackdriver Monitoring & Logging uses an ingestion
+    # pipeline to extract metadata for cloud resources of all types , and stores
+    # the metadata in this message.
+    # @!attribute [rw] system_labels
+    #   @return [Google::Protobuf::Struct]
+    #     Output only. Values for predefined system metadata labels.
+    #     System labels are a kind of metadata extracted by Google Stackdriver.
+    #     Stackdriver determines what system labels are useful and how to obtain
+    #     their values. Some examples: "machine_image", "vpc", "subnet_id",
+    #     "security_group", "name", etc.
+    #     System label values can be only strings, Boolean values, or a list of
+    #     strings. For example:
+    #
+    #         { "name": "my-test-instance",
+    #           "security_group": ["a", "b", "c"],
+    #           "spot_instance": false }
+    # @!attribute [rw] user_labels
+    #   @return [Hash{String => String}]
+    #     Output only. A map of user-defined metadata labels.
+    class MonitoredResourceMetadata; end
   end
 end

data/lib/google/cloud/logging/v2/doc/google/logging/type/http_request.rb

@@ -1,4 +1,4 @@
-# Copyright 2017 Google LLC
+# Copyright 2018 Google LLC
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.

data/lib/google/cloud/logging/v2/doc/google/logging/v2/log_entry.rb

@@ -1,4 +1,4 @@
-# Copyright 2017 Google LLC
+# Copyright 2018 Google LLC
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.
@@ -42,7 +42,7 @@ module Google
       #     any results.
       # @!attribute [rw] resource
       #   @return [Google::Api::MonitoredResource]
-      #     Required. The monitored resource associated with this log entry.
+      #     Required. The primary monitored resource associated with this log entry.
       #     Example: a log entry that reports a database error would be
       #     associated with the monitored resource designating the particular
       #     database that reported the error.
@@ -64,11 +64,15 @@ module Google
       #     This time is used to compute the log entry's age and to enforce
       #     the logs retention period. If this field is omitted in a new log
       #     entry, then Stackdriver Logging assigns it the current time.
+      #     Timestamps have nanosecond accuracy, but trailing zeros in the fractional
+      #     seconds might be omitted when the timestamp is displayed.
       #
       #     Incoming log entries should have timestamps that are no more than
-      #     the [logs retention period](https://cloud.google.com/logging/quota-policy) in the past,
-      #     and no more than 24 hours in the future.
-      #     See the +entries.write+ API method for more information.
+      #     the [logs retention period](https://cloud.google.com/logging/quotas) in the past,
+      #     and no more than 24 hours in the future. Log entries outside those time
+      #     boundaries will not be available when calling +entries.list+, but
+      #     those log entries can still be exported with
+      #     [LogSinks](https://cloud.google.com/logging/docs/api/tasks/exporting-logs).
       # @!attribute [rw] receive_timestamp
       #   @return [Google::Protobuf::Timestamp]
       #     Output only. The time the log entry was received by Stackdriver Logging.
@@ -92,6 +96,11 @@ module Google
       #   @return [Hash{String => String}]
       #     Optional. A set of user-defined (key, value) data that provides additional
       #     information about the log entry.
+      # @!attribute [rw] metadata
+      #   @return [Google::Api::MonitoredResourceMetadata]
+      #     Output only. Additional metadata about the monitored resource.
+      #     Only +k8s_container+, +k8s_pod+, and +k8s_node+ MonitoredResources have
+      #     this field populated.
       # @!attribute [rw] operation
       #   @return [Google::Logging::V2::LogEntryOperation]
       #     Optional. Information about an operation associated with the log entry, if
@@ -104,11 +113,10 @@ module Google
       #     +projects/my-projectid/traces/06796866738c859f2f19b7cfb3214824+
       # @!attribute [rw] span_id
       #   @return [String]
-      #     Optional. Id of the span within the trace associated with the log entry.
-      #     e.g. "0000000000000042"
-      #     For Stackdriver trace spans, this is the same format that the Stackdriver
-      #     trace API uses.
-      #     The ID is a 16-character hexadecimal encoding of an 8-byte array.
+      #     Optional. The span ID within the trace associated with the log entry. For
+      #     Stackdriver Trace spans, this is the same format that the Stackdriver Trace
+      #     API v2 uses: a 16-character hexadecimal encoding of an 8-byte array, such
+      #     as <code>"000000000000004a"</code>.
       # @!attribute [rw] source_location
       #   @return [Google::Logging::V2::LogEntrySourceLocation]
       #     Optional. Source code location information associated with the log entry,

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

@@ -1,4 +1,4 @@
-# Copyright 2017 Google LLC
+# Copyright 2018 Google LLC
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.
@@ -14,21 +14,6 @@
 
 module Google
   module Logging
-    ##
-    # # Stackdriver Logging API Contents
-    #
-    # | Class | Description |
-    # | ----- | ----------- |
-    # | [LoggingServiceV2Client][] | Writes log entries and manages your Stackdriver Logging configuration. |
-    # | [ConfigServiceV2Client][] | Writes log entries and manages your Stackdriver Logging configuration. |
-    # | [MetricsServiceV2Client][] | Writes log entries and manages your Stackdriver Logging configuration. |
-    # | [Data Types][] | Data types for Google::Cloud::Logging::V2 |
-    #
-    # [LoggingServiceV2Client]: https://googlecloudplatform.github.io/google-cloud-ruby/#/docs/google-cloud-logging/latest/google/logging/v2/loggingservicev2client
-    # [ConfigServiceV2Client]: https://googlecloudplatform.github.io/google-cloud-ruby/#/docs/google-cloud-logging/latest/google/logging/v2/configservicev2client
-    # [MetricsServiceV2Client]: https://googlecloudplatform.github.io/google-cloud-ruby/#/docs/google-cloud-logging/latest/google/logging/v2/metricsservicev2client
-    # [Data Types]: https://googlecloudplatform.github.io/google-cloud-ruby/#/docs/google-cloud-logging/latest/google/logging/v2/datatypes
-    #
     module V2
       # The parameters to DeleteLog.
       # @!attribute [rw] log_name
@@ -85,7 +70,8 @@ module Google
       #     entries in this list does not matter. Values supplied in this method's
       #     +log_name+, +resource+, and +labels+ fields are copied into those log
       #     entries in this list that do not include values for their corresponding
-      #     fields. For more information, see the {Google::Logging::V2::LogEntry LogEntry} type.
+      #     fields. For more information, see the
+      #     {Google::Logging::V2::LogEntry LogEntry} type.
       #
       #     If the +timestamp+ or +insert_id+ fields are missing in log entries, then
       #     this method supplies the current time or a unique identifier, respectively.
@@ -95,8 +81,9 @@ module Google
       #
       #     Log entries with timestamps that are more than the
       #     [logs retention period](https://cloud.google.com/logging/quota-policy) in the past or more than
-      #     24 hours in the future might be discarded. Discarding does not return
-      #     an error.
+      #     24 hours in the future will not be available when calling +entries.list+.
+      #     However, those log entries can still be exported with
+      #     [LogSinks](https://cloud.google.com/logging/docs/api/tasks/exporting-logs).
       #
       #     To improve throughput and to avoid exceeding the
       #     [quota limit](https://cloud.google.com/logging/quota-policy) for calls to +entries.write+,
@@ -109,6 +96,11 @@ module Google
       #     entry is not written, then the response status is the error associated
       #     with one of the failed entries and the response includes error details
       #     keyed by the entries' zero-based index in the +entries.write+ method.
+      # @!attribute [rw] dry_run
+      #   @return [true, false]
+      #     Optional. If true, the request should expect normal response, but the
+      #     entries won't be persisted nor exported. Useful for checking whether the
+      #     logging API endpoints are working properly before sending valuable data.
       class WriteLogEntriesRequest; end
 
       # Result returned from WriteLogEntries.

data/lib/google/cloud/logging/v2/doc/google/logging/v2/logging_config.rb

@@ -1,4 +1,4 @@
-# Copyright 2017 Google LLC
+# Copyright 2018 Google LLC
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.
@@ -14,21 +14,6 @@
 
 module Google
   module Logging
-    ##
-    # # Stackdriver Logging API Contents
-    #
-    # | Class | Description |
-    # | ----- | ----------- |
-    # | [LoggingServiceV2Client][] | Writes log entries and manages your Stackdriver Logging configuration. |
-    # | [ConfigServiceV2Client][] | Writes log entries and manages your Stackdriver Logging configuration. |
-    # | [MetricsServiceV2Client][] | Writes log entries and manages your Stackdriver Logging configuration. |
-    # | [Data Types][] | Data types for Google::Cloud::Logging::V2 |
-    #
-    # [LoggingServiceV2Client]: https://googlecloudplatform.github.io/google-cloud-ruby/#/docs/google-cloud-logging/latest/google/logging/v2/loggingservicev2client
-    # [ConfigServiceV2Client]: https://googlecloudplatform.github.io/google-cloud-ruby/#/docs/google-cloud-logging/latest/google/logging/v2/configservicev2client
-    # [MetricsServiceV2Client]: https://googlecloudplatform.github.io/google-cloud-ruby/#/docs/google-cloud-logging/latest/google/logging/v2/metricsservicev2client
-    # [Data Types]: https://googlecloudplatform.github.io/google-cloud-ruby/#/docs/google-cloud-logging/latest/google/logging/v2/datatypes
-    #
     module V2
       # Describes a sink used to export log entries to one of the following
       # destinations in any project: a Cloud Storage bucket, a BigQuery dataset, or a
@@ -281,12 +266,12 @@ module Google
       #     For example, the following filter matches 99% of low-severity log
       #     entries from load balancers:
       #
-      #         "resource.type=http_load_balancer severity<ERROR sample(insertId, 0.99)"
+      #     +"resource.type=http_load_balancer severity<ERROR sample(insertId, 0.99)"+
       # @!attribute [rw] disabled
       #   @return [true, false]
       #     Optional. If set to True, then this exclusion is disabled and it does not
       #     exclude any log entries. You can use
-      #     [exclusions.patch](https://cloud.google.com/logging/docs/alpha-exclusion/docs/reference/v2/rest/v2/projects.exclusions/patch)
+      #     [exclusions.patch](https://cloud.google.com/logging/docs/reference/v2/rest/v2/projects.exclusions/patch)
       #     to change the value of this field.
       class LogExclusion; end
 

data/lib/google/cloud/logging/v2/doc/google/logging/v2/logging_metrics.rb

@@ -1,4 +1,4 @@
-# Copyright 2017 Google LLC
+# Copyright 2018 Google LLC
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.
@@ -14,21 +14,6 @@
 
 module Google
   module Logging
-    ##
-    # # Stackdriver Logging API Contents
-    #
-    # | Class | Description |
-    # | ----- | ----------- |
-    # | [LoggingServiceV2Client][] | Writes log entries and manages your Stackdriver Logging configuration. |
-    # | [ConfigServiceV2Client][] | Writes log entries and manages your Stackdriver Logging configuration. |
-    # | [MetricsServiceV2Client][] | Writes log entries and manages your Stackdriver Logging configuration. |
-    # | [Data Types][] | Data types for Google::Cloud::Logging::V2 |
-    #
-    # [LoggingServiceV2Client]: https://googlecloudplatform.github.io/google-cloud-ruby/#/docs/google-cloud-logging/latest/google/logging/v2/loggingservicev2client
-    # [ConfigServiceV2Client]: https://googlecloudplatform.github.io/google-cloud-ruby/#/docs/google-cloud-logging/latest/google/logging/v2/configservicev2client
-    # [MetricsServiceV2Client]: https://googlecloudplatform.github.io/google-cloud-ruby/#/docs/google-cloud-logging/latest/google/logging/v2/metricsservicev2client
-    # [Data Types]: https://googlecloudplatform.github.io/google-cloud-ruby/#/docs/google-cloud-logging/latest/google/logging/v2/datatypes
-    #
     module V2
       # Describes a logs-based metric.  The value of the metric is the
       # number of log entries that match a logs filter in a given time interval.

data/lib/google/cloud/logging/v2/doc/google/protobuf/any.rb

@@ -1,4 +1,4 @@
-# Copyright 2017 Google LLC
+# Copyright 2018 Google LLC
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.

data/lib/google/cloud/logging/v2/doc/google/protobuf/duration.rb

@@ -1,4 +1,4 @@
-# Copyright 2017 Google LLC
+# Copyright 2018 Google LLC
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.

data/lib/google/cloud/logging/v2/doc/google/protobuf/empty.rb

@@ -0,0 +1,28 @@
+# Copyright 2018 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 Protobuf
+    # A generic empty message that you can re-use to avoid defining duplicated
+    # empty messages in your APIs. A typical example is to use it as the request
+    # or the response type of an API method. For instance:
+    #
+    #     service Foo {
+    #       rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty);
+    #     }
+    #
+    # The JSON representation for +Empty+ is empty JSON object +{}+.
+    class Empty; end
+  end
+end

data/lib/google/cloud/logging/v2/doc/google/protobuf/field_mask.rb

@@ -1,4 +1,4 @@
-# Copyright 2017 Google LLC
+# Copyright 2018 Google LLC
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.