Structured Logging for Python¶
Release v16.2.0.dev0 (What’s new?).
structlog targets Python 2.7, 3.4 and newer, and PyPy.
If you need any help, visit us on
#structlog on Freenode!
structlog makes structured logging with key-value logging, incremental context building and arbitrary formatting as easy as:
>>> from structlog import get_logger >>> log = get_logger() >>> log = log.bind(user='anonymous', some_key=23) >>> log = log.bind(user='hynek', another_key=42) >>> log.info('user.logged_in', happy=True) some_key=23 user='hynek' another_key=42 happy=True event='user.logged_in'
- …reasons why structured logging in general and
structlogin particular are the way to go, consult Why….
- …more realistic examples, peek into Examples.
- …getting started right away, jump straight into Getting Started.
structlog avoids monkey-patching and events are fully free-form, you can start using it today!
Integration with Existing Systems¶
structlog can be used immediately with any existing logger.
However it comes with special wrappers for the Python standard library and Twisted that are optimized for their respective underlying loggers and contain less magic.