CHANGELOG.md

Release History

2.6.1 (2025-11-04)

Documentation

• add warning about loading unvalidated credentials (#32121)

2.6.0 (2025-03-04)

Features

• Update minimum Ruby version to 3.0 (#29261)

2.5.0 (2024-07-09)

Features

• compatibility with GA releases of underlying versioned clients (#26361)

2.4.0 (2024-03-07)

Features

• Update minimum supported Ruby version to 2.7 (#25298)

2.3.3 (2023-05-19)

Documentation

• Fixed broken links in authentication documentation (#21619)

2.3.2 (2022-10-18)

Bug Fixes

• update list logs response (#19285)

2.3.1 (2022-07-24)

Bug Fixes

• update resource descriptor to handle paged enum (#18856)

2.3.0 (2022-06-30)

Features

• Update minimum Ruby version to 2.6 (#18444)

2.2.2 / 2021-10-21

Documentation

• Add documentation for quota_project Configuration attribute

2.2.1 / 2021-07-08

Documentation

• Update AUTHENTICATION.md in handwritten packages

2.2.0 / 2021-03-10

Features

• Drop support for Ruby 2.4 and add support for Ruby 3.0

2.1.0 / 2020-09-16

Features

• quota_project can be set via library configuration

2.0.0 / 2020-07-21

This is a major update that removes the "low-level" client interface code, and instead adds the new google-cloud-logging-v2 gem as a dependency. The new dependency is a rewritten low-level client, produced by a next- generation client code generator, with improved performance and stability.

This change should have no effect on the high-level interface that most users will use. The one exception is that the (mostly undocumented) client_config argument, for adjusting low-level parameters such as RPC retry settings on client objects, has been removed. If you need to adjust these parameters, use the configuration interface in google-cloud-logging-v2.

Substantial changes have been made in the low-level interfaces, however. If you are using the low-level classes under the Google::Cloud::Logging::V2 module, please review the docs for the new google-cloud-logging-v2 gem. In particular:

• Some classes have been renamed, notably the client class itself.
• The client constructor takes a configuration block instead of configuration keyword arguments.
• All RPC method arguments are now keyword arguments.

1.10.9 / 2020-06-17

Documentation

• Improved field descriptions in the low-level interface.

1.10.8 / 2020-06-12

Documentation

• Provide more details on low-level monitored resource data types

1.10.7 / 2020-05-28

Documentation

• Fix a few broken links

1.10.6 / 2020-05-19

Bug Fixes

• Adjusted some default timeout and retry settings

1.10.5 / 2020-05-05

Bug Fixes

• Prevent error when calling stop! on unused AsyncWriter

1.10.4 / 2020-04-20

Documentation

• Fix some broken links in the Project and Sink docs

1.10.3 / 2020-04-06

Documentation

• Fix some broken links in the low-level interface documentation.

1.10.2 / 2020-04-01

Bug Fixes

• Restore some path helpers in the low-level interface.

1.10.1 / 2020-03-19

Bug Fixes

• Restore billing, folder, and organization path helpers in low-level interface

1.10.0 / 2020-03-16

Features

• support separate project setting for quota/billing

Low-level interface updates

• Add LogBucket
• Add ConfigServiceV2Client#list_buckets
• Add ConfigServiceV2Client#get_bucket
• Add ConfigServiceV2Client#update_bucket
• Add LifecycleState enum
• Change name to positional param in ConfigServiceV2Client#get_cmek_settings
• Change name and cmek_settings to positional params in ConfigServiceV2Client#update_cmek_settings
• Remove billing, folder, and organization path helpers from ConfigServiceV2Client
• Remove LogEntry#metadata
• Remove previously deprecated project_ids from LoggingServiceV2Client#list_log_entries
• Remove log_path helpers from LoggingServiceV2Client
• Rename ConfigServiceV2Client#billing_path to #billing_account_path
• Rename LoggingServiceV2Client#billing_path to #billing_account_path
• Rename MetricsServiceV2Client#metric_path to #log_metric_path
• Update network configuration settings

1.9.5 / 2020-02-24

Documentation

• Fix doc links to Cmek methods in lower-level client

1.9.4 / 2020-01-23

Documentation

• Update copyright year

1.9.3 / 2019-12-20

Documentation

• Update description of MetricDescriptor#unit in lower-level API

1.9.2 / 2019-12-18

Bug Fixes

• Fix MonitorMixin usage on Ruby 2.7
  • Ruby 2.7 will error if new_cond is called before super().
  • Make the call to super() be the first call in initialize

Documentation

• Update docs for lower-level API call MetricDescriptorMetadata#unit

1.9.1 / 2019-11-06

Bug Fixes

• Update minimum runtime dependencies

1.9.0 / 2019-10-29

This release requires Ruby 2.4 or later.

Documentation

• Clarify which Google Cloud Platform environments support automatic authentication

1.8.0 / 2019-10-03

Features

• Support additional fields of LogSink in the low-level interface
  • Add LogSink#create_time field
  • Add LogSink#update_time field
  • Add LogSink#bigquery_options field
  • Add BigQueryOptions type
  • Update documentation

1.7.0 / 2019-08-23

Features

• Support overriding of service endpoint

1.6.6 / 2019-07-31

• Fix max threads setting in thread pools
  • Thread pools once again limit the number of threads allocated.
• Update documentation links

1.6.5 / 2019-07-08

• Support overriding service host and port in the low-level interface.

1.6.4 / 2019-06-11

• Add documentation for MetricDescriptor#launch_stage and MonitoredResourceDescriptor#launch_stage.
• Deprecate MetricDescriptor:: MetricDescriptorMetadata#launch_stage
• Use VERSION constant in GAPIC client

1.6.3 / 2019-04-29

• Add AUTHENTICATION.md guide.
• Update generated documentation.
• Update generated code examples.
• Extract gRPC header values from request.

1.6.2 / 2019-02-13

• Fix bug (typo) in retrieving default on_error proc.

1.6.1 / 2019-02-07

• Update concurrent-ruby dependency

1.6.0 / 2019-01-22

• AsyncWriter buffer entries and make batch API calls
  • Update AsyncWriter to buffer log entries and batch API calls.
  • Maintain backwards compatibility with the previous AsyncWriter's public API, although the implementation is changed.
  • Back pressure is applied by limiting the number of queued API calls. Errors will now be raised when there are not enough resources.
  • Errors are reported using the AsyncWriter#on_error callback.
  • Pending log entries are sent before the process closes using at_exit.
  • Add Logging on_error configuration.
• Add default insert_id value for Entry
  • Add Entry.insert_id
  • Add default insert_id value for Entry An Entry object is assigned an insert_id when created so that if the Entry object gets persisted multiple times it would know its insert_id value and not attempt to generate a new one for each persist attempt. An Entry object will still be considered empty if the only value it has is the insert_id.
  • (This change does not use SecureRandom for performance reasons.)
• Add Logging trace_sampled
  • Add Entry#trace_sampled attribute
  • Add trace_sampled to Logger::RequestInfo
• Changes to Rails default Logger
  • Delay updating the Rails default logger until the first web request.
    • This will avoid issues with forking processes and gRPC resources.
    • This is accomplished by adding the on_init argument to middleware.
  • Add Railtie.set_default_logger
    • This method can be called post-fork to update the Rails default logger.
• Make use of Credentials#project_id
  • Use Credentials#project_id If a project_id is not provided, use the value on the Credentials object. This value was added in googleauth 0.7.0.
  • Loosen googleauth dependency Allow for new releases up to 0.10. The googleauth devs have committed to maintaining the current API and will not make backwards compatible changes before 0.10.
• Direct logs for "/healthz" requests to the health check log.
• Update documentation.

1.5.7 / 2018-11-15

• Add Google::Logging::V2::LogEntry#trace_sampled.
• Update low-level documentation.

1.5.6 / 2018-10-03

• Use concurrent-ruby and ThreadLocalVar in Logger.
  • Remove Monitor and synchronize blocks.
  • Logger#thread_ids now only returns the current thread.

1.5.5 / 2018-09-20

• Make Logger thread-safe.
• Update Logging generated files.
  • Add Metric's MetricDescriptorMetadata.
• Update documentation.
  • Change documentation URL to googleapis GitHub org.
• Fix circular require warning.

1.5.4 / 2018-09-12

• Add missing documentation files to package.

1.5.3 / 2018-09-10

• Update documentation.

1.5.2 / 2018-08-21

• Update documentation.

1.5.1 / 2018-07-05

• Fix bug in List classes by propagating arguments needed for pagination calls.
• Fix issue when disabling Stackdriver components with Rails.env.production.
• Reduce string memory usage.
• Add documentation for enabling gRPC logging.

1.5.0 / 2018-02-27

• Use Google Cloud Shared Configuration.
• Deprecated Logging Sink attributes.

1.4.0 / 2017-12-19

• Update google-gax dependency to 1.0.

1.3.2 / 2017-11-20

• Refresh GAPIC layer (low-level API) based on updates to Protobuf types.

1.3.1 / 2017-11-15

• Fix credentials verification bug in Railtie.

1.3.0 / 2017-11-14

• Add Google::Cloud::Logging::Credentials class.
• Rename constructor arguments to project_id and credentials. (The previous arguments project and keyfile are still supported.)
• Document Google::Auth::Credentials as credentials value.
• Add partial_success optional argument to Project#write_entries.
• Deprecate HttpRequest#method, use HttpRequest#request_method instead.
• Update generated low level GAPIC code.
• Updated google-gax (grpc, google-protobuf), googleauth dependencies.

1.2.3 / 2017-09-27

• Updated protobuf classes.
• Updated README.

1.2.2 / 2017-09-08

• Add labels configuration option to Google::Cloud::Logging::Middleware for Rails and other Rack-based framework integrations.

1.2.1 / 2017-07-11

• stackdriver-core 1.2.0 release

1.2.0 / 2017-07-11

• Update labels parameter in Google::Cloud::Logging::Logger#initialize to default to empty hash.
• Update Google::Cloud::Logging::Logger to support the following ActiveSupport::Logger methods: :local_level, :local_level=, :silence, :silencer, and :unknown?.
• Update GAPIC configuration to exclude UNAVAILABLE errors from automatic retry.
• Update gem spec homepage links.

1.1.0 / 2017-05-25

• Introduce new Google::Cloud::Logging.configure instrumentation configuration interface.
• Google::Cloud::Logger now sends extra trace context information in log entries.

1.0.1 / 2017-04-21

• Middleware constructor can be called without an explicit logger. This should make integration in non-Rails applications simpler.
• If Rails integration fails due to an auth error, the notice is now printed to STDOUT rather than STDERR, which should make it a bit less scary when displayed in Docker output.

1.0.0 / 2017-03-31

• Release 1.0
• Added #trace and #source_location to Entry
• Added listing of logs for the project
• Updated documentation
• Automatic retry on UNAVAILABLE errors

0.24.2 / 2017-03-03

• No public API changes.
• Update GRPC header value sent to the Logging API.

0.24.1 / 2017-03-01

• No public API changes.
• Update GRPC header value sent to the Logging API.
• Low level API adds new Protobuf types and GAPIC methods.

0.24.0 / 2017-02-21

• Fix GRPC retry bug
• The client_config data structure has replaced retry_codes/retry_codes_def with retry_codes
• Update GRPC/Protobuf/GAX dependencies

0.23.2 / 2016-12-27

• Google::Cloud::Logging::Logger depended on standard logger but didn't require it. Fixed.

0.23.1 / 2016-12-22

• Use the stackdriver-core gem to obtain Trace ID, for compatibility with the google-cloud-trace gem.
• Google::Cloud::Logging::Logger now understands all remaining standard Logger methods.
• Clean up AsyncWriter threads on VM exit, to prevent gRPC from crashing if it's still in the middle of a call.
• Support setting log name by path, and direct App Engine health checks to a separate log by default.
• Minor improvements to warning messages.

0.23.0 / 2016-12-8

• Add resources method argument to Project#entries
• Deprecate projects method argument from Project#entries
• Add start_at, end_at, and writer_identity attributes to Sink
• Add start_at, end_at, and unique_writer_identity parameters to Project#create_sink
• Add unique_writer_identity parameter to Sink#save
• Many documentation improvements
• Add documentation for Low Level API

0.21.2 / 2016-11-15

• Fix issue with uninitialized VERSION (remi)

0.21.1 / 2016-11-4

• Upgraded Google::Cloud::Logging::Railtie to use AsyncWriter
• Added Rails configuration for custom monitored resource

0.21.0 / 2016-10-20

• New service constructor Google::Cloud::Logging.new
• New constructor argument client_config
• Logger is now asynchronous
• AsyncWriter added
• Rails and Rack integration added

0.20.1 / 2016-09-02

• Fix an issue with the GRPC client and forked sub-processes

0.20.0 / 2016-08-26

This gem contains the Stackdriver Logging service implementation for the google-cloud gem. The google-cloud gem replaces the old gcloud gem. Legacy code can continue to use the gcloud gem.

• Namespace is now Google::Cloud
• The google-cloud gem is now an umbrella package for individual gems