google-cloud-logging 0.21.2 → 0.23.0

data/lib/google/cloud/logging/v2/{metrics_service_v2_api.rb → metrics_service_v2_client.rb}

@@ -36,7 +36,7 @@ module Google
         #
         # @!attribute [r] metrics_service_v2_stub
         #   @return [Google::Logging::V2::MetricsServiceV2::Stub]
-        class MetricsServiceV2Api
+        class MetricsServiceV2Client
           attr_reader :metrics_service_v2_stub
 
           # The default address of the service.
@@ -68,11 +68,11 @@ module Google
             "https://www.googleapis.com/auth/logging.write"
           ].freeze
 
-          PARENT_PATH_TEMPLATE = Google::Gax::PathTemplate.new(
+          PROJECT_PATH_TEMPLATE = Google::Gax::PathTemplate.new(
             "projects/{project}"
           )
 
-          private_constant :PARENT_PATH_TEMPLATE
+          private_constant :PROJECT_PATH_TEMPLATE
 
           METRIC_PATH_TEMPLATE = Google::Gax::PathTemplate.new(
             "projects/{project}/metrics/{metric}"
@@ -80,11 +80,11 @@ module Google
 
           private_constant :METRIC_PATH_TEMPLATE
 
-          # Returns a fully-qualified parent resource name string.
+          # Returns a fully-qualified project resource name string.
           # @param project [String]
           # @return [String]
-          def self.parent_path project
-            PARENT_PATH_TEMPLATE.render(
+          def self.project_path project
+            PROJECT_PATH_TEMPLATE.render(
               :"project" => project
             )
           end
@@ -100,11 +100,11 @@ module Google
             )
           end
 
-          # Parses the project from a parent resource.
-          # @param parent_name [String]
+          # Parses the project from a project resource.
+          # @param project_name [String]
           # @return [String]
-          def self.match_project_from_parent_name parent_name
-            PARENT_PATH_TEMPLATE.match(parent_name)["project"]
+          def self.match_project_from_project_name project_name
+            PROJECT_PATH_TEMPLATE.match(project_name)["project"]
           end
 
           # Parses the project from a metric resource.
@@ -156,6 +156,7 @@ module Google
             require "google/gax/grpc"
             require "google/logging/v2/logging_metrics_services_pb"
 
+
             google_api_client = "#{app_name}/#{app_version} " \
               "#{CODE_GEN_NAME_VERSION} gax/#{Google::Gax::VERSION} " \
               "ruby/#{RUBY_VERSION}".freeze
@@ -211,8 +212,9 @@ module Google
           # Lists logs-based metrics.
           #
           # @param parent [String]
-          #   Required. The resource name containing the metrics.
-          #   Example: +"projects/my-project-id"+.
+          #   Required. The name of the project containing the metrics:
+          #
+          #       "projects/[PROJECT_ID]"
           # @param page_size [Integer]
           #   The maximum number of resources contained in the underlying API
           #   response. If page streaming is performed per-resource, this
@@ -229,20 +231,20 @@ module Google
           #   object.
           # @raise [Google::Gax::GaxError] if the RPC is aborted.
           # @example
-          #   require "google/cloud/logging/v2/metrics_service_v2_api"
+          #   require "google/cloud/logging/v2/metrics_service_v2_client"
           #
-          #   MetricsServiceV2Api = Google::Cloud::Logging::V2::MetricsServiceV2Api
+          #   MetricsServiceV2Client = Google::Cloud::Logging::V2::MetricsServiceV2Client
           #
-          #   metrics_service_v2_api = MetricsServiceV2Api.new
-          #   formatted_parent = MetricsServiceV2Api.parent_path("[PROJECT]")
+          #   metrics_service_v2_client = MetricsServiceV2Client.new
+          #   formatted_parent = MetricsServiceV2Client.project_path("[PROJECT]")
           #
           #   # Iterate over all results.
-          #   metrics_service_v2_api.list_log_metrics(formatted_parent).each do |element|
+          #   metrics_service_v2_client.list_log_metrics(formatted_parent).each do |element|
           #     # Process element.
           #   end
           #
           #   # Or iterate over results one page at a time.
-          #   metrics_service_v2_api.list_log_metrics(formatted_parent).each_page do |page|
+          #   metrics_service_v2_client.list_log_metrics(formatted_parent).each_page do |page|
           #     # Process each page at a time.
           #     page.each do |element|
           #       # Process element.
@@ -263,21 +265,22 @@ module Google
           # Gets a logs-based metric.
           #
           # @param metric_name [String]
-          #   The resource name of the desired metric.
-          #   Example: +"projects/my-project-id/metrics/my-metric-id"+.
+          #   The resource name of the desired metric:
+          #
+          #       "projects/[PROJECT_ID]/metrics/[METRIC_ID]"
           # @param options [Google::Gax::CallOptions]
           #   Overrides the default settings for this call, e.g, timeout,
           #   retries, etc.
           # @return [Google::Logging::V2::LogMetric]
           # @raise [Google::Gax::GaxError] if the RPC is aborted.
           # @example
-          #   require "google/cloud/logging/v2/metrics_service_v2_api"
+          #   require "google/cloud/logging/v2/metrics_service_v2_client"
           #
-          #   MetricsServiceV2Api = Google::Cloud::Logging::V2::MetricsServiceV2Api
+          #   MetricsServiceV2Client = Google::Cloud::Logging::V2::MetricsServiceV2Client
           #
-          #   metrics_service_v2_api = MetricsServiceV2Api.new
-          #   formatted_metric_name = MetricsServiceV2Api.metric_path("[PROJECT]", "[METRIC]")
-          #   response = metrics_service_v2_api.get_log_metric(formatted_metric_name)
+          #   metrics_service_v2_client = MetricsServiceV2Client.new
+          #   formatted_metric_name = MetricsServiceV2Client.metric_path("[PROJECT]", "[METRIC]")
+          #   response = metrics_service_v2_client.get_log_metric(formatted_metric_name)
 
           def get_log_metric \
               metric_name,
@@ -291,8 +294,9 @@ module Google
           # Creates a logs-based metric.
           #
           # @param parent [String]
-          #   The resource name of the project in which to create the metric.
-          #   Example: +"projects/my-project-id"+.
+          #   The resource name of the project in which to create the metric:
+          #
+          #       "projects/[PROJECT_ID]"
           #
           #   The new metric must be provided in the request.
           # @param metric [Google::Logging::V2::LogMetric]
@@ -304,15 +308,15 @@ module Google
           # @return [Google::Logging::V2::LogMetric]
           # @raise [Google::Gax::GaxError] if the RPC is aborted.
           # @example
-          #   require "google/cloud/logging/v2/metrics_service_v2_api"
+          #   require "google/cloud/logging/v2/metrics_service_v2_client"
           #
           #   LogMetric = Google::Logging::V2::LogMetric
-          #   MetricsServiceV2Api = Google::Cloud::Logging::V2::MetricsServiceV2Api
+          #   MetricsServiceV2Client = Google::Cloud::Logging::V2::MetricsServiceV2Client
           #
-          #   metrics_service_v2_api = MetricsServiceV2Api.new
-          #   formatted_parent = MetricsServiceV2Api.parent_path("[PROJECT]")
+          #   metrics_service_v2_client = MetricsServiceV2Client.new
+          #   formatted_parent = MetricsServiceV2Client.project_path("[PROJECT]")
           #   metric = LogMetric.new
-          #   response = metrics_service_v2_api.create_log_metric(formatted_parent, metric)
+          #   response = metrics_service_v2_client.create_log_metric(formatted_parent, metric)
 
           def create_log_metric \
               parent,
@@ -328,31 +332,30 @@ module Google
           # Creates or updates a logs-based metric.
           #
           # @param metric_name [String]
-          #   The resource name of the metric to update.
-          #   Example: +"projects/my-project-id/metrics/my-metric-id"+.
+          #   The resource name of the metric to update:
+          #
+          #       "projects/[PROJECT_ID]/metrics/[METRIC_ID]"
           #
-          #   The updated metric must be provided in the request and have the
-          #   same identifier that is specified in +metricName+.
-          #   If the metric does not exist, it is created.
+          #   The updated metric must be provided in the request and it's
+          #   +name+ field must be the same as +[METRIC_ID]+ If the metric
+          #   does not exist in +[PROJECT_ID]+, then a new metric is created.
           # @param metric [Google::Logging::V2::LogMetric]
-          #   The updated metric, whose name must be the same as the
-          #   metric identifier in +metricName+. If +metricName+ does not
-          #   exist, then a new metric is created.
+          #   The updated metric.
           # @param options [Google::Gax::CallOptions]
           #   Overrides the default settings for this call, e.g, timeout,
           #   retries, etc.
           # @return [Google::Logging::V2::LogMetric]
           # @raise [Google::Gax::GaxError] if the RPC is aborted.
           # @example
-          #   require "google/cloud/logging/v2/metrics_service_v2_api"
+          #   require "google/cloud/logging/v2/metrics_service_v2_client"
           #
           #   LogMetric = Google::Logging::V2::LogMetric
-          #   MetricsServiceV2Api = Google::Cloud::Logging::V2::MetricsServiceV2Api
+          #   MetricsServiceV2Client = Google::Cloud::Logging::V2::MetricsServiceV2Client
           #
-          #   metrics_service_v2_api = MetricsServiceV2Api.new
-          #   formatted_metric_name = MetricsServiceV2Api.metric_path("[PROJECT]", "[METRIC]")
+          #   metrics_service_v2_client = MetricsServiceV2Client.new
+          #   formatted_metric_name = MetricsServiceV2Client.metric_path("[PROJECT]", "[METRIC]")
           #   metric = LogMetric.new
-          #   response = metrics_service_v2_api.update_log_metric(formatted_metric_name, metric)
+          #   response = metrics_service_v2_client.update_log_metric(formatted_metric_name, metric)
 
           def update_log_metric \
               metric_name,
@@ -368,20 +371,21 @@ module Google
           # Deletes a logs-based metric.
           #
           # @param metric_name [String]
-          #   The resource name of the metric to delete.
-          #   Example: +"projects/my-project-id/metrics/my-metric-id"+.
+          #   The resource name of the metric to delete:
+          #
+          #       "projects/[PROJECT_ID]/metrics/[METRIC_ID]"
           # @param options [Google::Gax::CallOptions]
           #   Overrides the default settings for this call, e.g, timeout,
           #   retries, etc.
           # @raise [Google::Gax::GaxError] if the RPC is aborted.
           # @example
-          #   require "google/cloud/logging/v2/metrics_service_v2_api"
+          #   require "google/cloud/logging/v2/metrics_service_v2_client"
           #
-          #   MetricsServiceV2Api = Google::Cloud::Logging::V2::MetricsServiceV2Api
+          #   MetricsServiceV2Client = Google::Cloud::Logging::V2::MetricsServiceV2Client
           #
-          #   metrics_service_v2_api = MetricsServiceV2Api.new
-          #   formatted_metric_name = MetricsServiceV2Api.metric_path("[PROJECT]", "[METRIC]")
-          #   metrics_service_v2_api.delete_log_metric(formatted_metric_name)
+          #   metrics_service_v2_client = MetricsServiceV2Client.new
+          #   formatted_metric_name = MetricsServiceV2Client.metric_path("[PROJECT]", "[METRIC]")
+          #   metrics_service_v2_client.delete_log_metric(formatted_metric_name)
 
           def delete_log_metric \
               metric_name,
@@ -390,6 +394,7 @@ module Google
               metric_name: metric_name
             }.delete_if { |_, v| v.nil? })
             @delete_log_metric.call(req, options)
