What's Changed
The libraries are instrumented to generate the following signals:
INFOspans for each logical client request. Typically a single method call in the client struct gets such a span.- A histogram metric measuring the elapsed time for each logical client request.
WARNlogs for each logical client requests that fail.INFOspans for each low-level attempt RPC attempt. Typically a single method in the client struct gets one such span, but there may be more if the library had to retry the RPC.DEBUGlogs for each low-level attempt that fails.
These spans and logs follow OpenTelemetry Semantic Conventions with additional Google Cloud attributes. Both the spans and logs and are should be suitable for production monitoring.
The libraries also have DEBUG spans for each request, these include the full request body, the full response body for successful requests, and the full error message, with details, for failed requests. Consider the contents of these requests and responses before enabling them in production environments, as the request or responses may include sensitive data.
These DEBUG spans use the client library crate followed by ::tracing as their target (e.g. google-cloud-secretmanager-v1::tracing) and the method name as the span name.You can use the name and/or target to set up your filters.
Warning
Observability signals at any level may contain sensitive data such as resource names, full URLs, and error messages.
Before configuring subscribers or exporters for traces and logs, review the contents of the spans and consult the tracing framework documentation to set up filters and formatters to prevent leaking sensitive information, depending on your intended use case.
More information
The Enable logging guide shows you how to initialize a subscriber to log events to the console.
Other changes
- fix(pubsub): batch nacks on shutdown to respect service limits by @suzmue in #5149
- feat(storage): skip unnecessary checksum computation during read_object by @vsharonlynn in #5134
- fix(pubsub): avoid ack batch size limit errors by @dbolduc in #5227
- feat(pubsub): add APIs to shutdown subscriber by @dbolduc in #5257
- feat(pubsub): add nack() method to Handler for AtLeastOnce by @suzmue in #5261
- fix(auth): executable sourced creds should accept id token type by @alvarowolfx in #5316
- feat(pubsub): add confirmed_nack to ExactlyOnce handler by @suzmue in #5303
- docs: minor docs fixes by @zoryamba in #5370
- docs: fix enum guide link by @dbolduc in #5378
Full Changelog: release-20260327...release-20260413