google-cloud-logging 0.20.1 → 0.21.0

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

@@ -26,7 +26,7 @@ require "json"
 require "pathname"
 
 require "google/gax"
-require "google/logging/v2/logging_metrics_services_pb"
+require "google/logging/v2/logging_metrics_pb"
 
 module Google
   module Cloud
@@ -34,10 +34,10 @@ module Google
       module V2
         # Service for configuring logs-based metrics.
         #
-        # @!attribute [r] stub
+        # @!attribute [r] metrics_service_v2_stub
         #   @return [Google::Logging::V2::MetricsServiceV2::Stub]
         class MetricsServiceV2Api
-          attr_reader :stub
+          attr_reader :metrics_service_v2_stub
 
           # The default address of the service.
           SERVICE_ADDRESS = "logging.googleapis.com".freeze
@@ -150,8 +150,15 @@ module Google
               timeout: DEFAULT_TIMEOUT,
               app_name: "gax",
               app_version: Google::Gax::VERSION
+            # These require statements are intentionally placed here to initialize
+            # the gRPC module only when it's required.
+            # See https://github.com/googleapis/toolkit/issues/446
+            require "google/gax/grpc"
+            require "google/logging/v2/logging_metrics_services_pb"
+
             google_api_client = "#{app_name}/#{app_version} " \
-              "#{CODE_GEN_NAME_VERSION} ruby/#{RUBY_VERSION}".freeze
+              "#{CODE_GEN_NAME_VERSION} gax/#{Google::Gax::VERSION} " \
+              "ruby/#{RUBY_VERSION}".freeze
             headers = { :"x-goog-api-client" => google_api_client }
             client_config_file = Pathname.new(__dir__).join(
               "metrics_service_v2_client_config.json"
@@ -168,7 +175,7 @@ module Google
                 kwargs: headers
               )
             end
