Structured Logging for Python
structlog is the production-ready logging solution for Python:
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:
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!
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.
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. Learn more.
The colorful development logger is now even more configurable! Choose freely your colors and the order of the key-value pairs! Implement your own formatters for certain keys!
Implementing the output on top of the new columns API has changed the default very slightly, but shouldn't be noticeable. #577
Async log methods (those starting with an a
) now also support the collection of callsite information using structlog.processors.CallsiteParameterAdder
.
#565
structlog.stdlib.recreate_defaults()
now also adds structlog.stdlib.add_logger_name
to the processors.
Check out the updated screenshot!The return value from get_logger()
(a BoundLoggerLazyProxy
) now passes isinstance
-checks against structlog.typing.BindableLogger
on Python 3.12.
#561
structlog.threadlocal.tmp_bind()
now also works with BoundLoggerLazyProxy
(in other words: before anything is bound to a bound logger).
stdlib: ProcessorFormatter
can now be told to not render the log record message using getMessage
and just str(record.msg)
instead.
#550
stdlib: structlog.stdlib.BoundLogger.exception()
's handling ofLogRecord.exc_info
is now set consistent with logging
.
#571
#572
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.