Welcome to Logbook¶
Logbook is a logging system for Python that replaces the standard library’s logging module. It was designed with both complex and simple applications in mind and the idea to make logging fun:
>>> from logbook import Logger, StreamHandler
>>> import sys
>>> StreamHandler(sys.stdout).push_application()
>>> log = Logger('Logbook')
>>> log.info('Hello, World!')
[2015-10-05 18:55:56.937141] INFO: Logbook: Hello, World!
What makes it fun? What about getting log messages on your phone or desktop notification system? Logbook can do that.
Feedback is appreciated. The docs here only show a tiny, tiny feature set and can be incomplete. We will have better docs soon, but until then we hope this gives a sneak peek about how cool Logbook is. If you want more, have a look at the comprehensive suite of tests.
Documentation¶
- What does it do?
- Quickstart
- Common Logbook Setups
- Stacks in Logbook
- Performance Tuning
- Logbook in Libraries
- Unittesting Support
- Logging to Tickets
- Logging Compatibility
- API Documentation
- The Design Explained
- Design Principles
- Cookbook
- Logbook Changelog
- Unreleased
- 1.10.1 - 2026-08-05
- 1.10.0 - 2026-08-05
- 1.9.2 - 2025-11-27
- 1.9.1 - 2025-11-06
- 1.9.0 - 2025-11-05
- 1.8.2 - 2025-06-14
- 1.8.1 - 2025-03-19
- 1.8.0 - 2024-10-26
- 1.7.0.post0 - 2023-11-11
- 1.7.0 - 2023-10-03
- 1.6.0 - 2023-07-30
- 1.5.3 - 2019-10-16
- 1.5.2 - 2019-08-21
- 1.5.1 - 2019-08-21
- 1.4.3 - 2019-01-16
- 1.4.2 - 2018-12-11
- 1.4.1 - 2018-10-14
- 1.4.0 - 2018-05-15
- 1.3.0 - 2018-03-05
- 1.2.0 - 2018-02-08
- 1.1.0 - 2017-07-13
- 1.0.1
- 1.0.0 - 2016-06-26
- 0.12.0 - 2015-11-24
- 0.11.3 - 2015-11-05
- 0.11.2 - 2015-09-29
- 0.11.0 - 2015-09-29
- 0.10.1 - 2015-08-04
- 0.10.0 - 2015-07-14
- 0.9.1 - 2015-05-04
- 0.9.0 - 2015-02-12
- 0.8.1 - 2014-11-30
- 0.8.0 - 2014-11-11
- 0.7.0 - 2014-05-12
- 0.6.0 - 2013-10-03
- 0.5.0 - 2013-08-10
- 0.4.2 - 2013-06-02
- 0.4.1 - 2012-12-12
- 0.4 - 2012-10-24
- 0.3 - 2010-10-23
- 0.2.1 - 2010-09-21
- 0.2 - 2010-09-21
- 0.1 - 2010-07-25