-            @stub = Google::Gax::Grpc.create_stub(
+            @metrics_service_v2_stub = Google::Gax::Grpc.create_stub(
               service_path,
               port,
               chan_creds: chan_creds,
@@ -178,23 +185,23 @@ module Google
             )
 
             @list_log_metrics = Google::Gax.create_api_call(
-              @stub.method(:list_log_metrics),
+              @metrics_service_v2_stub.method(:list_log_metrics),
               defaults["list_log_metrics"]
             )
             @get_log_metric = Google::Gax.create_api_call(
-              @stub.method(:get_log_metric),
+              @metrics_service_v2_stub.method(:get_log_metric),
               defaults["get_log_metric"]
             )
             @create_log_metric = Google::Gax.create_api_call(
-              @stub.method(:create_log_metric),
+              @metrics_service_v2_stub.method(:create_log_metric),
               defaults["create_log_metric"]
             )
             @update_log_metric = Google::Gax.create_api_call(
-              @stub.method(:update_log_metric),
+              @metrics_service_v2_stub.method(:update_log_metric),
               defaults["update_log_metric"]
             )
             @delete_log_metric = Google::Gax.create_api_call(
-              @stub.method(:delete_log_metric),
+              @metrics_service_v2_stub.method(:delete_log_metric),
               defaults["delete_log_metric"]
             )
           end
@@ -221,6 +228,27 @@ module Google
           #   operations such as per-page iteration or access to the response
           #   object.
           # @raise [Google::Gax::GaxError] if the RPC is aborted.
+          # @example
+          #   require "google/cloud/logging/v2/metrics_service_v2_api"
+          #
+          #   MetricsServiceV2Api = Google::Cloud::Logging::V2::MetricsServiceV2Api
+          #
+          #   metrics_service_v2_api = MetricsServiceV2Api.new
+          #   formatted_parent = MetricsServiceV2Api.parent_path("[PROJECT]")
+          #
+          #   # Iterate over all results.
+          #   metrics_service_v2_api.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|
+          #     # Process each page at a time.
+          #     page.each do |element|
+          #       # Process element.
+          #     end
+          #   end
+
           def list_log_metrics \
               parent,
               page_size: nil,
@@ -242,6 +270,15 @@ module Google
           #   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"
+          #
+          #   MetricsServiceV2Api = Google::Cloud::Logging::V2::MetricsServiceV2Api
+          #
+          #   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)
+
           def get_log_metric \
               metric_name,
               options: nil
@@ -266,6 +303,17 @@ module Google
           #   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"
+          #
+          #   LogMetric = Google::Logging::V2::LogMetric
+          #   MetricsServiceV2Api = Google::Cloud::Logging::V2::MetricsServiceV2Api
+          #
+          #   metrics_service_v2_api = MetricsServiceV2Api.new
+          #   formatted_parent = MetricsServiceV2Api.parent_path("[PROJECT]")
+          #   metric = LogMetric.new
+          #   response = metrics_service_v2_api.create_log_metric(formatted_parent, metric)
+
           def create_log_metric \
               parent,
               metric,
@@ -295,6 +343,17 @@ module Google
           #   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"
+          #
+          #   LogMetric = Google::Logging::V2::LogMetric
+          #   MetricsServiceV2Api = Google::Cloud::Logging::V2::MetricsServiceV2Api
+          #
+          #   metrics_service_v2_api = MetricsServiceV2Api.new
+          #   formatted_metric_name = MetricsServiceV2Api.metric_path("[PROJECT]", "[METRIC]")
+          #   metric = LogMetric.new
+          #   response = metrics_service_v2_api.update_log_metric(formatted_metric_name, metric)
+
           def update_log_metric \
               metric_name,
               metric,
@@ -315,6 +374,15 @@ module Google
           #   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"
+          #
+          #   MetricsServiceV2Api = Google::Cloud::Logging::V2::MetricsServiceV2Api
+          #
+          #   metrics_service_v2_api = MetricsServiceV2Api.new
+          #   formatted_metric_name = MetricsServiceV2Api.metric_path("[PROJECT]", "[METRIC]")
+          #   metrics_service_v2_api.delete_log_metric(formatted_metric_name)
+
           def delete_log_metric \
               metric_name,
               options: nil

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

@@ -16,7 +16,7 @@
 module Google
   module Cloud
     module Logging
-      VERSION = "0.20.1"
+      VERSION = "0.21.0"
     end
   end
 end

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

@@ -12,6 +12,7 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
     optional :destination, :string, 3
     optional :filter, :string, 5
     optional :output_version_format, :enum, 6, "google.logging.v2.LogSink.VersionFormat"
+    optional :writer_identity, :string, 8
   end
   add_enum "google.logging.v2.LogSink.VersionFormat" do
     value :VERSION_FORMAT_UNSPECIFIED, 0

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

@@ -39,7 +39,7 @@ module Google
           rpc :GetSink, GetSinkRequest, LogSink
           # Creates a sink.
           rpc :CreateSink, CreateSinkRequest, LogSink
-          # Creates or updates a sink.
+          # Updates or creates a sink.
           rpc :UpdateSink, UpdateSinkRequest, LogSink
           # Deletes a sink.
           rpc :DeleteSink, DeleteSinkRequest, Google::Protobuf::Empty

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

@@ -10,6 +10,11 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
     optional :name, :string, 1
     optional :description, :string, 2
     optional :filter, :string, 3
+    optional :version, :enum, 4, "google.logging.v2.LogMetric.ApiVersion"
+  end
+  add_enum "google.logging.v2.LogMetric.ApiVersion" do
+    value :V2, 0
+    value :V1, 1
   end
   add_message "google.logging.v2.ListLogMetricsRequest" do
     optional :parent, :string, 1
@@ -40,6 +45,7 @@ module Google
   module Logging
     module V2
       LogMetric = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.logging.v2.LogMetric").msgclass
+      LogMetric::ApiVersion = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.logging.v2.LogMetric.ApiVersion").enummodule
       ListLogMetricsRequest = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.logging.v2.ListLogMetricsRequest").msgclass
       ListLogMetricsResponse = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.logging.v2.ListLogMetricsResponse").msgclass
       GetLogMetricRequest = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.logging.v2.GetLogMetricRequest").msgclass

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

@@ -25,6 +25,7 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
   end
   add_message "google.logging.v2.ListLogEntriesRequest" do
     repeated :project_ids, :string, 1
+    repeated :resource_names, :string, 8
     optional :filter, :string, 2
     optional :order_by, :string, 3
     optional :page_size, :int32, 4

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

@@ -34,16 +34,13 @@ module Google
 
           # Deletes a log and all its log entries.
           # The log will reappear 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.
-          #
           rpc :WriteLogEntries, WriteLogEntriesRequest, WriteLogEntriesResponse
           # Lists log entries.  Use this method to retrieve log entries from Cloud
           # Logging.  For ways to export log entries, see
           # [Exporting Logs](/logging/docs/export).
-          #
           rpc :ListLogEntries, ListLogEntriesRequest, ListLogEntriesResponse
           # Lists the monitored resource descriptors used by Stackdriver Logging.
           rpc :ListMonitoredResourceDescriptors, ListMonitoredResourceDescriptorsRequest, ListMonitoredResourceDescriptorsResponse

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: google-cloud-logging
 version: !ruby/object:Gem::Version
-  version: 0.20.1
+  version: 0.21.0
 platform: ruby
 authors:
 - Mike Moore
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2016-09-02 00:00:00.000000000 Z
+date: 2016-10-20 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: google-cloud-core
@@ -17,14 +17,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.20.0
+        version: 0.21.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.20.0
+        version: 0.21.0
 - !ruby/object:Gem::Dependency
   name: grpc
   requirement: !ruby/object:Gem::Requirement
@@ -39,6 +39,20 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '1.0'
+- !ruby/object:Gem::Dependency
+  name: google-gax
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.6.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.6.0
 - !ruby/object:Gem::Dependency
   name: google-protobuf
   requirement: !ruby/object:Gem::Requirement
@@ -59,28 +73,28 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.2'
+        version: '1.3'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.2'
+        version: '1.3'
 - !ruby/object:Gem::Dependency
-  name: google-gax
+  name: orderedhash
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - '='
       - !ruby/object:Gem::Version
-        version: 0.4.4
+        version: 0.0.6
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - '='
       - !ruby/object:Gem::Version
-        version: 0.4.4
+        version: 0.0.6
 - !ruby/object:Gem::Dependency
   name: minitest
   requirement: !ruby/object:Gem::Requirement
@@ -193,6 +207,62 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '0.9'
+- !ruby/object:Gem::Dependency
+  name: yard-doctest
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.1.6
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.1.6
+- !ruby/object:Gem::Dependency
+  name: actionpack
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '4.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !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
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0.1'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0.1'
 description: google-cloud-logging is the official library for Stackdriver Logging.
 email:
 - mike@blowmage.com
@@ -203,6 +273,7 @@ extra_rdoc_files: []
 files:
 - lib/google-cloud-logging.rb
 - lib/google/cloud/logging.rb
+- lib/google/cloud/logging/async_writer.rb
 - lib/google/cloud/logging/credentials.rb
 - lib/google/cloud/logging/entry.rb
 - lib/google/cloud/logging/entry/http_request.rb
@@ -211,7 +282,9 @@ files:
 - lib/google/cloud/logging/logger.rb
 - lib/google/cloud/logging/metric.rb
 - lib/google/cloud/logging/metric/list.rb
+- lib/google/cloud/logging/middleware.rb
 - lib/google/cloud/logging/project.rb
+- lib/google/cloud/logging/rails.rb
 - lib/google/cloud/logging/resource.rb
 - lib/google/cloud/logging/resource_descriptor.rb
 - lib/google/cloud/logging/resource_descriptor/list.rb