google-cloud-error_reporting 0.21.2 → 0.22.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 5d58bf7edce901f57f1e6e680d57347da8d83fa9
-  data.tar.gz: 4556aac61b491671c8a50537cbaccac2e4899bcf
+  metadata.gz: f93ca0a20107de7406b4100003ef402539f8867a
+  data.tar.gz: 627b82ce4399a5c4b1b6d2e643d5f9752b4c3780
 SHA512:
-  metadata.gz: 284712d8623c4f5ea02232c300a96636a3968db21f16b09493eb04b4a98d8002f288da50fc10543a51f43a34bb088e8234906e282e6dd607aa78f384b94c6c4d
-  data.tar.gz: 452b7d6312fc5866d4c9b86491f49b17a393011b0131ec46ffa857a0ccb6ee8c6ece1661dae4f7433174fadfa38d14fb5b62c1a371a92823ac26c0361a93f398
+  metadata.gz: ee743297d9b2719da8d78abb30a6190709ca3e85e274d04a245d7ac65850de6b2c04f793d1c4f05aff5d3c57fd158e341838824ecdb9ccb39ef94e3e6b4c80d5
+  data.tar.gz: dbe964fac5a5429a2780266d6295d175343918f0fb68670af1c6de84595302321b30234f1fbc6130c8fee7aef0ddde5570a8dce301ee12920668e8e1d23c85a2

data/.yardopts

@@ -1,5 +1,7 @@
 --no-private
 --title=Stackdriver Error Reporting
+--exclude lib/google/devtools/clouderrorreporting/v1beta1
+--markup markdown
 
 ./lib/**/*.rb
 -

data/README.md

@@ -1,18 +1,18 @@
-Stackdriver Clouderrorreporting API for Ruby
+Stackdriver Error Reporting API for Ruby
 =================================================
 
 google-cloud-error_reporting uses [Google API extensions][google-gax] to provide an
-easy-to-use client library for the [Stackdriver Clouderrorreporting API][] (v1beta1) defined in the [googleapis][] git repository
+easy-to-use client library for the [Stackdriver Error Reporting API][] (v1beta1) defined in the [googleapis][] git repository
 
 
-[googleapis]: https://github.com/googleapis/googleapis/tree/master/google/google/devtools/clouderrorreporting/v1beta1
+[googleapis]: https://github.com/googleapis/googleapis/tree/master/google/devtools/clouderrorreporting/v1beta1
 [google-gax]: https://github.com/googleapis/gax-ruby
-[Stackdriver Clouderrorreporting API]: https://developers.google.com/apis-explorer/#p/clouderrorreporting/v1beta1/
+[Stackdriver Error Reporting API]: https://developers.google.com/apis-explorer/#p/clouderrorreporting/v1beta1/
 
 Getting started
 ---------------
 
-google-cloud-error_reporting will allow you to connect to the [Stackdriver Clouderrorreporting API][] and access all its methods.
+google-cloud-error_reporting will allow you to connect to the [Stackdriver Error Reporting API][] and access all its methods.
 
 In order to achieve so you need to set up authentication as well as install the library locally.
 
@@ -29,7 +29,7 @@ or
 
     $ gcloud auth login
 
