Skip to main content

Structured Logging for Python

Project description

structlog mascot

structlog is the production-ready logging solution for Python:

  • Simple: Everything is about functions that take and return dictionaries – all hidden behind familiar APIs.
  • Powerful: Functions and dictionaries aren’t just simple but also powerful. structlog leaves you in control.
  • Fast: structlog is not hamstrung by designs of yore. Its flexibility comes not at the price of performance.

Thanks to its flexible design, you choose whether you want structlog to take care of the output of your log entries or whether you prefer to forward them to an existing logging system like the standard library's logging module.

The output format is just as flexible and structlog comes with support for JSON, logfmt, as well as pretty console output out-of-the-box:

image

Sponsors

structlog would not be possible without our amazing sponsors. Especially those generously supporting us at the The Organization tier and higher:

Please consider joining them to help make structlog’s maintenance more sustainable!

Introduction

structlog has been successfully used in production at every scale since 2013, while embracing cutting-edge technologies like asyncio, context variables, or type hints as they emerged. Its paradigms proved influential enough to help design structured logging packages across ecosystems.

Project Links

structlog for Enterprise

Available as part of the Tidelift Subscription.

The maintainers of structlog and thousands of other packages are working with Tidelift to deliver commercial support and maintenance for the open source packages you use to build your applications. Save time, reduce risk, and improve code health, while paying the maintainers of the exact packages you use.

Release Information

Added

  • Support for Python 3.14 and Python 3.13.4.

    Python 3.14 has an backwards-incompatible change to logging.Logger.isEnabledFor() (it now always returns False if a log entry is in flight) that has been backported to 3.13.4 (expected on 2025-06-03). It mainly affects structlog.stdlib.filter_by_level(). #723

  • structlog.tracebacks now handles exception groups. structlog.tracebacks.Stack has two new fields, is_group: bool and exceptions: list[Trace]. This works similarly to what Rich v14.0.0 does. #720

Fixed

  • structlog.processors.ExceptionPrettyPrinter now respects the exception_formatter arguments instead of always using the default formatter. #724

Full Changelog →

Credits

structlog is written and maintained by Hynek Schlawack. The idea of bound loggers is inspired by previous work by Jean-Paul Calderone and David Reid.

The development is kindly supported by my employer Variomedia AG, structlog’s Tidelift subscribers, and all my amazing GitHub Sponsors.

The logs-loving beaver logo has been contributed by Lynn Root.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

structlog-25.4.0.tar.gz (1.4 MB view details)

Uploaded Source

Built Distribution

structlog-25.4.0-py3-none-any.whl (68.7 kB view details)

Uploaded Python 3

File details

Details for the file structlog-25.4.0.tar.gz.

File metadata

  • Download URL: structlog-25.4.0.tar.gz
  • Upload date:
  • Size: 1.4 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.12.9

File hashes

Hashes for structlog-25.4.0.tar.gz
Algorithm Hash digest
SHA256 186cd1b0a8ae762e29417095664adf1d6a31702160a46dacb7796ea82f7409e4
MD5 acec56588b8e3ec7f28e36cbdb93021c
BLAKE2b-256 79b96e672db4fec07349e7a8a8172c1a6ae235c58679ca29c3f86a61b5e59ff3

See more details on using hashes here.

Provenance

The following attestation bundles were made for structlog-25.4.0.tar.gz:

Publisher: pypi-package.yml on hynek/structlog

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file structlog-25.4.0-py3-none-any.whl.

File metadata

  • Download URL: structlog-25.4.0-py3-none-any.whl
  • Upload date:
  • Size: 68.7 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.12.9

File hashes

Hashes for structlog-25.4.0-py3-none-any.whl
Algorithm Hash digest
SHA256 fe809ff5c27e557d14e613f45ca441aabda051d119ee5a0102aaba6ce40eed2c
MD5 096beb16c41baf1b9de8ff0481daa159
BLAKE2b-256 a04a97ee6973e3a73c74c8120d59829c3861ea52210667ec3e7a16045c62b64d

See more details on using hashes here.

Provenance

The following attestation bundles were made for structlog-25.4.0-py3-none-any.whl:

Publisher: pypi-package.yml on hynek/structlog

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page