google-cloud-logging

3.16.1 (2026-07-07)

Documentation

• logging: fix StructuredLogHandler docstring parameter name (#17625) (32862f0), closes #17604

Features

• drop support for Python 3.7, 3.8, and 3.9 runtimes (#17276) (014e951b6a1a07cb25baf4286e433a0c28783314)

3.15.0 (2026-09-24)

Features

• storage: support storage_class in AsyncAppendableObjectWriter (#18289) (dc30df2)
• storage: support storage_class via Blob in AsyncAppendableObjectWriter (#18318) (b0872f2)

Features

• support mTLS certificates when available (#1071) (c73e43906298e99405830d69a8383f71b85bd75b)

Features

• Add support for python 3.14 (#1065) (6be3df6aa94539cd2ab22a4fac55b343862228b2)

Bug Fixes

• remove setup.cfg configuration for creating universal wheels (#981) (70f612c3281f1df13f3aba6b19bc4e9397297f3d)

Bug Fixes

• Make logging handler close conditional to having the transport opened (#990) (66c6b91)

Features

• Add REST Interceptors which support reading metadata (681bcc5)
• Add support for opt-in debug logging (681bcc5)
• Added flushes/close functionality to logging handlers (#917) (d179304)

Bug Fixes

• Allow protobuf 6.x (#977) (6757890)
• deps: Require google-cloud-audit-log >= 0.3.1 (#979) (1cc00ec)
• Fix typing issue with gRPC metadata when key ends in -bin (681bcc5)

Documentation

• Added documentation on log_level and excluded_loggers params in setup_logging (#971) (70d9d25)
• Update README to break infinite redirect loop (#972) (52cd907)

Bug Fixes

• Made write_entries raise ValueError on ParseErrors (#958) (5309478)
• Require proto-plus >= 1.25 for Python 3.13 (#955) (7baed8e)
• Require proto-plus >= 1.25 for Python 3.13 (#955) (002b1fc)

Bug Fixes

• 16-bit hexadecimal formatting for XCTC span IDs (#946) (1f2b190)

Bug Fixes

• deps: Require google-cloud-appengine-logging>=0.1.3 (550abca)
• deps: Require google-cloud-audit-log >= 0.2.4 (550abca)
• deps: Require opentelemetry-api>=1.9.0 (550abca)
• Fixed type hinting issue with specifying Transport class (#930) (e2875d6)

Bug Fixes

• Allow protobuf 5.x (#888) (7746e64)

Features

• OpenTelemetry trace/spanID integration for Python handlers (#889) (78168a3)

Bug Fixes

• Added environment specific labels to client library when running in Cloud Run Jobs (#877) (9c5e8f0)
• Added missing import into logger.py (#896) (9ca242d)
• Added type hints to CloudLoggingHandler constructor (#903) (6959345)

Documentation

• Add summary_overview template (#878) (b60714c)
• Changed table in web-framework-integration to bulleted list (#875) (a4aa3a7)
• Documentation update for OpenTelemetry (#915) (2a0539a)
• Update dictConfig snippet (#885) (6264107)

Features

• Allow users to explicitly configure universe domain (#846) (e998a21)

Bug Fixes

• Added placeholder kwargs to StructuredLogHandler (#845) (9bc0a37)
• Allowed for a partial override of loggers that get excluded from setup_client (#831) (870c940)
• Remove usage in including_default_value_fields to prepare for protobuf 5.x (#866) (66a534d)
• Use value of cluster-location in GKE for tagging location (#830) (c15847c)

Documentation

• Added documentation for Django/Flask integrations and dictConfig (#848) (c65ec92)

Features

• Add support for Python 3.12 (#813) (6591b53)
• Use native namespaces instead of pkg_resources (#812) (10ad75d)

Bug Fixes

• Fixed DeprecationWarning for datetime objects for Python 3.12 (#824) (2384981)
• Fixed object paths in autogenerated code in owlbot.py (#804) (b14bb14)
• Updated protobuf JSON formatting to support nested protobufs (#797) (a00c261)
• Use retry_async instead of retry in async client (#816) (c79f7f5)
• Use warning instead of warn in system tests to avoid DeprecationWarning (#821) (c447175)

Features

• Add cloud_run_job monitored resource type. (#788) (3b310d6)

Features

• Add ConfigServiceV2.CreateBucketAsync method for creating Log Buckets asynchronously (30f24a8)
• Add ConfigServiceV2.CreateLink method for creating linked datasets for Log Analytics Buckets (30f24a8)
• Add ConfigServiceV2.DeleteLink method for deleting linked datasets (30f24a8)
• Add ConfigServiceV2.GetLink methods for describing linked datasets (30f24a8)
• Add ConfigServiceV2.ListLinks method for listing linked datasets (30f24a8)
• Add ConfigServiceV2.UpdateBucketAsync method for creating Log Buckets asynchronously (30f24a8)
• Add LogBucket.analytics_enabled field that specifies whether Log Bucket's Analytics features are enabled (30f24a8)
• Add LogBucket.index_configs field that contains a list of Log Bucket's indexed fields and related configuration data (30f24a8)
• Log Analytics features of the Cloud Logging API (30f24a8)

Bug Fixes

• Add async context manager return types (30f24a8)
• Add severity to structured log write (#783) (31a7f69)
• Handle exceptions raised when fetching Django request data (#758) (5ecf886)
• Unintended exception omittion (#736) (022dc54)

Documentation

• Documentation for the Log Analytics features of the Cloud Logging API (30f24a8)
• Minor formatting (30f24a8)

Features

• Add logic to convert severity string to uppercase (#744) (c1c8ce1)

Bug Fixes

• Properly handle None from metadata server (#718) (dedaff9)

Documentation

• Fix formatting of request arg in docstring (#734) (dbb1794)

Features

• Add support for Python 3.11 (412d481)

Bug Fixes

• Add context manager return types (e2278c1)
• Instrumentation entries should not contain user labels (#703) (e05d132)
• Require proto-plus 1.22.2 for Python 3.11 (412d481)
• Send StructuredLogHandler instrumentation log using an explicit logger (#705) (ac6a2c6)

Documentation

• Add documentation for enums (e2278c1)

Features

• Add typing to proto.Message based class attributes (9d505f1)

Bug Fixes

• Add dict typing for client_options (9d505f1)
• deps: Require google-api-core >=1.34.0, >=2.11.0 (9d505f1)
• Drop usage of pkg_resources (9d505f1)
• Fix timeout default values (9d505f1)

Documentation

• samples: Snippetgen handling of repeated enum field (9d505f1)
• samples: Snippetgen should call await on the operation coroutine before calling result (9d505f1)

Bug Fixes

• Client_info default values (#681) (b74d2a8)

Features

• Add support to custom JSON encoders (#657) (77e621c)
• Include context on batch log errors (#650) (d08be9a)
• Set partial_success to default to true for batched logs (#649) (e56d3e8)
• Support Django asgi middleware (#625) (f52b3aa)

Bug Fixes

• deps: Allow protobuf 3.19.5 (#644) (12f3001)
• Json fields dictionary has modification side effect (#654) (a62a0d6)

Bug Fixes

• deps: Require protobuf >= 3.20.2 (#633) (b4da4ce)

Bug Fixes

• Mimic the pubsub test to clean up bigquery datasets (#639) (44deb1b)
• Nested json with structured log handler (#636) (b840435)
• Structured log handler drops reserved fields in json_fields (#634) (4ef38b3)

Bug Fixes

• deps: allow protobuf < 5.0.0 (#600) (8495dac)
• deps: require proto-plus >= 1.22.0 (8495dac)

Bug Fixes

• deps: require google-api-core>=1.32.0,>=2.8.0 (#585) (de35eab)

Features

• add audience parameter (a2eed8c)
• Add support for library instrumentation (#551) (8ba0023)

Bug Fixes

• deps: require google-api-core >= 2.8.0 (#575) (a2eed8c)
• deps: require google-cloud-core >= 2.0.0 (a2eed8c)
• require python 3.7+ (#580) (0b3eb52)

Bug Fixes

• deps: require protobuf <4.0.0dev (#564) (cb0720c)

Documentation

• fix changelog header to consistent size (#562) (3f16107)
• Update README image to absolute URL, fix PyPI rendering (#561) (76413b1)

Documentation

• Change button in README to .png file (#554) (e297747)

⚠ BREAKING CHANGES

• make logging API more friendly to use (#422)
• api consistency between HTTP and Gapic layers (#375)
• support string-encoded json (#339)
• Infer default resource in logger (#315)
• support json logs (#316)
• deprecate AppEngineHandler and ContainerEngineHandler (#310)

Features

• add api key support (#472) (81ca8c6)
• add json_fields extras argument for adding to jsonPayload (#447) (a760e02)
• avoid importing grpc when explicitly disabled (#416) (818213e)
• Infer default resource in logger (#315) (c632503)
• make logging API more friendly to use (#422) (83d9ca8)
• support json logs (#316) (5267152)
• support string-encoded json (#339) (6fa1773)
• trace improvements (#450) (e0c5fc0)

Bug Fixes

• allow reading logs from non-project paths (#444) (97e32b6)
• api consistency between HTTP and Gapic layers (#375) (e1506fa)

Miscellaneous Chores

• deprecate AppEngineHandler and ContainerEngineHandler (#310) (e3cac88)

Documentation

• update usage guide for v3.0.0 (#456) (8a67b73)

2.7.0 (2026-09-29)

Features

• declare Python3.15 support (05b0c34)

Features

• add always_use_jwt_access (#334) (ae67d10)

Bug Fixes

• deps: pin 'google-{api,cloud}-core', 'google-auth' to allow 2.x versions (#356) (a970dd2)
• disable always_use_jwt_access (#342) (a95e401)
• enable self signed jwt for grpc (#360) (707fad1)

Documentation

• omit mention of Python 2.7 in 'CONTRIBUTING.rst' (#1127) (#327) (faa6fb9), closes #1126
• add Samples section to CONTRIBUTING.rst (#357) (8771716)

Features

• support AuditLog and RequestLog protos (#274) (5d91be9)

Bug Fixes

• deps: add packaging requirement (#300) (68c5cec)
• structured log handler formatting issues (#319) (db9da37)

Features

• allow custom labels with standard library logging (#264) (fe4de39)
• Improve source location overrides (#258) (6b10b74)
• record source locations (#254) (a5c2f8e)
• support span inference (#267) (fcd26eb)
• use standard output logs on serverless environments (#228) (a78f577)

Bug Fixes

• changed region format on serverless (#291) (8872d6f)
• changed region format on serverless (#291) (360d3d2)
• deps: fix minimum required version of google-api-core (#244) (874fdfa)
• deps: fix minimum required version of google-api-core (#244) (37d33fc)
• improve API compatibility for next release (#292) (1f9517d)
• remove noisy logs (#290) (bdf8273)

Bug Fixes

• detect project from environment instead of from logger (#238) (813b97c)
• revert default resource behavior to avoid breaking changes (#237) (24a0a5e)

Features

• Add json setting to allow unicodes to show in log instead of ascii ch… (#193) (e8c8e30)
• detect monitored resources on all GCP environments (#200) (4eda681)

Bug Fixes

• logger uses default resource (#207) (0f90a79)
• no duplicate logs on GCF or GAE (#209) (37e6c8e)

Documentation

• add python std_logging to sample browser (#173) (7cc7275)

Features

• add 'from_service_account_info' factory to clients (a9ff2b7)

Bug Fixes

• django content length extraction bug (#160) (93eeaef)
• fix sphinx identifiers (a9ff2b7)

Bug Fixes

• use dict for http request (#156) (dc26668)

Features

• allow modifying LogEntry data using extra argument (#129) (92b287f)
• support http_request field (#120) (ba94afb)

Bug Fixes

• add InternalServerError to list of expected errors (#151) (9bf49f5)

Documentation

• fix usage guide (#140) (1ca3981)

Bug Fixes

• Add submodule imports for handlers to logging alias (#117) (6843a3a)
• remove client recv msg limit fix: add enums to types/__init__.py (#131) (6349b89)
• Remove keyword only argument for RequestsMiddleware (#113) (e704f28)

Bug Fixes

• remove duplicate stream handler (#106) (eb5cf40)

Documentation

• fix logger documentation (#100) (6a46b46)

⚠ BREAKING CHANGES

• Use microgenerator for GAPIC layer. See UPGRADING.md for details. (#94)
• removes support for webapp2 and other Python2 specific code

Features

• pass 'client_options' to super ctor (#61) (c4387b3), closes #55
• use microgenerator (#94) (ff90fd2)

Bug Fixes

• add default filter settings to list_entries (#73) (0a1dd94)
• failing CI tests (#70) (96adeed)

Code Refactoring

• remove python2 (#78) (bf579e4)

Documentation

• update docs (#77) (bdd9c44)

Documentation

• add initialization of LogEntry instance in the v2 example (#46) (251ac93), closes #44
• change descriptions for virtual environment (#48) (c5c3c15), closes #47

Features

• add support for cmek settings; undeprecate resource name helper methods; bump copyright year to 2020 (#22) (1c687c1)

Bug Fixes

• logging: deprecate resource name helper methods (via synth) (#9837) (335af9e)
• logging: update test assertion and core version pins (#10087) (4aedea8)
• replace unsafe six.PY3 with PY2 for better future compatibility with Python 4 (#10081) (c6eb601)

10-15-2019 06:50 PDT

Implementation Changes

• Fix proto copy. (#9420)

Dependencies

• Pin 'google-cloud-core >= 1.0.3, < 2.0.0dev'. (#9445)

09-23-2019 10:00 PDT

Implementation Changes

• Pass 'stream' argument to super in 'ContainerEngineHandler.init'. (#9166)

New Features

• Add LoggingV2Servicer, LogSinks, logging_metrics, and log_entry. Add LogSeverity and HttpRequest types (via synth). (#9262)
• Add client_options to logging v1 (#9046)

Documentation

• Remove compatability badges from READMEs. (#9035)

Internal / Testing Changes

• Docs: Remove CI for gh-pages, use googleapis.dev for api_core refs. (#9085)
• Delete custom synth removing gRPC send/recv msg size limits. (#8939)

08-01-2019 09:45 PDT

Implementation Changes

• Remove gRPC size restrictions (4MB default) (#8860)
• Map stdlib loglevels to Cloud Logging severity enum values. (#8837)

Documentation

• Fix 'list_entries' example with projects. (#8858)

Internal / Testing Changes

• Update intersphinx mapping for requests. (#8805)

07-24-2019 16:47 PDT

Implementation Changes

• Set the 'timestamp' on log records created by handler. (#8227)
• Clarify worker thread implementation. (#8228)

New Features

• Add path-construction helpers to GAPIC clients (via synth). (#8631)
• Add 'client_options' support, update list method docstrings (via synth). (#8535)

Dependencies

• Bump minimum version for google-api-core to 1.14.0. (#8709)

Documentation

• Link to googleapis.dev documentation in READMEs. (#8705)
• Add compatibility check badges to READMEs. (#8288)

Internal / Testing Changes

• Re-add "generated" markers (via synth). (#8538)
• Add nox session 'docs' to remaining manual clients. (#8478)
• Add docs job to publish to googleapis.dev. (#8464)
• Fix tests broken in PR #8227. (#8273)
• Add empty lines. (#8064)
• Use alabaster theme everwhere. (#8021)

05-16-2019 12:27 PDT

Implementation Changes

• Add routing header to method metadata (via synth). (#7598)
• Remove classifier for Python 3.4 for end-of-life. (#7535)
• Use FQDN for GCE metadata endpoint. (#7520)

New Features

• Add client_info support to client. (#7874) and (#7901)

Dependencies

• Pin google-cloud-core >= 1.0.0, < 2.0dev. (#7993)

Documentation

• Update client library documentation URLs. (#7307)
• Reformat snippet (via synth). (#7216)
• Add snippet for logging a resource. (#7212)

Internal / Testing Changes

• Reorder methods in file (via synth). (#7810)
• Copy lintified proto files (via synth). (#7450)
• Trivial gapic-generator change. (#7230)
• Add protos as an artifact to library (#7205)

1.10.0 (2026-09-29)

Features

• declare Python3.15 support (05b0c34)

12-17-2018 16:49 PST

Implementation Changes

• Allow setting name, args on default handler (post-blacken) (#6828)

Documentation

• Document Python 2 deprecation (#6910)
• Normalize docs for page_size / max_results / page_token. (#6842)