-Please see [[gcloud beta auth application-default login][] document for the difference between these commands.
+Please see [gcloud beta auth application-default login][] document for the difference between these commands.
 
 [Google Cloud SDK]: https://cloud.google.com/sdk/
 [gcloud beta auth application-default login]: https://cloud.google.com/sdk/gcloud/reference/beta/auth/application-default/login

data/lib/google-cloud-error_reporting.rb

@@ -0,0 +1,24 @@
+# Copyright 2016 Google Inc. All rights reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+##
+# This file is here to be autorequired by bundler, so that the .logging and
+# #logging methods can be available, but the library and all dependencies won't
+# be loaded until required and used.
+
+
+gem "google-cloud-core"
+require "google/cloud"
+
+# There is no Google::Cloud integration to add.

data/lib/google/cloud/error_reporting/middleware.rb

@@ -12,6 +12,9 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
+
+require "google/cloud/core/environment"
+require "google/cloud/error_reporting/v1beta1"
 require "rack"
 require "rack/request"
 
@@ -33,8 +36,9 @@ module Google
         # Construct a new instance of Middleware
         #
         # @param [Rack Application] app The Rack application
-        # @param [Google::Cloud::ErrorReporting::V1beta1::ReportErrorsServiceApi]
-        #   error_reporting A ErrorReporting::V1beta1::ReportErrorsServiceApi
+        # @param [
+        #   Google::Cloud::ErrorReporting::V1beta1::ReportErrorsServiceClient]
+        #   error_reporting A ErrorReporting::V1beta1::ReportErrorsServiceClient
         #   object to for reporting exceptions
         # @param [String] project_id Name of GCP project. Default to
         #   ENV["ERROR_REPORTING_PROJECT"] then ENV["GOOGLE_CLOUD_PROJECT"].
@@ -50,13 +54,14 @@ module Google
         # @return [Google::Cloud::ErrorReporting::Middleware] A new instance of
         #   Middleware
         #
-        def initialize app, error_reporting: nil, project_id: nil,
-                       service_name: nil, service_version: nil,
+        def initialize app,
+                       error_reporting: V1beta1::ReportErrorsServiceClient.new,
+                       project_id: nil,
+                       service_name: nil,
+                       service_version: nil,
                        ignore_classes: nil
           @app = app
-          @error_reporting = error_reporting ||
-            Google::Cloud::ErrorReporting::V1beta1::ReportErrorsServiceApi.new
-
+          @error_reporting = error_reporting
           @service_name = service_name ||
                           ENV["ERROR_REPORTING_SERVICE"] ||
                           Google::Cloud::Core::Environment.gae_module_id ||
@@ -70,7 +75,7 @@ module Google
                         ENV["GOOGLE_CLOUD_PROJECT"] ||
                         Google::Cloud::Core::Environment.project_id
 
-          raise ArgumentError, "project_id is required" if @project_id.nil?
+          fail ArgumentError, "project_id is required" if @project_id.nil?
         end
 
         ##
@@ -113,16 +118,15 @@ module Google
           # Do not any exceptions that's specified by the ignore_classes list.
           return if ignore_classes.include? exception.class
 
-          error_event = build_error_event_from_exception env,
-                                                         exception
+          error_event_grpc = build_error_event_from_exception env, exception
 
           # If this exception maps to a HTTP status code less than 500, do
           # not report it.
           status_code =
-            error_event.context.http_request.response_status_code.to_i
+            error_event_grpc.context.http_request.response_status_code.to_i
           return if status_code > 0 && status_code < 500
 
-          error_reporting.report_error_event full_project_id, error_event
+          error_reporting.report_error_event full_project_id, error_event_grpc
         end
 
         ##
@@ -137,80 +141,42 @@ module Google
         # @param [Hash] env Rack environment hash
         # @param [Exception] exception Exception to convert from
         #
-        # @return [Google::Devtools::Clouderrorreporting::V1beta1::ReportedErrorEvent]
-        #   The gRPC ReportedErrorEvent object that's based on given exception
+        # @return [
+        #   Google::Devtools::Clouderrorreporting::V1beta1::ReportedErrorEvent]
+        #   The gRPC ReportedErrorEvent object that's based
+        #   on given exception
         #
         def build_error_event_from_exception env, exception
-          # Build service_context hash
-          service_context = {
-                              service: service_name,
-                              version: service_version
-                            }.delete_if { |k,v| v.nil? }
-
-          # Build error message and source_location hash
-          if exception.backtrace.nil? || exception.backtrace.empty?
-            message = exception.message
-            report_location = nil
-          else
-            message = "#{exception.backtrace.first}: #{exception.message} " \
-                      "(#{exception.class})\n\t" +
-                      exception.backtrace.drop(1).join("\n\t")
-            file_path, line_number, function_name =
-              exception.backtrace.first.split(":")
-            function_name = function_name.to_s[/`(.*)'/, 1]
-            report_location = {
-                                file_path: file_path,
-                                function_name: function_name,
-                                line_number: line_number.to_i
-                              }.delete_if { |k,v| v.nil? }
-          end
+          error_event = ErrorEvent.from_exception exception
+
+          # Inject service_context info into error_event object
+          error_event[:service_context] = {
+            service: service_name,
+            version: service_version
+          }.delete_if { |_, v| v.nil? }
 
-          # Build http_request_context hash
+          # Inject http_request_context info into error_event object
           rack_request = Rack::Request.new env
-          http_method = rack_request.request_method
-          http_url = rack_request.url
-          http_user_agent = rack_request.user_agent
-          http_referrer = rack_request.referrer
-          http_status = get_http_status exception
-          http_remote_ip = rack_request.ip
-          http_request_context = {
-                                   method: http_method,
-                                   url: http_url,
-                                   user_agent: http_user_agent,
-                                   referrer: http_referrer,
-                                   response_status_code: http_status,
-                                   remote_ip: http_remote_ip
-                                 }.delete_if { |k,v| v.nil? }
-
-          # Build error_context hash
-          error_context = {
-                            http_request: http_request_context,
-                            user: ENV["USER"],
-                            report_location: report_location,
-                          }.delete_if { |k,v| v.nil? }
-
-          # Build error_event hash
-          t = Time.now
-          error_event = {
-            event_time: {
-              seconds: t.to_i,
-              nanos: t.nsec
-            },
-            service_context: service_context,
-            message: message,
-            context: error_context
-          }.delete_if { |k,v| v.nil? }
-
-          # Finally build and return GRPC ErrorEvent
-          Google::Devtools::Clouderrorreporting::V1beta1::ReportedErrorEvent.decode_json \
-            error_event.to_json
+          error_event[:context][:http_request] = {
+            method: rack_request.request_method,
+            url: rack_request.url,
+            user_agent: rack_request.user_agent,
+            referrer: rack_request.referrer,
+            response_status_code: get_http_status(exception),
+            remote_ip: rack_request.ip
+          }.delete_if { |_, v| v.nil? }
+
+          error_event.to_grpc
         end
 
         ##
-        # Build full ReportErrorsServiceApi project_path from project_id, which
-        # is in "projects/#{project_id}" format.
+        # Build full ReportErrorsServiceClient project_path from project_id,
+        # which is in "projects/#{project_id}" format.
+        #
+        # @return [String] fully qualified project id in
+        #   "projects/#{project_id}" format
         def full_project_id
-          Google::Cloud::ErrorReporting::V1beta1::ReportErrorsServiceApi.project_path project_id
+          V1beta1::ReportErrorsServiceClient.project_path project_id
         end
 
         private
@@ -238,6 +204,110 @@ module Google
 
           http_status
         end
+
+        ##
+        # This class implements a hash representation of
+        # Devtools::Clouderrorreporting::V1beta1::ReportedErrorEvent
+        class ErrorEvent
+          # Internal data structure mirroring gRPC ReportedErrorEvent structure
+          attr_reader :hash
+
+          ##
+          # Construct a new ErrorEvent object
+          #
+          # @return [ErrorEvent] A new ErrorEvent object
+          def initialize
+            @hash = {}
+          end
+
+          ##
+          # Construct an ErrorEvent object based on a given exception
+          #
+          # @param [Exception] exception A Ruby exception
+          #
+          # @return [ErrorEvent] An ErrorEvent object containing information
+          #   from the given exception
+          def self.from_exception exception
+            exception_data = extract_exception exception
+
+            # Build error_context hash
+            error_context = {
+              user: ENV["USER"],
+              report_location: {
+                file_path: exception_data[:file_path],
+                function_name: exception_data[:function_name],
+                line_number: exception_data[:line_number].to_i
+              }.delete_if { |_, v| v.nil? }
+            }.delete_if { |_, v| v.nil? }
+
+            # Build error_event hash
+            error_event = ErrorEvent.new
+            t = Time.now
+            error_event.hash.merge!({
+              event_time: {
+                seconds: t.to_i,
+                nanos: t.nsec
+              },
+              message: exception_data[:message],
+              context: error_context
+            }.delete_if { |_, v| v.nil? })
+
+            error_event
+          end
+
+          ##
+          # Helper method extract data from exception
+          #
+          # @param [Exception] exception A Ruby Exception
+          #
+          # @return [Hash] A hash containing formatted error message with
+          # backtrace, file_path, line_number, and function_name
+          def self.extract_exception exception
+            if exception.backtrace.nil? || exception.backtrace.empty?
+              message = exception.message
+            else
+              message = "#{exception.backtrace.first}: #{exception.message} " \
+                        "(#{exception.class})\n\t" +
+                        exception.backtrace.drop(1).join("\n\t")
+              file_path, line_number, function_name =
+                exception.backtrace.first.split(":")
+              function_name = function_name.to_s[/`(.*)'/, 1]
+            end
+
+            {
+              message: message,
+              file_path: file_path,
+              line_number: line_number,
+              function_name: function_name
+            }
+          end
+          private_class_method :extract_exception
+
+          ##
+          # Get the value of the given key from internal hash
+          def [] key
+            hash[key]
+          end
+
+          ##
+          # Write new value with the key in internal hash
+          def []= key, value
+            hash[key] = value
+          end
+
+          ##
+          # Convert ErrorEvent object to gRPC struct
+          #
+          # @return [Devtools::Clouderrorreporting::V1beta1::ReportedErrorEvent]
+          #   gRPC struct that represent an ErrorEvent
+          def to_grpc
+            grpc_module =
+              Devtools::Clouderrorreporting::V1beta1::ReportedErrorEvent
+            grpc_module.decode_json hash.to_json
+          end
+        end
+
+        private_constant :ErrorEvent
       end
     end
   end

data/lib/google/cloud/error_reporting/rails.rb

@@ -13,6 +13,7 @@
 # limitations under the License.
 
 
+require "google/cloud/core/environment"
 require "google/cloud/error_reporting/v1beta1"
 require "google/cloud/credentials"
 
@@ -23,18 +24,18 @@ module Google
       # Railtie
       #
       # Google::Cloud::ErrorReporting::Railtie automatically add the
-      # Google::Cloud::ErrorReporting::Middleware to Rack in a Rails environment.
-      # It will automatically capture Exceptions from the Rails app and report
-      # them to Stackdriver Error Reporting.
+      # Google::Cloud::ErrorReporting::Middleware to Rack in a Rails
+      # environment. It will automatically capture Exceptions from the Rails app
+      # and report them to Stackdriver Error Reporting.
       #
       # The Middleware is only added when certain conditions are met. See
       # {Railtie.use_error_reporting?} for detail.
       #
       # When loaded, the Google::Cloud::ErrorReporting::Middleware will be
-      # inserted after ::ActionDispatch::DebugExceptions Middleware, which allows
-      # it to actually rescue all Exceptions and throw it back up. The middleware
-      # should also be initialized with correct gcp project_id, keyfile,
-      # service_name, and service_version if they are defined in
+      # inserted after ::ActionDispatch::DebugExceptions Middleware, which
+      # allows it to actually rescue all Exceptions and throw it back up. The
+      # middleware should also be initialized with correct gcp project_id,
+      # keyfile, service_name, and service_version if they are defined in
       # Rails environment files as follow:
       #   config.google_cloud.project_id = "my-gcp-project"
       #   config.google_cloud.keyfile = "/path/to/secret.json"
@@ -61,10 +62,11 @@ module Google
             service_name = er_config.service_name
             service_version = er_config.service_version
 
-            error_reporting =
-              Google::Cloud::ErrorReporting::V1beta1::ReportErrorsServiceApi.new channel: channel,
-                                                                                 app_name: service_name,
-                                                                                 app_version: service_version
+            error_reporting = V1beta1::ReportErrorsServiceClient.new(
+              channel: channel,
+              app_name: service_name,
+              app_version: service_version
+            )
 
             # In later versions of Rails, ActionDispatch::DebugExceptions is
             # responsible for catching exceptions. But it didn't exist until
@@ -77,7 +79,7 @@ module Google
               end
 
             app.middleware.insert_after rails_exception_middleware,
-                                        Google::Cloud::ErrorReporting::Middleware,
+                                        Middleware,
                                         project_id: project_id,
                                         error_reporting: error_reporting,
                                         service_name: service_name,
@@ -97,7 +99,7 @@ module Google
         def self.grpc_channel keyfile = nil
           require "grpc"
 
-          scopes = Google::Cloud::ErrorReporting::V1beta1::ReportErrorsServiceApi::ALL_SCOPES
+          scopes = V1beta1::ReportErrorsServiceClient::ALL_SCOPES
           credentials = if keyfile.nil?
                           Google::Cloud::Credentials.default(
                             scope: scopes)
@@ -111,7 +113,7 @@ module Google
 
           channel_cred = GRPC::Core::ChannelCredentials.new.compose \
             GRPC::Core::CallCredentials.new credentials.client.updater_proc
-          host = Google::Cloud::ErrorReporting::V1beta1::ReportErrorsServiceApi::SERVICE_ADDRESS
+          host = V1beta1::ReportErrorsServiceClient::SERVICE_ADDRESS
 
           GRPC::Core::Channel.new host, nil, channel_cred
         end
@@ -143,18 +145,13 @@ module Google
           keyfile = er_config.keyfile || gcp_config.keyfile
           begin
             grpc_channel keyfile
-          rescue Exception => e
+          rescue StandardError => e
             Rails.logger.warn "Google::Cloud::ErrorReporting is not " \
             "activated due to authorization error: #{e.message}"
             return false
           end
 
-          project_id = er_config.project_id ||
-                       gcp_config.project_id ||
-                       ENV["ERROR_REPORTING_PROJECT"] ||
-                       ENV["GOOGLE_CLOUD_PROJECT"] ||
-                       Google::Cloud::Core::Environment.project_id
-          if project_id.to_s.empty?
+          if project_id(config).to_s.empty?
             Rails.logger.warn "Google::Cloud::ErrorReporting is not " \
             "activated due to empty project_id"
             return false
@@ -166,6 +163,24 @@ module Google
             (gcp_config.key?(:use_error_reporting) &&
               gcp_config.use_error_reporting)
         end
+
+        ##
+        # Determine the GCP project_id from Rails configuration or environment
+        # variables. Default to Google::Cloud::Core::Environment.project_id
+        #
+        # @param [Rails::Railtie::Configuration] config The
+        #   Rails.application.config
+        #
+        # @return [String] GCP project_id
+        #
+        def self.project_id config
+          config.google_cloud.error_reporting.project_id ||
+            config.google_cloud.project_id ||
+            ENV["ERROR_REPORTING_PROJECT"] ||
+            ENV["GOOGLE_CLOUD_PROJECT"] ||
+            Google::Cloud::Core::Environment.project_id
+        end
+        private_class_method :project_id
       end
     end
   end

data/lib/google/cloud/error_reporting/v1beta1.rb

@@ -14,11 +14,6 @@
 # limitations under the License.
 
 
-require "google/cloud/error_reporting/v1beta1/error_group_service_api"
-require "google/cloud/error_reporting/v1beta1/error_stats_service_api"
-require "google/cloud/error_reporting/v1beta1/report_errors_service_api"
-# Require the protobufs so we can create objects before GRPC is loaded.
-require "google/devtools/clouderrorreporting/v1beta1/report_errors_service_pb"
-
-require "google/cloud/core/environment"
-require "google/cloud/error_reporting/middleware"
+require "google/cloud/error_reporting/v1beta1/error_group_service_client"
+require "google/cloud/error_reporting/v1beta1/error_stats_service_client"
+require "google/cloud/error_reporting/v1beta1/report_errors_service_client"

data/lib/google/cloud/error_reporting/v1beta1/doc/google/devtools/clouderrorreporting/v1beta1/common.rb

@@ -15,6 +15,34 @@
 module Google
   module Devtools
     module Clouderrorreporting
+      ##
+      # The `Google::Devtools::Clouderrorreporting::V1beta1` module provides the following types:
+      #
+      # Class | Description
+      # ----- | -----------
+      # {Google::Devtools::Clouderrorreporting::V1beta1::DeleteEventsRequest} | Deletes all events in the project.
+      # {Google::Devtools::Clouderrorreporting::V1beta1::DeleteEventsResponse} | Response message for deleting error events.
+      # {Google::Devtools::Clouderrorreporting::V1beta1::ErrorContext} | A description of the context in which an error occurred.
+      # {Google::Devtools::Clouderrorreporting::V1beta1::ErrorEvent} | An error event which is returned by the Error Reporting system.
+      # {Google::Devtools::Clouderrorreporting::V1beta1::ErrorGroup} | Description of a group of similar error events.
+      # {Google::Devtools::Clouderrorreporting::V1beta1::ErrorGroupOrder} | A sorting order of error groups.
+      # {Google::Devtools::Clouderrorreporting::V1beta1::ErrorGroupStats} | Data extracted for a specific group based on certain filter criteria.
+      # {Google::Devtools::Clouderrorreporting::V1beta1::HttpRequestContext} | HTTP request data that is related to a reported error.
+      # {Google::Devtools::Clouderrorreporting::V1beta1::ListEventsRequest} | Specifies a set of error events to return.
+      # {Google::Devtools::Clouderrorreporting::V1beta1::ListEventsResponse} | Contains a set of requested error events.
+      # {Google::Devtools::Clouderrorreporting::V1beta1::ListGroupStatsRequest} | Specifies a set of {Google::Devtools::Clouderrorreporting::V1beta1::ErrorGroupStats} to return.
+      # {Google::Devtools::Clouderrorreporting::V1beta1::ListGroupStatsResponse} | Contains a set of requested error group stats.
+      # {Google::Devtools::Clouderrorreporting::V1beta1::QueryTimeRange} | Requests might be rejected or the resulting timed count durations might be adjusted for lower durations.
+      # {Google::Devtools::Clouderrorreporting::V1beta1::ReportedErrorEvent} | An error event which is reported to the Error Reporting system.
+      # {Google::Devtools::Clouderrorreporting::V1beta1::ReportErrorEventRequest} | A request for reporting an individual error event.
+      # {Google::Devtools::Clouderrorreporting::V1beta1::ReportErrorEventResponse} | Response for reporting an individual error event.
+      # {Google::Devtools::Clouderrorreporting::V1beta1::ServiceContext} | Describes a running service that sends errors.
+      # {Google::Devtools::Clouderrorreporting::V1beta1::ServiceContextFilter} | Specifies criteria for filtering a subset of service contexts.
+      # {Google::Devtools::Clouderrorreporting::V1beta1::SourceLocation} | Indicates a location in the source code of the service for which errors are reported.
+      # {Google::Devtools::Clouderrorreporting::V1beta1::TimedCount} | The number of errors in a given time period.
+      # {Google::Devtools::Clouderrorreporting::V1beta1::TimedCountAlignment} | Specifies how the time periods of error group counts are aligned.
+      # {Google::Devtools::Clouderrorreporting::V1beta1::TrackingIssue} | Information related to tracking the progress on resolving the error.
+      #
       module V1beta1
         # Description of a group of similar error events.
         # @!attribute [rw] name
@@ -69,6 +97,13 @@ module Google
         #   @return [String]
         #     Represents the source code version that the developer provided,
         #     which could represent a version label or a Git SHA-1 hash, for example.
+        # @!attribute [rw] resource_type
+        #   @return [String]
+        #     Type of the MonitoredResource. List of possible values:
+        #     https://cloud.google.com/monitoring/api/resources
+        #
+        #     Value is set automatically for incoming errors and must not be set when
+        #     reporting errors.
         class ServiceContext; end
 
         # A description of the context in which an error occurred.
@@ -147,4 +182,4 @@ module Google
       end
     end
   end
-end
+end

data/lib/google/cloud/error_reporting/v1beta1/doc/google/devtools/clouderrorreporting/v1beta1/error_stats_service.rb

@@ -35,7 +35,9 @@ module Google
         #     Data for all service contexts is returned if this field is not specified.
         # @!attribute [rw] time_range
         #   @return [Google::Devtools::Clouderrorreporting::V1beta1::QueryTimeRange]
-        #     [Required] List data for the given time range.
+        #     [Optional] List data for the given time range.
+        #     If not set a default time range is used. The field time_range_begin
+        #     in the response will specify the beginning of this time range.
         #     Only <code>ErrorGroupStats</code> with a non-zero count in the given time
         #     range are returned, unless the request contains an explicit group_id list.
         #     If a group_id list is given, also <code>ErrorGroupStats</code> with zero
@@ -76,6 +78,12 @@ module Google
         #     If non-empty, more results are available.
         #     Pass this token, along with the same query parameters as the first
         #     request, to view the next page of results.
+        # @!attribute [rw] time_range_begin
+        #   @return [Google::Protobuf::Timestamp]
+        #     The timestamp specifies the start time to which the request was restricted.
+        #     The start time is set based on the requested time range. It may be adjusted
+        #     to a later time if a project has exceeded the storage quota and older data
+        #     has been deleted.
         class ListGroupStatsResponse; end
 
         # Data extracted for a specific group based on certain filter criteria,
@@ -156,7 +164,8 @@ module Google
         #   @return [String]
         #     [Required] The resource name of the Google Cloud Platform project. Written
         #     as +projects/+ plus the
-        #     {Google Cloud Platform project ID}[https://support.google.com/cloud/answer/6158840].
+        #     {Google Cloud Platform project
+        #     ID}[https://support.google.com/cloud/answer/6158840].
         #     Example: +projects/my-project-123+.
         # @!attribute [rw] group_id
         #   @return [String]
@@ -169,6 +178,8 @@ module Google
         # @!attribute [rw] time_range
         #   @return [Google::Devtools::Clouderrorreporting::V1beta1::QueryTimeRange]
         #     [Optional] List only data for the given time range.
+        #     If not set a default time range is used. The field time_range_begin
+        #     in the response will specify the beginning of this time range.
         # @!attribute [rw] page_size
         #   @return [Integer]
         #     [Optional] The maximum number of results to return per response.
@@ -186,6 +197,9 @@ module Google
         #     If non-empty, more results are available.
         #     Pass this token, along with the same query parameters as the first
         #     request, to view the next page of results.
+        # @!attribute [rw] time_range_begin
+        #   @return [Google::Protobuf::Timestamp]
+        #     The timestamp specifies the start time to which the request was restricted.
         class ListEventsResponse; end
 
         # Requests might be rejected or the resulting timed count durations might be
@@ -233,6 +247,10 @@ module Google
         #   @return [String]
         #     [Optional] The exact value to match against
         #     {+ServiceContext.version+}[https://cloud.google.com/error-reporting/reference/rest/v1beta1/ServiceContext#FIELDS.version].
+        # @!attribute [rw] resource_type
+        #   @return [String]
+        #     [Optional] The exact value to match against
+        #     {+ServiceContext.resource_type+}[https://cloud.google.com/error-reporting/reference/rest/v1beta1/ServiceContext#FIELDS.resource_type].
         class ServiceContextFilter; end
 
         # Deletes all events in the project.
@@ -240,7 +258,8 @@ module Google
         #   @return [String]
         #     [Required] The resource name of the Google Cloud Platform project. Written
         #     as +projects/+ plus the
-        #     {Google Cloud Platform project ID}[https://support.google.com/cloud/answer/6158840].
+        #     {Google Cloud Platform project
+        #     ID}[https://support.google.com/cloud/answer/6158840].
         #     Example: +projects/my-project-123+.
         class DeleteEventsRequest; end
 
@@ -290,4 +309,4 @@ module Google
       end
     end
   end
-end
+end

data/lib/google/cloud/error_reporting/v1beta1/doc/google/devtools/clouderrorreporting/v1beta1/report_errors_service.rb

@@ -54,4 +54,4 @@ module Google
       end
     end
   end
-end
+end

data/lib/google/cloud/error_reporting/v1beta1/doc/google/protobuf/duration.rb

@@ -68,4 +68,4 @@ module Google
     #     to +999,999,999 inclusive.
     class Duration; end
   end
-end
+end

data/lib/google/cloud/error_reporting/v1beta1/doc/google/protobuf/timestamp.rb

@@ -80,4 +80,4 @@ module Google
     #     inclusive.
     class Timestamp; end
   end
-end
+end

data/lib/google/cloud/error_reporting/v1beta1/{error_group_service_api.rb → error_group_service_client.rb}

@@ -36,7 +36,7 @@ module Google
         #
         # @!attribute [r] error_group_service_stub
         #   @return [Google::Devtools::Clouderrorreporting::V1beta1::ErrorGroupService::Stub]
-        class ErrorGroupServiceApi
+        class ErrorGroupServiceClient
           attr_reader :error_group_service_stub
 
           # The default address of the service.
@@ -121,6 +121,7 @@ module Google
             require "google/gax/grpc"
             require "google/devtools/clouderrorreporting/v1beta1/error_group_service_services_pb"
 
+
             google_api_client = "#{app_name}/#{app_version} " \
               "#{CODE_GEN_NAME_VERSION} gax/#{Google::Gax::VERSION} " \
               "ruby/#{RUBY_VERSION}".freeze
@@ -177,13 +178,13 @@ module Google
           # @return [Google::Devtools::Clouderrorreporting::V1beta1::ErrorGroup]
           # @raise [Google::Gax::GaxError] if the RPC is aborted.
           # @example
-          #   require "google/cloud/error_reporting/v1beta1/error_group_service_api"
+          #   require "google/cloud/error_reporting/v1beta1/error_group_service_client"
           #
-          #   ErrorGroupServiceApi = Google::Cloud::ErrorReporting::V1beta1::ErrorGroupServiceApi
+          #   ErrorGroupServiceClient = Google::Cloud::ErrorReporting::V1beta1::ErrorGroupServiceClient
           #
-          #   error_group_service_api = ErrorGroupServiceApi.new
-          #   formatted_group_name = ErrorGroupServiceApi.group_path("[PROJECT]", "[GROUP]")
-          #   response = error_group_service_api.get_group(formatted_group_name)
+          #   error_group_service_client = ErrorGroupServiceClient.new
+          #   formatted_group_name = ErrorGroupServiceClient.group_path("[PROJECT]", "[GROUP]")
+          #   response = error_group_service_client.get_group(formatted_group_name)
 
           def get_group \
               group_name,
@@ -205,14 +206,14 @@ module Google
           # @return [Google::Devtools::Clouderrorreporting::V1beta1::ErrorGroup]
           # @raise [Google::Gax::GaxError] if the RPC is aborted.
           # @example
-          #   require "google/cloud/error_reporting/v1beta1/error_group_service_api"
+          #   require "google/cloud/error_reporting/v1beta1/error_group_service_client"
           #
           #   ErrorGroup = Google::Devtools::Clouderrorreporting::V1beta1::ErrorGroup
-          #   ErrorGroupServiceApi = Google::Cloud::ErrorReporting::V1beta1::ErrorGroupServiceApi
+          #   ErrorGroupServiceClient = Google::Cloud::ErrorReporting::V1beta1::ErrorGroupServiceClient
           #
-          #   error_group_service_api = ErrorGroupServiceApi.new
+          #   error_group_service_client = ErrorGroupServiceClient.new
           #   group = ErrorGroup.new
-          #   response = error_group_service_api.update_group(group)
+          #   response = error_group_service_client.update_group(group)
 
           def update_group \
               group,

data/lib/google/cloud/error_reporting/v1beta1/{error_stats_service_api.rb → error_stats_service_client.rb}

@@ -37,7 +37,7 @@ module Google
         #
         # @!attribute [r] error_stats_service_stub
         #   @return [Google::Devtools::Clouderrorreporting::V1beta1::ErrorStatsService::Stub]
-        class ErrorStatsServiceApi
+        class ErrorStatsServiceClient
           attr_reader :error_stats_service_stub
 
           # The default address of the service.
@@ -126,6 +126,7 @@ module Google
             require "google/gax/grpc"
             require "google/devtools/clouderrorreporting/v1beta1/error_stats_service_services_pb"
 
+
             google_api_client = "#{app_name}/#{app_version} " \
               "#{CODE_GEN_NAME_VERSION} gax/#{Google::Gax::VERSION} " \
               "ruby/#{RUBY_VERSION}".freeze
@@ -186,7 +187,9 @@ module Google
           #   context that matches the filter.
           #   Data for all service contexts is returned if this field is not specified.
           # @param time_range [Google::Devtools::Clouderrorreporting::V1beta1::QueryTimeRange]
-          #   [Required] List data for the given time range.
+          #   [Optional] List data for the given time range.
+          #   If not set a default time range is used. The field time_range_begin
+          #   in the response will specify the beginning of this time range.
           #   Only <code>ErrorGroupStats</code> with a non-zero count in the given time
           #   range are returned, unless the request contains an explicit group_id list.
           #   If a group_id list is given, also <code>ErrorGroupStats</code> with zero
@@ -219,22 +222,22 @@ module Google
           #   object.
           # @raise [Google::Gax::GaxError] if the RPC is aborted.
           # @example
-          #   require "google/cloud/error_reporting/v1beta1/error_stats_service_api"
+          #   require "google/cloud/error_reporting/v1beta1/error_stats_service_client"
           #
-          #   ErrorStatsServiceApi = Google::Cloud::ErrorReporting::V1beta1::ErrorStatsServiceApi
+          #   ErrorStatsServiceClient = Google::Cloud::ErrorReporting::V1beta1::ErrorStatsServiceClient
           #   QueryTimeRange = Google::Devtools::Clouderrorreporting::V1beta1::QueryTimeRange
           #
-          #   error_stats_service_api = ErrorStatsServiceApi.new
-          #   formatted_project_name = ErrorStatsServiceApi.project_path("[PROJECT]")
+          #   error_stats_service_client = ErrorStatsServiceClient.new
+          #   formatted_project_name = ErrorStatsServiceClient.project_path("[PROJECT]")
           #   time_range = QueryTimeRange.new
           #
           #   # Iterate over all results.
-          #   error_stats_service_api.list_group_stats(formatted_project_name, time_range).each do |element|
+          #   error_stats_service_client.list_group_stats(formatted_project_name, time_range).each do |element|
           #     # Process element.
           #   end
           #
           #   # Or iterate over results one page at a time.
-          #   error_stats_service_api.list_group_stats(formatted_project_name, time_range).each_page do |page|
+          #   error_stats_service_client.list_group_stats(formatted_project_name, time_range).each_page do |page|
           #     # Process each page at a time.
           #     page.each do |element|
           #       # Process element.
@@ -271,7 +274,8 @@ module Google
           # @param project_name [String]
           #   [Required] The resource name of the Google Cloud Platform project. Written
           #   as +projects/+ plus the
-          #   {Google Cloud Platform project ID}[https://support.google.com/cloud/answer/6158840].
+          #   {Google Cloud Platform project
+          #   ID}[https://support.google.com/cloud/answer/6158840].
           #   Example: +projects/my-project-123+.
           # @param group_id [String]
           #   [Required] The group for which events shall be returned.
@@ -281,6 +285,8 @@ module Google
           #   Data for all service contexts is returned if this field is not specified.
           # @param time_range [Google::Devtools::Clouderrorreporting::V1beta1::QueryTimeRange]
           #   [Optional] List only data for the given time range.
+          #   If not set a default time range is used. The field time_range_begin
+          #   in the response will specify the beginning of this time range.
           # @param page_size [Integer]
           #   The maximum number of resources contained in the underlying API
           #   response. If page streaming is performed per-resource, this
@@ -297,21 +303,21 @@ module Google
           #   object.
           # @raise [Google::Gax::GaxError] if the RPC is aborted.
           # @example
-          #   require "google/cloud/error_reporting/v1beta1/error_stats_service_api"
+          #   require "google/cloud/error_reporting/v1beta1/error_stats_service_client"
           #
-          #   ErrorStatsServiceApi = Google::Cloud::ErrorReporting::V1beta1::ErrorStatsServiceApi
+          #   ErrorStatsServiceClient = Google::Cloud::ErrorReporting::V1beta1::ErrorStatsServiceClient
           #
-          #   error_stats_service_api = ErrorStatsServiceApi.new
-          #   formatted_project_name = ErrorStatsServiceApi.project_path("[PROJECT]")
+          #   error_stats_service_client = ErrorStatsServiceClient.new
+          #   formatted_project_name = ErrorStatsServiceClient.project_path("[PROJECT]")
           #   group_id = ''
           #
           #   # Iterate over all results.
-          #   error_stats_service_api.list_events(formatted_project_name, group_id).each do |element|
+          #   error_stats_service_client.list_events(formatted_project_name, group_id).each do |element|
           #     # Process element.
           #   end
           #
           #   # Or iterate over results one page at a time.
-          #   error_stats_service_api.list_events(formatted_project_name, group_id).each_page do |page|
+          #   error_stats_service_client.list_events(formatted_project_name, group_id).each_page do |page|
           #     # Process each page at a time.
           #     page.each do |element|
           #       # Process element.
@@ -340,7 +346,8 @@ module Google
           # @param project_name [String]
           #   [Required] The resource name of the Google Cloud Platform project. Written
           #   as +projects/+ plus the
-          #   {Google Cloud Platform project ID}[https://support.google.com/cloud/answer/6158840].
+          #   {Google Cloud Platform project
+          #   ID}[https://support.google.com/cloud/answer/6158840].
           #   Example: +projects/my-project-123+.
           # @param options [Google::Gax::CallOptions]
           #   Overrides the default settings for this call, e.g, timeout,
@@ -348,13 +355,13 @@ module Google
           # @return [Google::Devtools::Clouderrorreporting::V1beta1::DeleteEventsResponse]
           # @raise [Google::Gax::GaxError] if the RPC is aborted.
           # @example
-          #   require "google/cloud/error_reporting/v1beta1/error_stats_service_api"
+          #   require "google/cloud/error_reporting/v1beta1/error_stats_service_client"
           #
-          #   ErrorStatsServiceApi = Google::Cloud::ErrorReporting::V1beta1::ErrorStatsServiceApi
+          #   ErrorStatsServiceClient = Google::Cloud::ErrorReporting::V1beta1::ErrorStatsServiceClient
           #
-          #   error_stats_service_api = ErrorStatsServiceApi.new
-          #   formatted_project_name = ErrorStatsServiceApi.project_path("[PROJECT]")
-          #   response = error_stats_service_api.delete_events(formatted_project_name)
+          #   error_stats_service_client = ErrorStatsServiceClient.new
+          #   formatted_project_name = ErrorStatsServiceClient.project_path("[PROJECT]")
+          #   response = error_stats_service_client.delete_events(formatted_project_name)
 
           def delete_events \
               project_name,

data/lib/google/cloud/error_reporting/v1beta1/{report_errors_service_api.rb → report_errors_service_client.rb}

@@ -36,7 +36,7 @@ module Google
         #
         # @!attribute [r] report_errors_service_stub
         #   @return [Google::Devtools::Clouderrorreporting::V1beta1::ReportErrorsService::Stub]
-        class ReportErrorsServiceApi
+        class ReportErrorsServiceClient
           attr_reader :report_errors_service_stub
 
           # The default address of the service.
@@ -112,6 +112,7 @@ module Google
             require "google/gax/grpc"
             require "google/devtools/clouderrorreporting/v1beta1/report_errors_service_services_pb"
 
+
             google_api_client = "#{app_name}/#{app_version} " \
               "#{CODE_GEN_NAME_VERSION} gax/#{Google::Gax::VERSION} " \
               "ruby/#{RUBY_VERSION}".freeze
@@ -169,15 +170,15 @@ module Google
           # @return [Google::Devtools::Clouderrorreporting::V1beta1::ReportErrorEventResponse]
           # @raise [Google::Gax::GaxError] if the RPC is aborted.
           # @example
-          #   require "google/cloud/error_reporting/v1beta1/report_errors_service_api"
+          #   require "google/cloud/error_reporting/v1beta1/report_errors_service_client"
           #
-          #   ReportErrorsServiceApi = Google::Cloud::ErrorReporting::V1beta1::ReportErrorsServiceApi
+          #   ReportErrorsServiceClient = Google::Cloud::ErrorReporting::V1beta1::ReportErrorsServiceClient
           #   ReportedErrorEvent = Google::Devtools::Clouderrorreporting::V1beta1::ReportedErrorEvent
           #
-          #   report_errors_service_api = ReportErrorsServiceApi.new
-          #   formatted_project_name = ReportErrorsServiceApi.project_path("[PROJECT]")
+          #   report_errors_service_client = ReportErrorsServiceClient.new
+          #   formatted_project_name = ReportErrorsServiceClient.project_path("[PROJECT]")
           #   event = ReportedErrorEvent.new
-          #   response = report_errors_service_api.report_error_event(formatted_project_name, event)
+          #   response = report_errors_service_client.report_error_event(formatted_project_name, event)
 
           def report_error_event \
               project_name,

data/lib/google/devtools/clouderrorreporting/v1beta1/common_pb.rb

@@ -4,6 +4,7 @@
 require 'google/protobuf'
 
 require 'google/api/annotations_pb'
+require 'google/api/monitored_resource_pb'
 require 'google/protobuf/timestamp_pb'
 Google::Protobuf::DescriptorPool.generated_pool.build do
   add_message "google.devtools.clouderrorreporting.v1beta1.ErrorGroup" do
@@ -23,6 +24,7 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
   add_message "google.devtools.clouderrorreporting.v1beta1.ServiceContext" do
     optional :service, :string, 2
     optional :version, :string, 3
+    optional :resource_type, :string, 4
   end
   add_message "google.devtools.clouderrorreporting.v1beta1.ErrorContext" do
     optional :http_request, :message, 1, "google.devtools.clouderrorreporting.v1beta1.HttpRequestContext"

data/lib/google/devtools/clouderrorreporting/v1beta1/error_stats_service_pb.rb

@@ -23,6 +23,7 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
   add_message "google.devtools.clouderrorreporting.v1beta1.ListGroupStatsResponse" do
     repeated :error_group_stats, :message, 1, "google.devtools.clouderrorreporting.v1beta1.ErrorGroupStats"
     optional :next_page_token, :string, 2
+    optional :time_range_begin, :message, 4, "google.protobuf.Timestamp"
   end
   add_message "google.devtools.clouderrorreporting.v1beta1.ErrorGroupStats" do
     optional :group, :message, 1, "google.devtools.clouderrorreporting.v1beta1.ErrorGroup"
@@ -51,6 +52,7 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
   add_message "google.devtools.clouderrorreporting.v1beta1.ListEventsResponse" do
     repeated :error_events, :message, 1, "google.devtools.clouderrorreporting.v1beta1.ErrorEvent"
     optional :next_page_token, :string, 2
+    optional :time_range_begin, :message, 4, "google.protobuf.Timestamp"
   end
   add_message "google.devtools.clouderrorreporting.v1beta1.QueryTimeRange" do
     optional :period, :enum, 1, "google.devtools.clouderrorreporting.v1beta1.QueryTimeRange.Period"
@@ -66,6 +68,7 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
   add_message "google.devtools.clouderrorreporting.v1beta1.ServiceContextFilter" do
     optional :service, :string, 2
     optional :version, :string, 3
+    optional :resource_type, :string, 4
   end
   add_message "google.devtools.clouderrorreporting.v1beta1.DeleteEventsRequest" do
     optional :project_name, :string, 1

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: google-cloud-error_reporting
 version: !ruby/object:Gem::Version
-  version: 0.21.2
+  version: 0.22.0
 platform: ruby
 authors:
 - Google Inc
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2016-11-03 00:00:00.000000000 Z
+date: 2017-01-27 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: google-cloud-core
@@ -136,6 +136,20 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '5.2'
+- !ruby/object:Gem::Dependency
+  name: rubocop
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "<="
+      - !ruby/object:Gem::Version
+        version: 0.35.1
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "<="
+      - !ruby/object:Gem::Version
+        version: 0.35.1
 - !ruby/object:Gem::Dependency
   name: actionpack
   requirement: !ruby/object:Gem::Requirement
@@ -154,16 +168,16 @@ dependencies:
   name: railties
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '3.2'
+        version: '4.0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '3.2'
+        version: '4.0'
 - !ruby/object:Gem::Dependency
   name: rack
   requirement: !ruby/object:Gem::Requirement
@@ -178,7 +192,8 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0.1'
-description: a grpc-based api
+description: google-cloud-error_reporting is the official library for Stackdriver
+  Error Reporting.
 email:
 - googleapis-packages@google.com
 executables: []
@@ -188,6 +203,7 @@ files:
 - ".yardopts"
 - LICENSE
 - README.md
+- lib/google-cloud-error_reporting.rb
 - lib/google/cloud/error_reporting/middleware.rb
 - lib/google/cloud/error_reporting/rails.rb
 - lib/google/cloud/error_reporting/v1beta1.rb
@@ -196,11 +212,11 @@ files:
 - lib/google/cloud/error_reporting/v1beta1/doc/google/devtools/clouderrorreporting/v1beta1/report_errors_service.rb
 - lib/google/cloud/error_reporting/v1beta1/doc/google/protobuf/duration.rb
 - lib/google/cloud/error_reporting/v1beta1/doc/google/protobuf/timestamp.rb
-- lib/google/cloud/error_reporting/v1beta1/error_group_service_api.rb
+- lib/google/cloud/error_reporting/v1beta1/error_group_service_client.rb
 - lib/google/cloud/error_reporting/v1beta1/error_group_service_client_config.json
-- lib/google/cloud/error_reporting/v1beta1/error_stats_service_api.rb
+- lib/google/cloud/error_reporting/v1beta1/error_stats_service_client.rb
 - lib/google/cloud/error_reporting/v1beta1/error_stats_service_client_config.json
-- lib/google/cloud/error_reporting/v1beta1/report_errors_service_api.rb
+- lib/google/cloud/error_reporting/v1beta1/report_errors_service_client.rb
 - lib/google/cloud/error_reporting/v1beta1/report_errors_service_client_config.json
 - lib/google/devtools/clouderrorreporting/v1beta1/common_pb.rb
 - lib/google/devtools/clouderrorreporting/v1beta1/error_group_service_pb.rb
@@ -229,8 +245,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements: []
 rubyforge_project: 
-rubygems_version: 2.5.1
+rubygems_version: 2.6.10
 signing_key: 
 specification_version: 4
-summary: Google client library for the Stackdriver Clouderrorreporting service
+summary: API Client library for Stackdriver Error Reporting
 test_files: []