README.md in google-cloud-monitoring-0.28.0 vs README.md in google-cloud-monitoring-0.29.0

- old
+ new

@@ -11,11 +11,11 @@ In order to use this library, you first need to go through the following steps: 1. [Select or create a Cloud Platform project.](https://console.cloud.google.com/project) 2. [Enable billing for your project.](https://cloud.google.com/billing/docs/how-to/modify-project#enable_billing_for_a_project) -3. [Enable the Stackdriver Monitoring API.](https://console.cloud.google.com/apis/api/monitoring) +3. [Enable the Stackdriver Monitoring API.](https://console.cloud.google.com/apis/library/monitoring.googleapis.com) 4. [Setup Authentication.](https://googlecloudplatform.github.io/google-cloud-ruby/#/docs/google-cloud/master/guides/authentication) ### Installation ``` $ gem install google-cloud-monitoring @@ -41,26 +41,52 @@ # Process element. end end ``` -### Supported Ruby Versions - -This library is supported on Ruby 2.0+. - -However, Ruby 2.3 or later is strongly recommended, as earlier releases have -reached or are nearing end-of-life. After June 1, 2018, Google will provide -official support only for Ruby versions that are considered current and -supported by Ruby Core (that is, Ruby versions that are either in normal -maintenance or in security maintenance). -See https://www.ruby-lang.org/en/downloads/branches/ for further details. - ### Next Steps - Read the [Client Library Documentation][] for Stackdriver Monitoring API to see other available methods on the client. - Read the [Stackdriver Monitoring API Product documentation][Product Documentation] to learn more about the product and see How-to Guides. - View this [repository's main README](https://github.com/GoogleCloudPlatform/google-cloud-ruby/blob/master/README.md) to see the full list of Cloud APIs that we cover. [Client Library Documentation]: https://googlecloudplatform.github.io/google-cloud-ruby/#/docs/google-cloud-monitoring/latest/google/monitoring/v3 [Product Documentation]: https://cloud.google.com/monitoring + +## 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 +``` + +## Supported Ruby Versions + +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 +recommended. See https://www.ruby-lang.org/en/downloads/branches/ for details +about the Ruby support schedule.