google-cloud-trace 0.33.2 → 0.33.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: bbe89b5a4aa636dcf475f45b2b41df253c2d1427d481db8ab2cfda9643a12fee
-  data.tar.gz: 292766346502eb6508d029dd5e495439cc470ee01b472e4262a81a4dd6a39254
+  metadata.gz: 4abf38adb01ec9b9997a1d6a0f6e9d3918147157e8e35f178edad7f75c1ea831
+  data.tar.gz: ac52a148244c3ff89da4915d84865df83872b9f0880e4928503669339f4a9a3b
 SHA512:
-  metadata.gz: 6d355e9fe1200109bdc9713956fb23b819ecf593a2f539bd431feaea61c588eaeb61296a6571bef78b4f1f7e7ec741047d277f57a0dd308cf0c0406331f46311
-  data.tar.gz: 91568ca426efe1becad8debc38ffce4f7ef0f6f94d27dbbf104daefc72f5df6797b48f8246c91b4225662261283df586fb76443b4d4921f69a7c66b3a40f7aad
+  metadata.gz: e7b1342855a44dd3282c2e6614d0188759cafa2bcfbe8b16a1a3333b8ca336d077111755f6b8b9af4766f5221cb131fb9f6e583a0f4552b3c76e56bd6ddbf13e
+  data.tar.gz: 79a50a191e5a7e9c21fa850ab538374bdca1e6acf444f5fdaea48410b92449b104820b945ec0f9692e746877c91431b35bc573a29ab1fe030463a729e28583f6

data/.yardopts

@@ -3,7 +3,16 @@
 --exclude _pb\.rb$
 --markup markdown
 --markup-provider redcarpet
+--main OVERVIEW.md
 
 ./lib/**/*.rb
 -
-README.md
+OVERVIEW.md
+AUTHENTICATION.md
+INSTRUMENTATION.md
+LOGGING.md
+CONTRIBUTING.md
+TROUBLESHOOTING.md
+CHANGELOG.md
+CODE_OF_CONDUCT.md
+LICENSE

data/README.md

@@ -8,8 +8,8 @@ Stackdriver Trace automatically analyzes all of your application's traces to
 generate in-depth latency reports to surface performance degradations, and can
 capture traces from all of your VMs, containers, or Google App Engine projects.
 
