google-cloud-logging 1.6.2 → 1.6.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 0a51e25b285af5a7a2ae7e1481c8dc475e7f1eb54bc22133836f558d9565d09b
-  data.tar.gz: 936031f003cace1831927504995ee740f5bffaacf0ea9bf5d066e70b5467a18b
+  metadata.gz: bcbc7c47b6db3fc6f156af9ed6eb545352326b6eef6d526127e1f430f7228f62
+  data.tar.gz: c3edf43f7604b5dc3ce0bacfcb49b8beb289618d394a568462e542ea277beb13
 SHA512:
-  metadata.gz: 24811a00cdbb748d88c0446d7cada8a31c12e578392edbcc62872668c9e9caed788fe813f4dca1ef6daf6d6df86ca01ce36661a04ce0629c1271e82bf78cb9e7
-  data.tar.gz: eddb46cbe47a08f27f58ece3b520d5e494cc7b9ceb64a70f22659ffd209522e3e4be377b1d6fa4ff641bf5de7c20cb2c5e3f87faf6c284511997f1c520bf8bd4
+  metadata.gz: fd2ea2da3f2d6dd440f310766413086e28456a13d10e69478c09fd713f5cd28795e5dfdd383dd2d19a3aaa45e771c2d931011a90cbd578ae8e82b15d5161fc53
+  data.tar.gz: 84689a6d0b5d9308465ea074fcfefad1b11146d0c1515bca84ddd632fb53423912273d9302a89d8c4807bcbee7d1de53070a3e5f63b923a8419bcea5c1a72045

data/AUTHENTICATION.md