+            nil
           end
         end
       end

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

@@ -16,7 +16,7 @@
 module Google
   module Cloud
     module Logging
-      VERSION = "0.21.2"
+      VERSION = "0.23.0"
     end
   end
 end

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

@@ -13,6 +13,8 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
     optional :filter, :string, 5
     optional :output_version_format, :enum, 6, "google.logging.v2.LogSink.VersionFormat"
     optional :writer_identity, :string, 8
+    optional :start_time, :message, 10, "google.protobuf.Timestamp"
+    optional :end_time, :message, 11, "google.protobuf.Timestamp"
   end
   add_enum "google.logging.v2.LogSink.VersionFormat" do
     value :VERSION_FORMAT_UNSPECIFIED, 0
@@ -34,10 +36,12 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
   add_message "google.logging.v2.CreateSinkRequest" do
     optional :parent, :string, 1
     optional :sink, :message, 2, "google.logging.v2.LogSink"
+    optional :unique_writer_identity, :bool, 3
   end
   add_message "google.logging.v2.UpdateSinkRequest" do
     optional :sink_name, :string, 1
     optional :sink, :message, 2, "google.logging.v2.LogSink"
+    optional :unique_writer_identity, :bool, 3
   end
   add_message "google.logging.v2.DeleteSinkRequest" do
     optional :sink_name, :string, 1

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

