Logging in DUNE-DAQ — Documentation¶
Welcome, fellow beavers, to the logging documentation for daqpytools.
This documentation is split into two sections depending on your role:
- User docs — for anyone writing Python applications that use logging
- Developer docs — for anyone extending the logging system itself (new handlers, new filters). This is found in a separate MKDocs website.
User documentation¶
| Page | What it's for |
|---|---|
| Tutorial | Get a working logger running from scratch |
| Concepts & explanation | Understand how Python logging and daqpytools work |
| How to use handlers and filters | Descriptions and examples for each handler and filter |
| How to route messages | Direct records to specific handlers using HandlerType and LogHandlerConf |
| How to add handlers at runtime | Attach handlers after logger creation; pass kwargs |
| How to configure ERS | Attach and use ERS handlers |
| How to upgrade an existing package | Migration checklist for adopting daqpytools logging in existing codebases |
| Best practices | Recommended patterns for structuring logging in your application |
| Troubleshooting | Common symptoms, causes, and fixes |
| API reference | Auto-generated kwargs, types, and defaults for all public APIs (redirects to MKDocs website) |
| Environment configs | Extra information on how to configure your local copy of the logging. |
Last git commit to the markdown source of this page:
Author: Emir Muhammad
Date: Fri Jun 5 16:59:02 2026 +0100
If you see a problem with the documentation on this page, please file an Issue at https://github.com/DUNE-DAQ/daqpytools/issues