@@ -2,20 +2,39 @@
 
 In general, the google-cloud-logging library uses [Service
 Account](https://cloud.google.com/iam/docs/creating-managing-service-accounts)
-credentials to connect to Google Cloud services. When running on Compute Engine
+credentials to connect to Google Cloud services. When running within [Google
+Cloud Platform environments](#google-cloud-platform-environments)
 the credentials will be discovered automatically. When running on other
 environments, the Service Account credentials can be specified by providing the
 path to the [JSON
 keyfile](https://cloud.google.com/iam/docs/managing-service-account-keys) for
-the account (or the JSON itself) in environment variables. Additionally, Cloud
-SDK credentials can also be discovered automatically, but this is only
-recommended during development.
+the account (or the JSON itself) in [environment
+variables](#environment-variables). Additionally, Cloud SDK credentials can also
+be discovered automatically, but this is only recommended during development.
+
+## Quickstart
+
+1. [Create a service account and credentials](#creating-a-service-account).
+2. Set the [environment variable](#environment-variables).
+
+```sh
+export LOGGING_CREDENTIALS=/path/to/json`
+```
+
+3. Initialize the client.
+
+```ruby
+require "google/cloud/logging"
+
+client = Google::Cloud::Logging.new
+```
 
 ## Project and Credential Lookup
 
-The google-cloud-logging library aims to make authentication as simple as
-possible, and provides several mechanisms to configure your system without
-providing **Project ID** and **Service Account Credentials** directly in code.
+The google-cloud-logging library aims to make authentication
+as simple as possible, and provides several mechanisms to configure your system
+without providing **Project ID** and **Service Account Credentials** directly in
+code.
 
 **Project ID** is discovered in the following order:
 
@@ -23,6 +42,7 @@ providing **Project ID** and **Service Account Credentials** directly in code.
 2. Specify project ID in configuration
 3. Discover project ID in environment variables
 4. Discover GCE project ID
+5. Discover project ID in credentials JSON
 
 **Credentials** are discovered in the following order:
 
@@ -73,13 +93,12 @@ environment variable, or the **Credentials JSON** itself can be stored for
 environments such as Docker containers where writing files is difficult or not
 encouraged.
 
-The environment variables that Logging checks for project ID are:
+The environment variables that google-cloud-logging checks for project ID are:
 
 1. `LOGGING_PROJECT`
 2. `GOOGLE_CLOUD_PROJECT`
 
-The environment variables that Logging checks for credentials are configured on
-{Google::Cloud::Logging::V2::Credentials}:
+The environment variables that google-cloud-logging checks for credentials are configured on {Google::Cloud::Logging::V2::Credentials}:
 
 1. `LOGGING_CREDENTIALS` - Path to JSON file, or JSON contents
 2. `LOGGING_KEYFILE` - Path to JSON file, or JSON contents
@@ -93,7 +112,7 @@ require "google/cloud/logging"
 ENV["LOGGING_PROJECT"]     = "my-project-id"
 ENV["LOGGING_CREDENTIALS"] = "path/to/keyfile.json"
 
-logging = Google::Cloud::Logging.new
+client = Google::Cloud::Logging.new
 ```
 
 ### Configuration
@@ -108,7 +127,7 @@ Google::Cloud::Logging.configure do |config|
   config.credentials = "path/to/keyfile.json"
 end
 
-logging = Google::Cloud::Logging.new
+client = Google::Cloud::Logging.new
 ```
 
 ### Cloud SDK
@@ -141,7 +160,8 @@ Google Cloud requires a **Project ID** and **Service Account Credentials** to
 connect to the APIs. You will use the **Project ID** and **JSON key file** to
 connect to most services with google-cloud-logging.
 
-If you are not running this client on Google Compute Engine, you need a Google
+If you are not running this client within [Google Cloud Platform
+environments](#google-cloud-platform-environments), you need a Google
 Developers service account.
 
 1. Visit the [Google Developers Console][dev-console].

data/CHANGELOG.md

@@ -1,5 +1,12 @@
 # Release History
 
+### 1.6.3 / 2019-04-29
+
+* Add AUTHENTICATION.md guide.
+* Update generated documentation.
+* Update generated code examples.
+* Extract gRPC header values from request.
+
 ### 1.6.2 / 2019-02-13
 
 * Fix bug (typo) in retrieving default on_error proc.

data/lib/google/cloud/logging/async_writer.rb

@@ -382,7 +382,7 @@ module Google
                 @cond.wait
               else
                 # still waiting for the interval to publish the batch...
-                @cond.wait(@batch.publish_wait)
+                @cond.wait @batch.publish_wait
               end
             end
           end

data/lib/google/cloud/logging/convert.rb

@@ -32,7 +32,7 @@ module Google
         def self.array_to_list array
           # TODO: ArgumentError if array is not an Array
           Google::Protobuf::ListValue.new \
-            values: array.map { |o| object_to_value(o) }
+            values: array.map { |o| object_to_value o }
         end
 
         ##

data/lib/google/cloud/logging/entry.rb

@@ -449,11 +449,11 @@ module Google
           return new if grpc.nil?
           new.tap do |e|
             e.log_name = grpc.log_name
-            e.timestamp = extract_timestamp(grpc)
+            e.timestamp = extract_timestamp grpc
             e.severity = grpc.severity
             e.insert_id = grpc.insert_id
-            e.labels = Convert.map_to_hash(grpc.labels)
-            e.payload = extract_payload(grpc)
+            e.labels = Convert.map_to_hash grpc.labels
+            e.payload = extract_payload grpc
             e.instance_variable_set :@resource,
                                     Resource.from_grpc(grpc.resource)
             e.instance_variable_set :@http_request,

data/lib/google/cloud/logging/entry/list.rb

@@ -129,7 +129,7 @@ module Google
           def all request_limit: nil
             request_limit = request_limit.to_i if request_limit
             unless block_given?
-              return enum_for(:all, request_limit: request_limit)
+              return enum_for :all, request_limit: request_limit
             end
             results = self
             loop do

data/lib/google/cloud/logging/errors.rb

@@ -53,7 +53,7 @@ module Google
         attr_reader :entries
 
         def initialize message, entries = nil
-          super(message)
+          super message
           @entries = entries if entries
         end
       end
@@ -92,7 +92,7 @@ module Google
         attr_reader :entries
 
         def initialize message, entries = nil
-          super(message)
+          super message
           @entries = entries if entries
         end
       end

data/lib/google/cloud/logging/log/list.rb

@@ -113,7 +113,7 @@ module Google
           def all request_limit: nil
             request_limit = request_limit.to_i if request_limit
             unless block_given?
-              return enum_for(:all, request_limit: request_limit)
+              return enum_for :all, request_limit: request_limit
             end
             results = self
             loop do
@@ -131,7 +131,7 @@ module Google
           # @private New Log::List from a
           # Google::Logging::V2::ListLogsResponse object.
           def self.from_grpc grpc_list, service, resource: nil, max: nil
-            logs = new(Array(grpc_list.log_names))
+            logs = new Array(grpc_list.log_names)
             token = grpc_list.next_page_token
             token = nil if token == "".freeze
             logs.instance_variable_set :@token,    token

data/lib/google/cloud/logging/logger.rb

@@ -539,7 +539,7 @@ module Google
         def write_entry severity, message
           entry = Entry.new.tap do |e|
             e.timestamp = Time.now
-            e.severity = gcloud_severity(severity)
+            e.severity = gcloud_severity severity
             e.payload = message
           end
 
@@ -572,7 +572,7 @@ module Google
 
           request_env = info && info.env || {}
 
-          compute_labels(request_env).merge(merged_labels)
+          compute_labels(request_env).merge merged_labels
         end
 
         ##
@@ -621,8 +621,8 @@ module Google
         # @private Compute individual label value.
         # Value can be a Proc (function of the request env) or a static value.
         def compute_label_value request_env, value_or_proc
-          if value_or_proc.respond_to?(:call)
-            value_or_proc.call(request_env)
+          if value_or_proc.respond_to? :call
+            value_or_proc.call request_env
           else
             value_or_proc
           end

data/lib/google/cloud/logging/metric/list.rb

@@ -126,7 +126,7 @@ module Google
           def all request_limit: nil
             request_limit = request_limit.to_i if request_limit
             unless block_given?
-              return enum_for(:all, request_limit: request_limit)
+              return enum_for :all, request_limit: request_limit
             end
             results = self
             loop do

data/lib/google/cloud/logging/project.rb

@@ -209,7 +209,7 @@ module Google
           ensure_service!
 
           e = Entry.new
-          e.log_name = service.log_path(log_name) if log_name
+          e.log_name = service.log_path log_name if log_name
           e.resource = resource if resource
           e.timestamp = timestamp if timestamp
           e.severity = severity if severity

data/lib/google/cloud/logging/resource.rb

@@ -76,7 +76,7 @@ module Google
           return new if grpc.nil?
           new.tap do |r|
             r.type = grpc.type
-            r.labels = Convert.map_to_hash(grpc.labels)
+            r.labels = Convert.map_to_hash grpc.labels
           end
         end
       end

data/lib/google/cloud/logging/resource_descriptor/list.rb

@@ -131,7 +131,7 @@ module Google
           def all request_limit: nil
             request_limit = request_limit.to_i if request_limit
             unless block_given?
-              return enum_for(:all, request_limit: request_limit)
+              return enum_for :all, request_limit: request_limit
             end
             results = self
             loop do

data/lib/google/cloud/logging/service.rb

@@ -101,7 +101,7 @@ module Google
                           partial_success: nil
           # Fix log names so they are the full path
           entries = Array(entries).each do |entry|
-            entry.log_name = log_path(entry.log_name)
+            entry.log_name = log_path entry.log_name
           end
           resource = resource.to_grpc if resource
           labels = Hash[labels.map { |k, v| [String(k), String(v)] }] if labels

data/lib/google/cloud/logging/sink/list.rb

@@ -125,7 +125,7 @@ module Google
           def all request_limit: nil
             request_limit = request_limit.to_i if request_limit
             unless block_given?
-              return enum_for(:all, request_limit: request_limit)
+              return enum_for :all, request_limit: request_limit
             end
             results = self
             loop do

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

@@ -76,6 +76,12 @@ module Google
           ].freeze
 
 
+          EXCLUSION_PATH_TEMPLATE = Google::Gax::PathTemplate.new(
+            "projects/{project}/exclusions/{exclusion}"
+          )
+
+          private_constant :EXCLUSION_PATH_TEMPLATE
+
           PROJECT_PATH_TEMPLATE = Google::Gax::PathTemplate.new(
             "projects/{project}"
           )
@@ -88,11 +94,16 @@ module Google
 
           private_constant :SINK_PATH_TEMPLATE
 
-          EXCLUSION_PATH_TEMPLATE = Google::Gax::PathTemplate.new(
-            "projects/{project}/exclusions/{exclusion}"
-          )
-
-          private_constant :EXCLUSION_PATH_TEMPLATE
+          # Returns a fully-qualified exclusion resource name string.
+          # @param project [String]
+          # @param exclusion [String]
+          # @return [String]
+          def self.exclusion_path project, exclusion
+            EXCLUSION_PATH_TEMPLATE.render(
+              :"project" => project,
+              :"exclusion" => exclusion
+            )
+          end
 
           # Returns a fully-qualified project resource name string.
           # @param project [String]
@@ -114,17 +125,6 @@ module Google
             )
           end
 
-          # Returns a fully-qualified exclusion resource name string.
-          # @param project [String]
-          # @param exclusion [String]
-          # @return [String]
-          def self.exclusion_path project, exclusion
-            EXCLUSION_PATH_TEMPLATE.render(
-              :"project" => project,
-              :"exclusion" => exclusion
-            )
-          end
-
           # @param credentials [Google::Auth::Credentials, String, Hash, GRPC::Core::Channel, GRPC::Core::ChannelCredentials, Proc]
           #   Provides the means for authenticating requests made by the client. This parameter can
           #   be many types.
@@ -231,52 +231,82 @@ module Google
             @list_sinks = Google::Gax.create_api_call(
               @config_service_v2_stub.method(:list_sinks),
               defaults["list_sinks"],
-              exception_transformer: exception_transformer
+              exception_transformer: exception_transformer,
+              params_extractor: proc do |request|
+                {'parent' => request.parent}
+              end
             )
             @get_sink = Google::Gax.create_api_call(
               @config_service_v2_stub.method(:get_sink),
               defaults["get_sink"],
-              exception_transformer: exception_transformer
+              exception_transformer: exception_transformer,
+              params_extractor: proc do |request|
+                {'sink_name' => request.sink_name}
+              end
             )
             @create_sink = Google::Gax.create_api_call(
               @config_service_v2_stub.method(:create_sink),
               defaults["create_sink"],
-              exception_transformer: exception_transformer
+              exception_transformer: exception_transformer,
+              params_extractor: proc do |request|
+                {'parent' => request.parent}
+              end
             )
             @update_sink = Google::Gax.create_api_call(
               @config_service_v2_stub.method(:update_sink),
               defaults["update_sink"],
-              exception_transformer: exception_transformer
+              exception_transformer: exception_transformer,
+              params_extractor: proc do |request|
+                {'sink_name' => request.sink_name}
+              end
             )
             @delete_sink = Google::Gax.create_api_call(
               @config_service_v2_stub.method(:delete_sink),
               defaults["delete_sink"],
-              exception_transformer: exception_transformer
+              exception_transformer: exception_transformer,
+              params_extractor: proc do |request|
+                {'sink_name' => request.sink_name}
+              end
             )
             @list_exclusions = Google::Gax.create_api_call(
               @config_service_v2_stub.method(:list_exclusions),
               defaults["list_exclusions"],
-              exception_transformer: exception_transformer
+              exception_transformer: exception_transformer,
+              params_extractor: proc do |request|
+                {'parent' => request.parent}
+              end
             )
             @get_exclusion = Google::Gax.create_api_call(
               @config_service_v2_stub.method(:get_exclusion),
               defaults["get_exclusion"],
-              exception_transformer: exception_transformer
+              exception_transformer: exception_transformer,
+              params_extractor: proc do |request|
+                {'name' => request.name}
+              end
             )
             @create_exclusion = Google::Gax.create_api_call(
               @config_service_v2_stub.method(:create_exclusion),
               defaults["create_exclusion"],
-              exception_transformer: exception_transformer
+              exception_transformer: exception_transformer,
+              params_extractor: proc do |request|
+                {'parent' => request.parent}
+              end
             )
             @update_exclusion = Google::Gax.create_api_call(
               @config_service_v2_stub.method(:update_exclusion),
               defaults["update_exclusion"],
-              exception_transformer: exception_transformer
+              exception_transformer: exception_transformer,
+              params_extractor: proc do |request|
+                {'name' => request.name}
+              end
             )
             @delete_exclusion = Google::Gax.create_api_call(
               @config_service_v2_stub.method(:delete_exclusion),
               defaults["delete_exclusion"],
-              exception_transformer: exception_transformer
+              exception_transformer: exception_transformer,
+              params_extractor: proc do |request|
+                {'name' => request.name}
+              end
             )
           end
 
@@ -312,16 +342,16 @@ module Google
           # @example
           #   require "google/cloud/logging/v2"
           #
-          #   config_service_v2_client = Google::Cloud::Logging::V2::ConfigServiceV2Client.new
+          #   config_client = Google::Cloud::Logging::V2::ConfigServiceV2Client.new
           #   formatted_parent = Google::Cloud::Logging::V2::ConfigServiceV2Client.project_path("[PROJECT]")
           #
           #   # Iterate over all results.
-          #   config_service_v2_client.list_sinks(formatted_parent).each do |element|
+          #   config_client.list_sinks(formatted_parent).each do |element|
           #     # Process element.
           #   end
           #
           #   # Or iterate over results one page at a time.
-          #   config_service_v2_client.list_sinks(formatted_parent).each_page do |page|
+          #   config_client.list_sinks(formatted_parent).each_page do |page|
           #     # Process each page at a time.
           #     page.each do |element|
           #       # Process element.
@@ -363,9 +393,9 @@ module Google
           # @example
           #   require "google/cloud/logging/v2"
           #
-          #   config_service_v2_client = Google::Cloud::Logging::V2::ConfigServiceV2Client.new
+          #   config_client = Google::Cloud::Logging::V2::ConfigServiceV2Client.new
           #   formatted_sink_name = Google::Cloud::Logging::V2::ConfigServiceV2Client.sink_path("[PROJECT]", "[SINK]")
-          #   response = config_service_v2_client.get_sink(formatted_sink_name)
+          #   response = config_client.get_sink(formatted_sink_name)
 
           def get_sink \
               sink_name,
@@ -408,7 +438,8 @@ module Google
           #   If this field is set to true, or if the sink is owned by a non-project
           #   resource such as an organization, then the value of `writer_identity` will
           #   be a unique service account used only for exports from the new sink.  For
-          #   more information, see `writer_identity` in {Google::Logging::V2::LogSink LogSink}.
+          #   more information, see `writer_identity` in
+          #   {Google::Logging::V2::LogSink LogSink}.
           # @param options [Google::Gax::CallOptions]
           #   Overrides the default settings for this call, e.g, timeout,
           #   retries, etc.
@@ -420,12 +451,12 @@ module Google
           # @example
           #   require "google/cloud/logging/v2"
           #
-          #   config_service_v2_client = Google::Cloud::Logging::V2::ConfigServiceV2Client.new
+          #   config_client = Google::Cloud::Logging::V2::ConfigServiceV2Client.new
           #   formatted_parent = Google::Cloud::Logging::V2::ConfigServiceV2Client.project_path("[PROJECT]")
           #
           #   # TODO: Initialize `sink`:
           #   sink = {}
-          #   response = config_service_v2_client.create_sink(formatted_parent, sink)
+          #   response = config_client.create_sink(formatted_parent, sink)
 
           def create_sink \
               parent,
@@ -503,12 +534,12 @@ module Google
           # @example
           #   require "google/cloud/logging/v2"
           #
-          #   config_service_v2_client = Google::Cloud::Logging::V2::ConfigServiceV2Client.new
+          #   config_client = Google::Cloud::Logging::V2::ConfigServiceV2Client.new
           #   formatted_sink_name = Google::Cloud::Logging::V2::ConfigServiceV2Client.sink_path("[PROJECT]", "[SINK]")
           #
           #   # TODO: Initialize `sink`:
           #   sink = {}
-          #   response = config_service_v2_client.update_sink(formatted_sink_name, sink)
+          #   response = config_client.update_sink(formatted_sink_name, sink)
 
           def update_sink \
               sink_name,
@@ -550,9 +581,9 @@ module Google
           # @example
           #   require "google/cloud/logging/v2"
           #
-          #   config_service_v2_client = Google::Cloud::Logging::V2::ConfigServiceV2Client.new
+          #   config_client = Google::Cloud::Logging::V2::ConfigServiceV2Client.new
           #   formatted_sink_name = Google::Cloud::Logging::V2::ConfigServiceV2Client.sink_path("[PROJECT]", "[SINK]")
-          #   config_service_v2_client.delete_sink(formatted_sink_name)
+          #   config_client.delete_sink(formatted_sink_name)
 
           def delete_sink \
               sink_name,
@@ -596,16 +627,16 @@ module Google
           # @example
           #   require "google/cloud/logging/v2"
           #
-          #   config_service_v2_client = Google::Cloud::Logging::V2::ConfigServiceV2Client.new
+          #   config_client = Google::Cloud::Logging::V2::ConfigServiceV2Client.new
           #   formatted_parent = Google::Cloud::Logging::V2::ConfigServiceV2Client.project_path("[PROJECT]")
           #
           #   # Iterate over all results.
-          #   config_service_v2_client.list_exclusions(formatted_parent).each do |element|
+          #   config_client.list_exclusions(formatted_parent).each do |element|
           #     # Process element.
           #   end
           #
           #   # Or iterate over results one page at a time.
-          #   config_service_v2_client.list_exclusions(formatted_parent).each_page do |page|
+          #   config_client.list_exclusions(formatted_parent).each_page do |page|
           #     # Process each page at a time.
           #     page.each do |element|
           #       # Process element.
@@ -647,9 +678,9 @@ module Google
           # @example
           #   require "google/cloud/logging/v2"
           #
-          #   config_service_v2_client = Google::Cloud::Logging::V2::ConfigServiceV2Client.new
+          #   config_client = Google::Cloud::Logging::V2::ConfigServiceV2Client.new
           #   formatted_name = Google::Cloud::Logging::V2::ConfigServiceV2Client.exclusion_path("[PROJECT]", "[EXCLUSION]")
-          #   response = config_service_v2_client.get_exclusion(formatted_name)
+          #   response = config_client.get_exclusion(formatted_name)
 
           def get_exclusion \
               name,
@@ -691,12 +722,12 @@ module Google
           # @example
           #   require "google/cloud/logging/v2"
           #
-          #   config_service_v2_client = Google::Cloud::Logging::V2::ConfigServiceV2Client.new
+          #   config_client = Google::Cloud::Logging::V2::ConfigServiceV2Client.new
           #   formatted_parent = Google::Cloud::Logging::V2::ConfigServiceV2Client.project_path("[PROJECT]")
           #
           #   # TODO: Initialize `exclusion`:
           #   exclusion = {}
-          #   response = config_service_v2_client.create_exclusion(formatted_parent, exclusion)
+          #   response = config_client.create_exclusion(formatted_parent, exclusion)
 
           def create_exclusion \
               parent,
@@ -730,8 +761,9 @@ module Google
           # @param update_mask [Google::Protobuf::FieldMask | Hash]
           #   Required. A nonempty list of fields to change in the existing exclusion.
           #   New values for the fields are taken from the corresponding fields in the
-          #   {Google::Logging::V2::LogExclusion LogExclusion} included in this request. Fields not mentioned in
-          #   `update_mask` are not changed and are ignored in the request.
+          #   {Google::Logging::V2::LogExclusion LogExclusion} included in this request.
+          #   Fields not mentioned in `update_mask` are not changed and are ignored in
+          #   the request.
           #
           #   For example, to change the filter and description of an exclusion,
           #   specify an `update_mask` of `"filter,description"`.
@@ -748,7 +780,7 @@ module Google
           # @example
           #   require "google/cloud/logging/v2"
           #
-          #   config_service_v2_client = Google::Cloud::Logging::V2::ConfigServiceV2Client.new
+          #   config_client = Google::Cloud::Logging::V2::ConfigServiceV2Client.new
           #   formatted_name = Google::Cloud::Logging::V2::ConfigServiceV2Client.exclusion_path("[PROJECT]", "[EXCLUSION]")
           #
           #   # TODO: Initialize `exclusion`:
@@ -756,7 +788,7 @@ module Google
           #
           #   # TODO: Initialize `update_mask`:
           #   update_mask = {}
-          #   response = config_service_v2_client.update_exclusion(formatted_name, exclusion, update_mask)
+          #   response = config_client.update_exclusion(formatted_name, exclusion, update_mask)
 
           def update_exclusion \
               name,
@@ -794,9 +826,9 @@ module Google
           # @example
           #   require "google/cloud/logging/v2"
           #
-          #   config_service_v2_client = Google::Cloud::Logging::V2::ConfigServiceV2Client.new
+          #   config_client = Google::Cloud::Logging::V2::ConfigServiceV2Client.new
           #   formatted_name = Google::Cloud::Logging::V2::ConfigServiceV2Client.exclusion_path("[PROJECT]", "[EXCLUSION]")
-          #   config_service_v2_client.delete_exclusion(formatted_name)
+          #   config_client.delete_exclusion(formatted_name)
 
           def delete_exclusion \
               name,

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

@@ -42,7 +42,8 @@ module Google
       # @!attribute [rw] user_agent
       #   @return [String]
       #     The user agent sent by the client. Example:
-      #     `"Mozilla/4.0 (compatible; MSIE 6.0; Windows 98; Q312461; .NET CLR 1.0.3705)"`.
+      #     `"Mozilla/4.0 (compatible; MSIE 6.0; Windows 98; Q312461; .NET
+      #     CLR 1.0.3705)"`.
       # @!attribute [rw] remote_ip
       #   @return [String]
       #     The IP address (IPv4 or IPv6) of the client that issued the HTTP
@@ -54,7 +55,8 @@ module Google
       # @!attribute [rw] referer
       #   @return [String]
       #     The referer URL of the request, as defined in
-      #     [HTTP/1.1 Header Field Definitions](http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html).
+      #     [HTTP/1.1 Header Field
+      #     Definitions](http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html).
       # @!attribute [rw] latency
       #   @return [Google::Protobuf::Duration]
       #     The request processing latency on the server, from the time the request was

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

@@ -178,7 +178,8 @@ module Google
       #     If this field is set to true, or if the sink is owned by a non-project
       #     resource such as an organization, then the value of `writer_identity` will
       #     be a unique service account used only for exports from the new sink.  For
-      #     more information, see `writer_identity` in {Google::Logging::V2::LogSink LogSink}.
+      #     more information, see `writer_identity` in
+      #     {Google::Logging::V2::LogSink LogSink}.
       class CreateSinkRequest; end
 
       # The parameters to `UpdateSink`.
@@ -358,8 +359,9 @@ module Google
       #   @return [Google::Protobuf::FieldMask]
       #     Required. A nonempty list of fields to change in the existing exclusion.
       #     New values for the fields are taken from the corresponding fields in the
-      #     {Google::Logging::V2::LogExclusion LogExclusion} included in this request. Fields not mentioned in
-      #     `update_mask` are not changed and are ignored in the request.
+      #     {Google::Logging::V2::LogExclusion LogExclusion} included in this request.
+      #     Fields not mentioned in `update_mask` are not changed and are ignored in
+      #     the request.
       #
       #     For example, to change the filter and description of an exclusion,
       #     specify an `update_mask` of `"filter,description"`.

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

@@ -97,7 +97,8 @@ module Google
     # @!attribute [rw] type_url
     #   @return [String]
     #     A URL/resource name that uniquely identifies the type of the serialized
-    #     protocol buffer message. The last segment of the URL's path must represent
+    #     protocol buffer message. This string must contain at least
+    #     one "/" character. The last segment of the URL's path must represent
     #     the fully qualified name of the type (as in
     #     `path/google.protobuf.Duration`). The name should be in a canonical form
     #     (e.g., leading "." is not accepted).

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

@@ -83,57 +83,49 @@ module Google
     # describe the updated values, the API ignores the values of all
     # fields not covered by the mask.
     #
-    # If a repeated field is specified for an update operation, the existing
-    # repeated values in the target resource will be overwritten by the new values.
-    # Note that a repeated field is only allowed in the last position of a `paths`
-    # string.
+    # If a repeated field is specified for an update operation, new values will
+    # be appended to the existing repeated field in the target resource. Note that
+    # a repeated field is only allowed in the last position of a `paths` string.
     #
     # If a sub-message is specified in the last position of the field mask for an
-    # update operation, then the existing sub-message in the target resource is
-    # overwritten. Given the target message:
+    # update operation, then new value will be merged into the existing sub-message
+    # in the target resource.
+    #
+    # For example, given the target message:
     #
     #     f {
     #       b {
-    #         d : 1
-    #         x : 2
+    #         d: 1
+    #         x: 2
     #       }
-    #       c : 1
+    #       c: [1]
     #     }
     #
     # And an update message:
     #
     #     f {
     #       b {
-    #         d : 10
+    #         d: 10
     #       }
+    #       c: [2]
     #     }
     #
     # then if the field mask is:
     #
-    #  paths: "f.b"
+    #  paths: ["f.b", "f.c"]
     #
     # then the result will be:
     #
     #     f {
     #       b {
-    #         d : 10
+    #         d: 10
+    #         x: 2
     #       }
-    #       c : 1
+    #       c: [1, 2]
     #     }
     #
-    # However, if the update mask was:
-    #
-    #  paths: "f.b.d"
-    #
-    # then the result would be:
-    #
-    #     f {
-    #       b {
-    #         d : 10
-    #         x : 2
-    #       }
-    #       c : 1
-    #     }
+    # An implementation may provide options to override this default behavior for
+    # repeated and message fields.
     #
     # In order to reset a field's value to the default, the field must
     # be in the mask and set to the default value in the provided resource.

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

@@ -15,17 +15,19 @@
 
 module Google
   module Protobuf
-    # A Timestamp represents a point in time independent of any time zone
-    # or calendar, represented as seconds and fractions of seconds at
-    # nanosecond resolution in UTC Epoch time. It is encoded using the
-    # Proleptic Gregorian Calendar which extends the Gregorian calendar
-    # backwards to year one. It is encoded assuming all minutes are 60
-    # seconds long, i.e. leap seconds are "smeared" so that no leap second
-    # table is needed for interpretation. Range is from
-    # 0001-01-01T00:00:00Z to 9999-12-31T23:59:59.999999999Z.
-    # By restricting to that range, we ensure that we can convert to
-    # and from  RFC 3339 date strings.
-    # See [https://www.ietf.org/rfc/rfc3339.txt](https://www.ietf.org/rfc/rfc3339.txt).
+    # A Timestamp represents a point in time independent of any time zone or local
+    # calendar, encoded as a count of seconds and fractions of seconds at
+    # nanosecond resolution. The count is relative to an epoch at UTC midnight on
+    # January 1, 1970, in the proleptic Gregorian calendar which extends the
+    # Gregorian calendar backwards to year one.
+    #
+    # All minutes are 60 seconds long. Leap seconds are "smeared" so that no leap
+    # second table is needed for interpretation, using a [24-hour linear
+    # smear](https://developers.google.com/time/smear).
+    #
+    # The range is from 0001-01-01T00:00:00Z to 9999-12-31T23:59:59.999999999Z. By
+    # restricting to that range, we ensure that we can convert to and from [RFC
+    # 3339](https://www.ietf.org/rfc/rfc3339.txt) date strings.
     #
     # = Examples
     #
@@ -86,12 +88,12 @@ module Google
     # 01:30 UTC on January 15, 2017.
     #
     # In JavaScript, one can convert a Date object to this format using the
-    # standard [toISOString()](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Date/toISOString]
+    # standard [toISOString()](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Date/toISOString)
     # method. In Python, a standard `datetime.datetime` object can be converted
     # to this format using [`strftime`](https://docs.python.org/2/library/time.html#time.strftime)
     # with the time format spec '%Y-%m-%dT%H:%M:%S.%fZ'. Likewise, in Java, one
     # can use the Joda Time's [`ISODateTimeFormat.dateTime()`](
-    # http://www.joda.org/joda-time/apidocs/org/joda/time/format/ISODateTimeFormat.html#dateTime--
+    # http://www.joda.org/joda-time/apidocs/org/joda/time/format/ISODateTimeFormat.html#dateTime%2D%2D
     # ) to obtain a formatter capable of generating timestamps in this format.
     # @!attribute [rw] seconds
     #   @return [Integer]

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

@@ -230,7 +230,10 @@ module Google
             @delete_log = Google::Gax.create_api_call(
               @logging_service_v2_stub.method(:delete_log),
               defaults["delete_log"],
-              exception_transformer: exception_transformer
+              exception_transformer: exception_transformer,
+              params_extractor: proc do |request|
+                {'log_name' => request.log_name}
+              end
             )
             @write_log_entries = Google::Gax.create_api_call(
               @logging_service_v2_stub.method(:write_log_entries),
@@ -250,7 +253,10 @@ module Google
             @list_logs = Google::Gax.create_api_call(
               @logging_service_v2_stub.method(:list_logs),
               defaults["list_logs"],
-              exception_transformer: exception_transformer
+              exception_transformer: exception_transformer,
+              params_extractor: proc do |request|
+                {'parent' => request.parent}
+              end
             )
           end
 
@@ -284,9 +290,9 @@ module Google
           # @example
           #   require "google/cloud/logging/v2"
           #
-          #   logging_service_v2_client = Google::Cloud::Logging::V2::LoggingServiceV2Client.new
+          #   logging_client = Google::Cloud::Logging::V2::LoggingServiceV2Client.new
           #   formatted_log_name = Google::Cloud::Logging::V2::LoggingServiceV2Client.log_path("[PROJECT]", "[LOG]")
-          #   logging_service_v2_client.delete_log(formatted_log_name)
+          #   logging_client.delete_log(formatted_log_name)
 
           def delete_log \
               log_name,
@@ -389,11 +395,11 @@ module Google
           # @example
           #   require "google/cloud/logging/v2"
           #
-          #   logging_service_v2_client = Google::Cloud::Logging::V2::LoggingServiceV2Client.new
+          #   logging_client = Google::Cloud::Logging::V2::LoggingServiceV2Client.new
           #
           #   # TODO: Initialize `entries`:
           #   entries = []
-          #   response = logging_service_v2_client.write_log_entries(entries)
+          #   response = logging_client.write_log_entries(entries)
 
           def write_log_entries \
               entries,
@@ -472,18 +478,18 @@ module Google
           # @example
           #   require "google/cloud/logging/v2"
           #
-          #   logging_service_v2_client = Google::Cloud::Logging::V2::LoggingServiceV2Client.new
+          #   logging_client = Google::Cloud::Logging::V2::LoggingServiceV2Client.new
           #
           #   # TODO: Initialize `formatted_resource_names`:
           #   formatted_resource_names = []
           #
           #   # Iterate over all results.
-          #   logging_service_v2_client.list_log_entries(formatted_resource_names).each do |element|
+          #   logging_client.list_log_entries(formatted_resource_names).each do |element|
           #     # Process element.
           #   end
           #
           #   # Or iterate over results one page at a time.
-          #   logging_service_v2_client.list_log_entries(formatted_resource_names).each_page do |page|
+          #   logging_client.list_log_entries(formatted_resource_names).each_page do |page|
           #     # Process each page at a time.
           #     page.each do |element|
           #       # Process element.
@@ -532,15 +538,15 @@ module Google
           # @example
           #   require "google/cloud/logging/v2"
           #
-          #   logging_service_v2_client = Google::Cloud::Logging::V2::LoggingServiceV2Client.new
+          #   logging_client = Google::Cloud::Logging::V2::LoggingServiceV2Client.new
           #
           #   # Iterate over all results.
-          #   logging_service_v2_client.list_monitored_resource_descriptors.each do |element|
+          #   logging_client.list_monitored_resource_descriptors.each do |element|
           #     # Process element.
           #   end
           #
           #   # Or iterate over results one page at a time.
-          #   logging_service_v2_client.list_monitored_resource_descriptors.each_page do |page|
+          #   logging_client.list_monitored_resource_descriptors.each_page do |page|
           #     # Process each page at a time.
           #     page.each do |element|
           #       # Process element.
@@ -589,16 +595,16 @@ module Google
           # @example
           #   require "google/cloud/logging/v2"
           #
-          #   logging_service_v2_client = Google::Cloud::Logging::V2::LoggingServiceV2Client.new
+          #   logging_client = Google::Cloud::Logging::V2::LoggingServiceV2Client.new
           #   formatted_parent = Google::Cloud::Logging::V2::LoggingServiceV2Client.project_path("[PROJECT]")
           #
           #   # Iterate over all results.
-          #   logging_service_v2_client.list_logs(formatted_parent).each do |element|
+          #   logging_client.list_logs(formatted_parent).each do |element|
           #     # Process element.
           #   end
           #
           #   # Or iterate over results one page at a time.
-          #   logging_service_v2_client.list_logs(formatted_parent).each_page do |page|
+          #   logging_client.list_logs(formatted_parent).each_page do |page|
           #     # Process each page at a time.
           #     page.each do |element|
           #       # Process element.

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

@@ -71,26 +71,17 @@ module Google
           ].freeze
 
 
-          PROJECT_PATH_TEMPLATE = Google::Gax::PathTemplate.new(
-            "projects/{project}"
-          )
-
-          private_constant :PROJECT_PATH_TEMPLATE
-
           METRIC_PATH_TEMPLATE = Google::Gax::PathTemplate.new(
             "projects/{project}/metrics/{metric}"
           )
 
           private_constant :METRIC_PATH_TEMPLATE
 
-          # Returns a fully-qualified project resource name string.
-          # @param project [String]
-          # @return [String]
-          def self.project_path project
-            PROJECT_PATH_TEMPLATE.render(
-              :"project" => project
-            )
-          end
+          PROJECT_PATH_TEMPLATE = Google::Gax::PathTemplate.new(
+            "projects/{project}"
+          )
+
+          private_constant :PROJECT_PATH_TEMPLATE
 
           # Returns a fully-qualified metric resource name string.
           # @param project [String]
@@ -103,6 +94,15 @@ module Google
             )
           end
 
+          # Returns a fully-qualified project resource name string.
+          # @param project [String]
+          # @return [String]
+          def self.project_path project
+            PROJECT_PATH_TEMPLATE.render(
+              :"project" => project
+            )
+          end
+
           # @param credentials [Google::Auth::Credentials, String, Hash, GRPC::Core::Channel, GRPC::Core::ChannelCredentials, Proc]
           #   Provides the means for authenticating requests made by the client. This parameter can
           #   be many types.
@@ -209,27 +209,42 @@ module Google
             @list_log_metrics = Google::Gax.create_api_call(
               @metrics_service_v2_stub.method(:list_log_metrics),
               defaults["list_log_metrics"],
-              exception_transformer: exception_transformer
+              exception_transformer: exception_transformer,
+              params_extractor: proc do |request|
+                {'parent' => request.parent}
+              end
             )
             @get_log_metric = Google::Gax.create_api_call(
               @metrics_service_v2_stub.method(:get_log_metric),
               defaults["get_log_metric"],
-              exception_transformer: exception_transformer
+              exception_transformer: exception_transformer,
+              params_extractor: proc do |request|
+                {'metric_name' => request.metric_name}
+              end
             )
             @create_log_metric = Google::Gax.create_api_call(
               @metrics_service_v2_stub.method(:create_log_metric),
               defaults["create_log_metric"],
-              exception_transformer: exception_transformer
+              exception_transformer: exception_transformer,
+              params_extractor: proc do |request|
+                {'parent' => request.parent}
+              end
             )
             @update_log_metric = Google::Gax.create_api_call(
               @metrics_service_v2_stub.method(:update_log_metric),
               defaults["update_log_metric"],
-              exception_transformer: exception_transformer
+              exception_transformer: exception_transformer,
+              params_extractor: proc do |request|
+                {'metric_name' => request.metric_name}
+              end
             )
             @delete_log_metric = Google::Gax.create_api_call(
               @metrics_service_v2_stub.method(:delete_log_metric),
               defaults["delete_log_metric"],
-              exception_transformer: exception_transformer
+              exception_transformer: exception_transformer,
+              params_extractor: proc do |request|
+                {'metric_name' => request.metric_name}
+              end
             )
           end
 
@@ -262,16 +277,16 @@ module Google
           # @example
           #   require "google/cloud/logging/v2"
           #
-          #   metrics_service_v2_client = Google::Cloud::Logging::V2::MetricsServiceV2Client.new
+          #   metrics_client = Google::Cloud::Logging::V2::MetricsServiceV2Client.new
           #   formatted_parent = Google::Cloud::Logging::V2::MetricsServiceV2Client.project_path("[PROJECT]")
           #
           #   # Iterate over all results.
-          #   metrics_service_v2_client.list_log_metrics(formatted_parent).each do |element|
+          #   metrics_client.list_log_metrics(formatted_parent).each do |element|
           #     # Process element.
           #   end
           #
           #   # Or iterate over results one page at a time.
-          #   metrics_service_v2_client.list_log_metrics(formatted_parent).each_page do |page|
+          #   metrics_client.list_log_metrics(formatted_parent).each_page do |page|
           #     # Process each page at a time.
           #     page.each do |element|
           #       # Process element.
@@ -308,9 +323,9 @@ module Google
           # @example
           #   require "google/cloud/logging/v2"
           #
-          #   metrics_service_v2_client = Google::Cloud::Logging::V2::MetricsServiceV2Client.new
+          #   metrics_client = Google::Cloud::Logging::V2::MetricsServiceV2Client.new
           #   formatted_metric_name = Google::Cloud::Logging::V2::MetricsServiceV2Client.metric_path("[PROJECT]", "[METRIC]")
-          #   response = metrics_service_v2_client.get_log_metric(formatted_metric_name)
+          #   response = metrics_client.get_log_metric(formatted_metric_name)
 
           def get_log_metric \
               metric_name,
@@ -347,12 +362,12 @@ module Google
           # @example
           #   require "google/cloud/logging/v2"
           #
-          #   metrics_service_v2_client = Google::Cloud::Logging::V2::MetricsServiceV2Client.new
+          #   metrics_client = Google::Cloud::Logging::V2::MetricsServiceV2Client.new
           #   formatted_parent = Google::Cloud::Logging::V2::MetricsServiceV2Client.project_path("[PROJECT]")
           #
           #   # TODO: Initialize `metric`:
           #   metric = {}
-          #   response = metrics_service_v2_client.create_log_metric(formatted_parent, metric)
+          #   response = metrics_client.create_log_metric(formatted_parent, metric)
 
           def create_log_metric \
               parent,
@@ -392,12 +407,12 @@ module Google
           # @example
           #   require "google/cloud/logging/v2"
           #
-          #   metrics_service_v2_client = Google::Cloud::Logging::V2::MetricsServiceV2Client.new
+          #   metrics_client = Google::Cloud::Logging::V2::MetricsServiceV2Client.new
           #   formatted_metric_name = Google::Cloud::Logging::V2::MetricsServiceV2Client.metric_path("[PROJECT]", "[METRIC]")
           #
           #   # TODO: Initialize `metric`:
           #   metric = {}
-          #   response = metrics_service_v2_client.update_log_metric(formatted_metric_name, metric)
+          #   response = metrics_client.update_log_metric(formatted_metric_name, metric)
 
           def update_log_metric \
               metric_name,
@@ -428,9 +443,9 @@ module Google
           # @example
           #   require "google/cloud/logging/v2"
           #
-          #   metrics_service_v2_client = Google::Cloud::Logging::V2::MetricsServiceV2Client.new
+          #   metrics_client = Google::Cloud::Logging::V2::MetricsServiceV2Client.new
           #   formatted_metric_name = Google::Cloud::Logging::V2::MetricsServiceV2Client.metric_path("[PROJECT]", "[METRIC]")
-          #   metrics_service_v2_client.delete_log_metric(formatted_metric_name)
+          #   metrics_client.delete_log_metric(formatted_metric_name)
 
           def delete_log_metric \
               metric_name,

data/lib/google/cloud/logging/version.rb

@@ -16,7 +16,7 @@
 module Google
   module Cloud
     module Logging
-      VERSION = "1.6.2".freeze
+      VERSION = "1.6.3".freeze
     end
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: google-cloud-logging
 version: !ruby/object:Gem::Version
-  version: 1.6.2
+  version: 1.6.3
 platform: ruby
 authors:
 - Mike Moore
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2019-02-13 00:00:00.000000000 Z
+date: 2019-04-30 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: google-cloud-core
@@ -171,14 +171,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.61.0
+        version: 0.64.0
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.61.0
+        version: 0.64.0
 - !ruby/object:Gem::Dependency
   name: simplecov
   requirement: !ruby/object:Gem::Requirement
@@ -341,8 +341,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubyforge_project: 
-rubygems_version: 2.7.6
+rubygems_version: 3.0.3
 signing_key: 
 specification_version: 4
 summary: API Client library for Stackdriver Logging