Skip to main content

Structured Logging for Python

Project description

structlog mascot

structlog makes logging in Python faster, less painful, and more powerful by adding structure to your log entries. It has been successfully used in production at every scale since 2013, while embracing cutting-edge technologies like asyncio or type hints along the way, and influenced the design of structured logging packages in other ecosystems.

Thanks to its highly flexible design, it’s up to you whether you want structlog to take care about 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.

https://github.com/hynek/structlog/blob/main/docs/_static/console_renderer.png?raw=true

A short explanation on why structured logging is good for you, and why structlog is the right tool for the job can be found in the Why chapter of our documentation.

Once you feel inspired to try it out, check out our friendly Getting Started tutorial that also contains detailed installation instructions!

If you prefer videos over reading, check out Markus Holtermann’s DjangoCon Europe 2019 talk: Logging Rethought 2: The Actions of Frank Taylor Jr.

Getting Help

Please use the structlog tag on StackOverflow to get help.

Answering questions of your fellow developers is also a great way to help the project!

Project Information

structlog is dual-licensed under Apache License, version 2 and MIT, available from PyPI, the source code can be found on GitHub, the documentation at https://www.structlog.org/.

We collect useful third-party extension in our wiki.

structlog targets Python 3.6 and later. PyPy3 is known to work, but is not tested anymore.

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. Learn more.

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-21.5.0.tar.gz (473.1 kB view details)

Uploaded Source

Built Distribution

structlog-21.5.0-py3-none-any.whl (53.4 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: structlog-21.5.0.tar.gz
  • Upload date:
  • Size: 473.1 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.7.1 importlib_metadata/4.8.2 pkginfo/1.8.2 requests/2.26.0 requests-toolbelt/0.9.1 tqdm/4.62.3 CPython/3.10.1

File hashes

Hashes for structlog-21.5.0.tar.gz
Algorithm Hash digest
SHA256 68c4c29c003714fe86834f347cb107452847ba52414390a7ee583472bde00fc9
MD5 1f19243f71ce1ff49d4b48c23bc9207d
BLAKE2b-256 ea77e38019e698b0c0134f903ab40e87f0975813ca7f74dad287272788134f03

See more details on using hashes here.

File details

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

File metadata

  • Download URL: structlog-21.5.0-py3-none-any.whl
  • Upload date:
  • Size: 53.4 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.7.1 importlib_metadata/4.8.2 pkginfo/1.8.2 requests/2.26.0 requests-toolbelt/0.9.1 tqdm/4.62.3 CPython/3.10.1

File hashes

Hashes for structlog-21.5.0-py3-none-any.whl
Algorithm Hash digest
SHA256 fd7922e195262b337da85c2a91c84be94ccab1f8fd1957bd6986f6904e3761c8
MD5 ac8318d597e56897c03cc83c729e450d
BLAKE2b-256 4ba27c5d78fa0b6fc4f249d0a732811b2cef979d16677e21f10637bbedcd0e6a

See more details on using hashes here.

Supported by

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