structlog

Backend & Infra

Simple, powerful, and fast logging for Python.

Latest: 25.5.05 releases2 breaking changes1 common errorsUpdated Oct 27, 2025View on GitHub

Release History

25.5.04 fixes9 features

Oct 27, 2025

This release adds mutable ConsoleRenderer with get_active, new configuration options, several new utilities, and fixes bugs around timestamp handling, traceback extraction, and color support.

25.4.0Breaking1 fix2 features

Jun 2, 2025

Version 25.4.0 adds Python 3.13.4/3.14 support and exception‑group handling, fixes ExceptionPrettyPrinter formatting, and introduces a breaking change for `filter_by_level()` on the new Python releases.

25.3.01 fix

Apr 25, 2025

This release fixes a bug in `structlog.processors.TimeStamper` where UTC timestamps were incorrectly using the local timezone when `utc=True`.

25.2.02 fixes3 features

Mar 11, 2025

This release adds an `exc_notes` field to `structlog.tracebacks.Stack`, makes `BoundLogger` methods return `Self`, and updates `TimeStamper` to produce timezone‑aware datetimes, while fixing import exposure for RichTracebackFormatter and LogfmtRenderer.

25.1.0Breaking7 fixes2 features

Jan 16, 2025

This release adds a new processor for positional log arguments, native logger helpers, and several bug fixes, while introducing breaking changes to the BindableLogger protocol and fatal logging behavior.

Common Errors

RecursionError1 report

RecursionError in structlog often happens when exception context is being logged and contains references back to itself or other parts of the logging machinery, creating infinite loops. To fix this, use `except_instead=True` during `structlog.configure` to prevent structlog from automatically adding exception information to the log record, forcing you to explicitly log it, giving control over what gets included, or implement a recursive-safe exception formatting function.