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 |
| 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) |