[docs] [issue37470] Make it explicit what happens when using a bounded queue with QueueHandler

[Martijn Pieters]

New submission from Martijn Pieters <mj at python.org>:

The documentation doesn't make it explicit what happens if you use a bounded queue together with logging.handlers.QueueHandler.

If the queue is bounded in size and attempts are made to add logrecords faster than a queue listener removes them, then the resulting `queue.Full` exception is passed to `handler.handleError()` and that usually means the record is simply dropped (see https://docs.python.org/3/library/logging.html#logging.Handler.handleError).

That may be the desired behaviour, but making it explicit is always better.

----------
assignee: docs at python
components: Documentation
messages: 347018
nosy: docs at python, mjpieters
priority: normal
severity: normal
status: open
title: Make it explicit what happens when using a bounded queue with QueueHandler
versions: Python 3.7, Python 3.8, Python 3.9

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue37470>
_______________________________________