README.md in google-cloud-compute-v1-2.14.0 vs README.md in google-cloud-compute-v1-2.15.0
- old
+ new
@@ -35,9 +35,45 @@
for class and method documentation.
See also the [Product Documentation](https://cloud.google.com/compute/)
for general usage information.
+## Debug Logging
+
+This library comes with opt-in Debug Logging that can help you troubleshoot
+your application's integration with the API. When logging is activated, key
+events such as requests and responses, along with data payloads and metadata
+such as headers and client configuration, are logged to the standard error
+stream.
+
+**WARNING:** Client Library Debug Logging includes your data payloads in
+plaintext, which could include sensitive data such as PII for yourself or your
+customers, private keys, or other security data that could be compromising if
+leaked. Always practice good data hygiene with your application logs, and follow
+the principle of least access. Google also recommends that Client Library Debug
+Logging be enabled only temporarily during active debugging, and not used
+permanently in production.
+
+To enable logging, set the environment variable `GOOGLE_SDK_RUBY_LOGGING_GEMS`
+to the value `all`. Alternatively, you can set the value to a comma-delimited
+list of client library gem names. This will select the default logging behavior,
+which writes logs to the standard error stream. On a local workstation, this may
+result in logs appearing on the console. When running on a Google Cloud hosting
+service such as [Google Cloud Run](https://cloud.google.com/run), this generally
+results in logs appearing alongside your application logs in the
+[Google Cloud Logging](https://cloud.google.com/logging/) service.
+
+You can customize logging by modifying the `logger` configuration when
+constructing a client object. For example:
+
+```ruby
+require "google/cloud/compute/v1"
+require "logger"
+
+client = ::Google::Cloud::Compute::V1::AcceleratorTypes::Rest::Client.new do |config|
+ config.logger = Logger.new "my-app.log"
+end
+```
## Google Cloud Samples
To browse ready to use code samples check [Google Cloud Samples](https://cloud.google.com/docs/samples).