@@ -23,8 +23,8 @@ module Google
   module Logging
     module V2
       module ConfigServiceV2
-        # Service for configuring sinks used to export log entries outside Stackdriver
-        # Logging.
+        # Service for configuring sinks used to export log entries outside of
+        # Stackdriver Logging.
         class Service
 
           include GRPC::GenericService

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

@@ -32,8 +32,8 @@ module Google
           self.unmarshal_class_method = :decode
           self.service_name = 'google.logging.v2.LoggingServiceV2'
 
-          # Deletes a log and all its log entries.
-          # The log will reappear if it receives new entries.
+          # Deletes all the log entries in a log.
+          # The log reappears if it receives new entries.
           rpc :DeleteLog, DeleteLogRequest, Google::Protobuf::Empty
           # Writes log entries to Stackdriver Logging.  All log entries are
           # written by this method.

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: google-cloud-logging
 version: !ruby/object:Gem::Version
-  version: 0.21.2
+  version: 0.23.0
 platform: ruby
 authors:
 - Mike Moore
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2016-11-16 00:00:00.000000000 Z
+date: 2016-12-09 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: google-cloud-core
@@ -222,7 +222,7 @@ dependencies:
       - !ruby/object:Gem::Version
         version: 0.1.8
 - !ruby/object:Gem::Dependency