-- [google-cloud-trace API documentation](http://googlecloudplatform.github.io/google-cloud-ruby/#/docs/google-cloud-trace/latest)
-- [google-cloud-trace instrumentation documentation](https://googlecloudplatform.github.io/google-cloud-ruby/#/docs/google-cloud-trace/guides/instrumentation)
+- [google-cloud-trace API documentation](http://googlecloudplatform.github.io/google-cloud-ruby/docs/google-cloud-trace/latest)
+- [google-cloud-trace instrumentation documentation](https://googlecloudplatform.github.io/google-cloud-ruby/docs/google-cloud-trace/latest/file.INSTRUMENTATION)
 - [google-cloud-trace on RubyGems](https://rubygems.org/gems/google-cloud-trace)
 - [Stackdriver Trace documentation](https://cloud.google.com/trace/docs/)
 
@@ -94,7 +94,7 @@ end
 ### Configuring the library
 
 You can customize the behavior of the Stackdriver Trace library for Ruby. See
-the [configuration guide](../stackdriver/configuration.md) for a list of
+the [configuration guide](../stackdriver/CONFIGURATION.md) for a list of
 possible configuration options.
 
 ## Running on Google Cloud Platform
@@ -181,11 +181,11 @@ end
 
 This library also supports the other authentication methods provided by the
 `google-cloud-ruby` suite. Instructions and configuration options are covered
-in the [Authentication Guide](https://googlecloudplatform.github.io/google-cloud-ruby/#/docs/google-cloud-trace/guides/authentication).
+in the [Authentication Guide](https://googlecloudplatform.github.io/google-cloud-ruby/docs/google-cloud-trace/latest/file.AUTHENTICATION).
 
 ## Enabling Logging
 
-To enable logging for this library, set the logger for the underlying [gRPC](https://github.com/grpc/grpc/tree/master/src/ruby) library. The logger that you set may be a Ruby stdlib [`Logger`](https://ruby-doc.org/stdlib-2.5.0/libdoc/logger/rdoc/Logger.html) as shown below, or a [`Google::Cloud::Logging::Logger`](https://googlecloudplatform.github.io/google-cloud-ruby/#/docs/google-cloud-logging/latest/google/cloud/logging/logger) that will write logs to [Stackdriver Logging](https://cloud.google.com/logging/). See [grpc/logconfig.rb](https://github.com/grpc/grpc/blob/master/src/ruby/lib/grpc/logconfig.rb) and the gRPC [spec_helper.rb](https://github.com/grpc/grpc/blob/master/src/ruby/spec/spec_helper.rb) for additional information.
+To enable logging for this library, set the logger for the underlying [gRPC](https://github.com/grpc/grpc/tree/master/src/ruby) library. The logger that you set may be a Ruby stdlib [`Logger`](https://ruby-doc.org/stdlib-2.5.0/libdoc/logger/rdoc/Logger.html) as shown below, or a [`Google::Cloud::Logging::Logger`](https://googlecloudplatform.github.io/google-cloud-ruby/docs/google-cloud-logging/latest/Google/Cloud/Logging/Logger) that will write logs to [Stackdriver Logging](https://cloud.google.com/logging/). See [grpc/logconfig.rb](https://github.com/grpc/grpc/blob/master/src/ruby/lib/grpc/logconfig.rb) and the gRPC [spec_helper.rb](https://github.com/grpc/grpc/blob/master/src/ruby/spec/spec_helper.rb) for additional information.
 
 Configuring a Ruby stdlib logger:
 
@@ -210,9 +210,9 @@ end
 This library is supported on Ruby 2.3+.
 
 Google provides official support for Ruby versions that are actively supported
-by Ruby Core—that is, Ruby versions that are either in normal maintenance or
-in security maintenance, and not end of life. Currently, this means Ruby 2.3
-and later. Older versions of Ruby _may_ still work, but are unsupported and not
+by Ruby Core—that is, Ruby versions that are either in normal maintenance or in
+security maintenance, and not end of life. Currently, this means Ruby 2.3 and
+later. Older versions of Ruby _may_ still work, but are unsupported and not
 recommended. See https://www.ruby-lang.org/en/downloads/branches/ for details
 about the Ruby support schedule.
 
@@ -227,23 +227,24 @@ change at any time and the public API should not be considered stable.
 
 Contributions to this library are always welcome and highly encouraged.
 
-See the
-[Contributing Guide](https://googlecloudplatform.github.io/google-cloud-ruby/#/docs/guides/contributing)
+See the [Contributing
+Guide](https://googlecloudplatform.github.io/google-cloud-ruby/docs/google-cloud-trace/latest/file.CONTRIBUTING)
 for more information on how to get started.
 
 Please note that this project is released with a Contributor Code of Conduct. By
-participating in this project you agree to abide by its terms. See
-[Code of Conduct](../CODE_OF_CONDUCT.md) for more information.
+participating in this project you agree to abide by its terms. See [Code of
+Conduct](https://googlecloudplatform.github.io/google-cloud-ruby/docs/google-cloud-trace/latest/file.CODE_OF_CONDUCT)
+for more information.
 
 ## License
 
 This library is licensed under Apache 2.0. Full license text is available in
- [LICENSE](LICENSE).
+[LICENSE](https://googlecloudplatform.github.io/google-cloud-ruby/docs/google-cloud-trace/latest/file.LICENSE).
 
 ## Support
 
-Please
-[report bugs at the project on Github](https://github.com/GoogleCloudPlatform/google-cloud-ruby/issues).
-Don't hesitate to
-[ask questions](http://stackoverflow.com/questions/tagged/google-cloud-platform+ruby)
+Please [report bugs at the project on
+Github](https://github.com/GoogleCloudPlatform/google-cloud-ruby/issues). Don't
+hesitate to [ask
+questions](http://stackoverflow.com/questions/tagged/google-cloud-platform+ruby)
 about the client or APIs on [StackOverflow](http://stackoverflow.com).

data/lib/google-cloud-trace.rb

@@ -12,6 +12,7 @@
 # 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
 # Google::Cloud.trace and Google::Cloud#trace methods can be available, but the
@@ -29,8 +30,8 @@ module Google
     # Creates a new object for connecting to the Stackdriver Trace service.
     # Each call creates a new connection.
     #
-    # For more information on connecting to Google Cloud see the [Authentication
-    # Guide](https://googlecloudplatform.github.io/google-cloud-ruby/#/docs/guides/authentication).
+    # For more information on connecting to Google Cloud see the
+    # {file:AUTHENTICATION.md Authentication Guide}.
     #
     # @param [String, Array<String>] scope The OAuth 2.0 scopes controlling the
     #   set of resources and operations that the connection can access. See
@@ -66,8 +67,8 @@ module Google
     # Creates a new object for connecting to the Stackdriver Trace service.
     # Each call creates a new connection.
     #
-    # For more information on connecting to Google Cloud see the [Authentication
-    # Guide](https://googlecloudplatform.github.io/google-cloud-ruby/#/docs/guides/authentication).
+    # For more information on connecting to Google Cloud see the
+    # {file:AUTHENTICATION.md Authentication Guide}.
     #
     # @param [String] project_id Project identifier for the Stackdriver Trace
     #   service you are connecting to. If not present, the default project for

data/lib/google/cloud/trace.rb

@@ -34,194 +34,13 @@ require "stackdriver/core"
 module Google
   module Cloud
     ##
-    # # Trace
+    # # Stackdriver Trace
     #
     # The Stackdriver Trace service collects and stores latency data from your
     # application and displays it in the Google Cloud Platform Console, giving
     # you detailed near-real-time insight into application performance.
     #
-    # The Stackdriver Trace Ruby library, `google-cloud-trace`, provides:
-    #
-    # *   Easy-to-use trace instrumentation that collects and collates latency
-    #     data for your Ruby application. If you just want latency trace data
-    #     for your application to appear on the Google Cloud Platform Console,
-    #     see the section on [instrumenting your app](#instrumenting-your-app).
-    # *   An idiomatic Ruby API for querying, analyzing, and manipulating trace
-    #     data in your Ruby application. For an introduction to the Trace API,
-    #     see the section on the [Trace API](#stackdriver-trace-api).
-    #
-    # ## Instrumenting Your App
-    #
-    # This library integrates with Rack-based web frameworks such as Ruby On
-    # Rails to provide latency trace reports for your application.
-    # Specifcally, it:
-    #
-    # *   Provides a Rack middleware that automatically reports latency traces
-    #     for http requests handled by your application, and measures the
-    #     latency of each request as a whole.
-    # *   Integrates with `ActiveSupport::Notifications` to add important
-    #     latency-affecting events such as ActiveRecord queries to the trace.
-    # *   Provides a simple API for your application code to define and
-    #     measure latency-affecting processes specific to your application.
-    #
-    # When this library is installed and configured in your running
-    # application, you can view your application's latency traces in real time
-    # by opening the Google Cloud Console in your web browser and navigating
-    # to the "Trace" section. It also integrates with Google App Engine
-    # Flexible and Google Container Engine to provide additional information
-    # for applications hosted in those environments.
-    #
-    # Note that not all requests will have traces. By default, the library will
-    # sample about one trace every ten seconds per Ruby process, to prevent
-    # heavily used applications from reporting too much data. It will also
-    # omit certain requests used by Google App Engine for health checking. See
-    # {Google::Cloud::Trace::TimeSampler} for more details.
-    #
-    # ### Using instrumentation with Ruby on Rails
-    #
-    # To install application instrumentation in your Ruby on Rails app, add
-    # this gem, `google-cloud-trace`, to your Gemfile and update your bundle.
-    # Then add the following line to your `config/application.rb` file:
-    #
-    # ```ruby
-    # require "google/cloud/trace/rails"
-    # ```
-    #
-    # This will install a Railtie that automatically integrates with the
-    # Rails framework, installing the middleware and the ActiveSupport
-    # integration for you. Your application traces, including basic request
-    # tracing, ActiveRecord query measurements, and view render measurements,
-    # should then start appearing in the Cloud Console.
-    #
-    # See the {Google::Cloud::Trace::Railtie} class for more information,
-    # including how to customize your application traces.
-    #
-    # ### Using instrumentation with Sinatra
-    #
-    # To install application instrumentation in your Sinatra app, add this gem,
-    # `google-cloud-trace`, to your Gemfile and update your bundle. Then add
-    # the following lines to your main application Ruby file:
-    #
-    # ```ruby
-    # require "google/cloud/trace"
-    # use Google::Cloud::Trace::Middleware
-    # ```
-    #
-    # This will install the trace middleware in your application, providing
-    # basic request tracing for your application. You may measure additional
-    # processes such as database queries or calls to external services using
-    # other classes in this library. See the {Google::Cloud::Trace::Middleware}
-    # documentation for more information.
-    #
-    # ### Using instrumentation with other Rack-based frameworks
-    #
-    # To install application instrumentation in an app using another Rack-based
-    # web framework, add this gem, `google-cloud-trace`, to your Gemfile and
-    # update your bundle. Then add install the trace middleware in your
-    # middleware stack. In most cases, this means adding these lines to your
-    # `config.ru` Rack configuration file:
-    #
-    # ```ruby
-    # require "google/cloud/trace"
-    # use Google::Cloud::Trace::Middleware
-    # ```
-    #
-    # Some web frameworks have an alternate mechanism for modifying the
-    # middleware stack. Consult your web framework's documentation for more
-    # information.
-    #
-    # ### The Stackdriver diagnostics suite
-    #
-    # The trace library is part of the Stackdriver diagnostics suite, which
-    # also includes error reporting and log analysis. If you include the
-    # `stackdriver` gem in your Gemfile, this trace library will be included
-    # automatically. In addition, if you include the `stackdriver` gem in an
-    # application using Ruby On Rails, the Railtie will be installed
-    # automatically; you will not need to write any code to view latency
-    # traces for your appl. See the documentation for the "stackdriver" gem
-    # for more details.
-    #
-    # ## Stackdriver Trace API
-    #
-    # This library also includes an easy to use Ruby client for the
-    # Stackdriver Trace API. This API provides calls to report and modify
-    # application traces, as well as to query and analyze existing traces.
-    #
-    # For further information on the trace API, see
-    # {Google::Cloud::Trace::Project}.
-    #
-    # ### Querying traces using the API
-    #
-    # Using the Stackdriver Trace API, your application can query and analyze
-    # its own traces and traces of other projects. Here is an example query
-    # for all traces in the past hour.
-    #
-    # ```ruby
-    # require "google/cloud/trace"
-    # trace_client = Google::Cloud::Trace.new
-    #
-    # traces = trace_client.list_traces Time.now - 3600, Time.now
-    # traces.each do |trace|
-    #   puts "Retrieved trace ID: #{trace.trace_id}"
-    # end
-    # ```
-    #
-    # Each trace is an object of type {Google::Cloud::Trace::TraceRecord},
-    # which provides methods for analyzing tasks that took place during the
-    # request trace. See https://cloud.google.com/trace for more information
-    # on the kind of data you can capture in a trace.
-    #
-    # ### Reporting traces using the API
-    #
-    # Usually it is easiest to use this library's trace instrumentation
-    # features to collect and record application trace information. However,
-    # you may also use the trace API to update this data. Here is an example:
-    #
-    # ```ruby
-    # require "google/cloud/trace"
-    #
-    # trace_client = Google::Cloud::Trace.new
-    #
-    # trace = Google::Cloud::Trace.new
-    # trace.in_span "root_span" do
-    #   # Do stuff...
-    # end
-    #
-    # trace_client.patch_traces trace
-    # ```
-    #
-    # ## Enabling Logging
-    #
-    # To enable logging for this library, set the logger for the underlying
-    # [gRPC](https://github.com/grpc/grpc/tree/master/src/ruby) library. The
-    # logger that you set may be a Ruby stdlib
-    # [`Logger`](https://ruby-doc.org/stdlib-2.5.0/libdoc/logger/rdoc/Logger.html)
-    # as shown below, or a
-    # [`Google::Cloud::Logging::Logger`](https://googlecloudplatform.github.io/google-cloud-ruby/#/docs/google-cloud-logging/latest/google/cloud/logging/logger)
-    # that will write logs to [Stackdriver
-    # Logging](https://cloud.google.com/logging/). See
-    # [grpc/logconfig.rb](https://github.com/grpc/grpc/blob/master/src/ruby/lib/grpc/logconfig.rb)
-    # and the gRPC
-    # [spec_helper.rb](https://github.com/grpc/grpc/blob/master/src/ruby/spec/spec_helper.rb)
-    # for additional information.
-    #
-    # Configuring a Ruby stdlib logger:
-    #
-    # ```ruby
-    # require "logger"
-    #
-    # module MyLogger
-    #   LOGGER = Logger.new $stderr, level: Logger::WARN
-    #   def logger
-    #     LOGGER
-    #   end
-    # end
-    #
-    # # Define a gRPC module-level logger method before grpc/logconfig.rb loads.
-    # module GRPC
-    #   extend MyLogger
-    # end
-    # ```
+    # See {file:OVERVIEW.md Stackdriver Trace Overview}.
     #
     module Trace
       THREAD_KEY = :__stackdriver_trace_span__
@@ -231,8 +50,7 @@ module Google
       # Each call creates a new connection.
       #
       # For more information on connecting to Google Cloud see the
-      # [Authentication
-      # Guide](https://googlecloudplatform.github.io/google-cloud-ruby/#/docs/guides/authentication).
+      # {file:AUTHENTICATION.md Authentication Guide}.
       #
       # @param [String] project_id Project identifier for the Stackdriver Trace
       #   service you are connecting to. If not present, the default project for
@@ -321,9 +139,8 @@ module Google
       #   Default:
       #   `Google::Cloud::Trace::Notifications::DEFAULT_MAX_DATA_LENGTH`
       #
-      # See the [Configuration
-      # Guide](https://googlecloudplatform.github.io/google-cloud-ruby/#/docs/stackdriver/guides/instrumentation_configuration)
-      # for full configuration parameters.
+      # See the {file:INSTRUMENTATION.md Configuration Guide} for full
+      # configuration parameters.
       #
       # @return [Google::Cloud::Config] The configuration object
       #   the Google::Cloud::Trace module uses.

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

@@ -115,9 +115,10 @@ module Google
         # @param [Rack Application] app Rack application
         # @param [Google::Cloud::Trace::Service, AsyncReporter] service
         #   The service object to update traces. Optional if running on GCE.
-        # @param [Hash] *kwargs Hash of configuration settings. Used for
-        #   backward API compatibility. See the [Configuration
-        #   Guide](https://googlecloudplatform.github.io/google-cloud-ruby/#/docs/stackdriver/guides/instrumentation_configuration)
+        # @param [Hash] kwargs Hash of configuration settings. Used for backward
+        #   API compatibility. See the {file:INSTRUMENTATION.md Instrumentation
+        #   Guide} and [Configuration
+        #   Guide](https://googlecloudplatform.github.io/google-cloud-ruby/docs/stackdriver/latest/file.INSTRUMENTATION_CONFIGURATION)
         #   for the prefered way to set configuration parameters.
         #
         def initialize app, service: nil, **kwargs

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

@@ -12,6 +12,7 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
+
 require "google/cloud/env"
 require "google/cloud/trace"
 
@@ -43,8 +44,9 @@ module Google
       #
       # ## Configuration
       #
-      # See the [Configuration
-      # Guide](https://googlecloudplatform.github.io/google-cloud-ruby/#/docs/stackdriver/guides/instrumentation_configuration)
+      # See the {file:INSTRUMENTATION.md Instrumentation Guide} and
+      # [Configuration
+      # Guide](https://googlecloudplatform.github.io/google-cloud-ruby/docs/stackdriver/latest/file.INSTRUMENTATION_CONFIGURATION)
       # on how to configure the Railtie and Middleware.
       #
       # ## Measuring custom functionality

data/lib/google/cloud/trace/time_sampler.rb

@@ -12,6 +12,7 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
+
 module Google
   module Cloud
     module Trace

data/lib/google/cloud/trace/v1/credentials.rb

@@ -12,6 +12,7 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
+
 require "googleauth"
 
 module Google

data/lib/google/cloud/trace/v1/doc/google/devtools/cloudtrace/v1/trace.rb

@@ -12,6 +12,7 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
+
 module Google
   module Devtools
     module Cloudtrace

data/lib/google/cloud/trace/v1/doc/google/protobuf/empty.rb

@@ -12,6 +12,7 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
+
 module Google
   module Protobuf
     # A generic empty message that you can re-use to avoid defining duplicated

data/lib/google/cloud/trace/v1/doc/google/protobuf/timestamp.rb

@@ -12,6 +12,7 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
+
 module Google
   module Protobuf
     # A Timestamp represents a point in time independent of any time zone
@@ -72,12 +73,14 @@ module Google
     #
     # In JSON format, the Timestamp type is encoded as a string in the
     # [RFC 3339](https://www.ietf.org/rfc/rfc3339.txt) format. That is, the
-    # format is "{year}-{month}-{day}T{hour}:{min}:{sec}[.{frac_sec}]Z"
-    # where {year} is always expressed using four digits while {month}, {day},
-    # {hour}, {min}, and {sec} are zero-padded to two digits each. The fractional
+    # format is "\\{year}-\\{month}-\\{day}T\\{hour}:\\{min}:\\{sec}[.\\{frac_sec}]Z"
+    # where \\{year} is always expressed using four digits while \\{month}, \\{day},
+    # \\{hour}, \\{min}, and \\{sec} are zero-padded to two digits each. The fractional
     # seconds, which can go up to 9 digits (i.e. up to 1 nanosecond resolution),
     # are optional. The "Z" suffix indicates the timezone ("UTC"); the timezone
-    # is required, though only UTC (as indicated by "Z") is presently supported.
+    # is required. A proto3 JSON serializer should always use UTC (as indicated by
+    # "Z") when printing the Timestamp type and a proto3 JSON parser should be
+    # able to accept both UTC and other timezones (as indicated by an offset).
     #
     # For example, "2017-01-15T01:30:15.01Z" encodes 15.01 seconds past
     # 01:30 UTC on January 15, 2017.
@@ -88,8 +91,8 @@ module Google
     # 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://joda-time.sourceforge.net/apidocs/org/joda/time/format/ISODateTimeFormat.html#dateTime())
-    # to obtain a formatter capable of generating timestamps in this format.
+    # http://www.joda.org/joda-time/apidocs/org/joda/time/format/ISODateTimeFormat.html#dateTime--
+    # ) to obtain a formatter capable of generating timestamps in this format.
     # @!attribute [rw] seconds
     #   @return [Integer]
     #     Represents seconds of UTC time since Unix epoch

data/lib/google/cloud/trace/v1/trace_service_client.rb

@@ -19,6 +19,7 @@
 # For the short term, the refresh process will only be runnable by Google
 # engineers.
 
+
 require "json"
 require "pathname"
 
@@ -40,6 +41,7 @@ module Google
         # @!attribute [r] trace_service_stub
         #   @return [Google::Devtools::Cloudtrace::V1::TraceService::Stub]
         class TraceServiceClient
+          # @private
           attr_reader :trace_service_stub
 
           # The default address of the service.

data/lib/google/cloud/trace/v2.rb

@@ -12,6 +12,7 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
+
 require "google/cloud/trace/v2/trace_service_client"
 
 module Google

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

@@ -12,6 +12,7 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
+
 require "googleauth"
 
 module Google

data/lib/google/cloud/trace/v2/doc/google/devtools/cloudtrace/v2/trace.rb

@@ -12,6 +12,7 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
+
 module Google
   module Devtools
     module Cloudtrace

data/lib/google/cloud/trace/v2/doc/google/devtools/cloudtrace/v2/tracing.rb

@@ -12,6 +12,7 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
+
 module Google
   module Devtools
     module Cloudtrace

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

@@ -12,6 +12,7 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
+
 module Google
   module Protobuf
     # +Any+ contains an arbitrary serialized protocol buffer message along with a
@@ -95,17 +96,18 @@ module Google
     #     }
     # @!attribute [rw] type_url
     #   @return [String]
-    #     A URL/resource name whose content describes the type of the
-    #     serialized protocol buffer message.
+    #     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
+    #     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).
     #
-    #     For URLs which use the scheme +http+, +https+, or no scheme, the
-    #     following restrictions and interpretations apply:
+    #     In practice, teams usually precompile into the binary all types that they
+    #     expect it to use in the context of Any. However, for URLs which use the
+    #     scheme +http+, +https+, or no scheme, one can optionally set up a type
+    #     server that maps type URLs to message definitions as follows:
     #
     #     * If no scheme is provided, +https+ is assumed.
-    #     * 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).
     #     * An HTTP GET on the URL must yield a {Google::Protobuf::Type}
     #       value in binary format, or produce an error.
     #     * Applications are allowed to cache lookup results based on the
@@ -114,6 +116,10 @@ module Google
     #       on changes to types. (Use versioned type names to manage
     #       breaking changes.)
     #
+    #     Note: this functionality is not currently available in the official
+    #     protobuf release, and it is not used for type URLs beginning with
+    #     type.googleapis.com.
+    #
     #     Schemes other than +http+, +https+ (or the empty scheme) might be
     #     used with implementation specific semantics.
     # @!attribute [rw] value

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

@@ -12,6 +12,7 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
+
 module Google
   module Protobuf
     # A generic empty message that you can re-use to avoid defining duplicated

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

@@ -12,6 +12,7 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
+
 module Google
   module Protobuf
     # A Timestamp represents a point in time independent of any time zone
@@ -72,12 +73,14 @@ module Google
     #
     # In JSON format, the Timestamp type is encoded as a string in the
     # [RFC 3339](https://www.ietf.org/rfc/rfc3339.txt) format. That is, the
-    # format is "{year}-{month}-{day}T{hour}:{min}:{sec}[.{frac_sec}]Z"
-    # where {year} is always expressed using four digits while {month}, {day},
-    # {hour}, {min}, and {sec} are zero-padded to two digits each. The fractional
+    # format is "\\{year}-\\{month}-\\{day}T\\{hour}:\\{min}:\\{sec}[.\\{frac_sec}]Z"
+    # where \\{year} is always expressed using four digits while \\{month}, \\{day},
+    # \\{hour}, \\{min}, and \\{sec} are zero-padded to two digits each. The fractional
     # seconds, which can go up to 9 digits (i.e. up to 1 nanosecond resolution),
     # are optional. The "Z" suffix indicates the timezone ("UTC"); the timezone
-    # is required, though only UTC (as indicated by "Z") is presently supported.
+    # is required. A proto3 JSON serializer should always use UTC (as indicated by
+    # "Z") when printing the Timestamp type and a proto3 JSON parser should be
+    # able to accept both UTC and other timezones (as indicated by an offset).
     #
     # For example, "2017-01-15T01:30:15.01Z" encodes 15.01 seconds past
     # 01:30 UTC on January 15, 2017.
@@ -88,8 +91,8 @@ module Google
     # 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://joda-time.sourceforge.net/apidocs/org/joda/time/format/ISODateTimeFormat.html#dateTime())
-    # to obtain a formatter capable of generating timestamps in this format.
+    # http://www.joda.org/joda-time/apidocs/org/joda/time/format/ISODateTimeFormat.html#dateTime--
+    # ) to obtain a formatter capable of generating timestamps in this format.
     # @!attribute [rw] seconds
     #   @return [Integer]
     #     Represents seconds of UTC time since Unix epoch

data/lib/google/cloud/trace/v2/doc/google/protobuf/wrappers.rb

@@ -12,6 +12,7 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
+
 module Google
   module Protobuf
     # Wrapper message for +double+.

data/lib/google/cloud/trace/v2/doc/google/rpc/status.rb

@@ -12,6 +12,7 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
+
 module Google
   module Rpc
     # The +Status+ type defines a logical error model that is suitable for different

data/lib/google/cloud/trace/v2/trace_service_client.rb

@@ -19,6 +19,7 @@
 # For the short term, the refresh process will only be runnable by Google
 # engineers.
 
+
 require "json"
 require "pathname"
 
@@ -40,6 +41,7 @@ module Google
         # @!attribute [r] trace_service_stub
         #   @return [Google::Devtools::Cloudtrace::V2::TraceService::Stub]
         class TraceServiceClient
+          # @private
           attr_reader :trace_service_stub
 
           # The default address of the service.

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

@@ -16,7 +16,7 @@
 module Google
   module Cloud
     module Trace
-      VERSION = "0.33.2".freeze
+      VERSION = "0.33.3".freeze
     end
   end
 end

data/lib/google/devtools/cloudtrace/v1/trace_pb.rb

@@ -1,6 +1,7 @@
 # Generated by the protocol buffer compiler.  DO NOT EDIT!
 # source: google/devtools/cloudtrace/v1/trace.proto
 
+
 require 'google/protobuf'
 
 require 'google/api/annotations_pb'

data/lib/google/devtools/cloudtrace/v1/trace_services_pb.rb

@@ -16,6 +16,7 @@
 # limitations under the License.
 #
 
+
 require 'grpc'
 require 'google/devtools/cloudtrace/v1/trace_pb'
 

data/lib/google/devtools/cloudtrace/v2/trace_pb.rb

@@ -1,6 +1,7 @@
 # Generated by the protocol buffer compiler.  DO NOT EDIT!
 # source: google/devtools/cloudtrace/v2/trace.proto
 
+
 require 'google/protobuf'
 
 require 'google/api/annotations_pb'

data/lib/google/devtools/cloudtrace/v2/tracing_pb.rb

@@ -1,6 +1,7 @@
 # Generated by the protocol buffer compiler.  DO NOT EDIT!
 # source: google/devtools/cloudtrace/v2/tracing.proto
 
+
 require 'google/protobuf'
 
 require 'google/api/annotations_pb'

data/lib/google/devtools/cloudtrace/v2/tracing_services_pb.rb

@@ -16,6 +16,7 @@
 # limitations under the License.
 #
 
+
 require 'grpc'
 require 'google/devtools/cloudtrace/v2/tracing_pb'
 

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: google-cloud-trace
 version: !ruby/object:Gem::Version
-  version: 0.33.2
+  version: 0.33.3
 platform: ruby
 authors:
 - Daniel Azuma
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2018-08-21 00:00:00.000000000 Z
+date: 2018-09-10 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: google-cloud-core
@@ -210,16 +210,16 @@ dependencies:
   name: yard-doctest
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: 0.1.6
+        version: '0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: 0.1.6
+        version: '0'
 - !ruby/object:Gem::Dependency
   name: activerecord
   requirement: !ruby/object:Gem::Requirement