-  name: actionpack
+  name: railties
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
@@ -235,20 +235,6 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '4.0'
-- !ruby/object:Gem::Dependency
-  name: railties
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '3.2'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '3.2'
 - !ruby/object:Gem::Dependency
   name: rack
   requirement: !ruby/object:Gem::Requirement
@@ -295,8 +281,9 @@ files:
 - lib/google/cloud/logging/sink.rb
 - lib/google/cloud/logging/sink/list.rb
 - lib/google/cloud/logging/v2.rb
-- lib/google/cloud/logging/v2/config_service_v2_api.rb
+- lib/google/cloud/logging/v2/config_service_v2_client.rb
 - lib/google/cloud/logging/v2/config_service_v2_client_config.json
+- lib/google/cloud/logging/v2/doc/google/api/label.rb
 - lib/google/cloud/logging/v2/doc/google/api/monitored_resource.rb
 - lib/google/cloud/logging/v2/doc/google/logging/type/http_request.rb
 - lib/google/cloud/logging/v2/doc/google/logging/v2/log_entry.rb
@@ -306,9 +293,9 @@ files:
 - lib/google/cloud/logging/v2/doc/google/protobuf/any.rb
 - lib/google/cloud/logging/v2/doc/google/protobuf/duration.rb
 - lib/google/cloud/logging/v2/doc/google/protobuf/timestamp.rb
-- lib/google/cloud/logging/v2/logging_service_v2_api.rb
+- lib/google/cloud/logging/v2/logging_service_v2_client.rb
 - lib/google/cloud/logging/v2/logging_service_v2_client_config.json
-- lib/google/cloud/logging/v2/metrics_service_v2_api.rb
+- lib/google/cloud/logging/v2/metrics_service_v2_client.rb
 - lib/google/cloud/logging/v2/metrics_service_v2_client_config.json
 - lib/google/cloud/logging/version.rb
 - lib/google/logging/v2/log_entry_pb.rb
@@ -338,7 +325,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements: []
 rubyforge_project: 
-rubygems_version: 2.5.1
+rubygems_version: 2.4.5.1
 signing_key: 
 specification_version: 4
 summary: API Client library for Stackdriver Logging