twisted.logger.STDLibLogObserver : API documentation

Log observer that writes to the python standard library's logging module.

Note Warning: specific logging configurations (example: network) can lead to this observer blocking. Nothing is done here to prevent that, so be sure to not to configure the standard library logging module to block when used in conjunction with this module: code within Twisted, such as twisted.web, assumes that logging does not block.

Class Variable	defaultStackDepth	This is the default number of frames that it takes to get from `STDLibLogObserver` through the logging module, plus one; in other words, the number of frames if you were to call a `STDLibLogObserver` directly. This is useful to use as an offset for the `stackDepth` parameter to `__init__`, to add frames for other publishers.
Method	__init__
Method	__call__	Format an event and bridge it to Python logging.
Method	_findCaller	Based on the stack depth passed to this `STDLibLogObserver`, identify the calling function.

defaultStackDepth =

This is the default number of frames that it takes to get from STDLibLogObserver through the logging module, plus one; in other words, the number of frames if you were to call a STDLibLogObserver directly. This is useful to use as an offset for the stackDepth parameter to __init__, to add frames for other publishers.

def __init__(self, name='twisted', stackDepth=defaultStackDepth): (source)

Parameters	loggerName	logger identifier. (type: `str`)
	stackDepth	The depth of the stack to investigate for caller metadata. (type: `int`)

def _findCaller(self, stackInfo=False): (source)

Based on the stack depth passed to this STDLibLogObserver, identify the calling function.

Parameters	stackInfo	Whether or not to construct stack information. (Currently ignored.) (type: `bool`)
Returns	Depending on Python version, either a 3-tuple of (filename, lineno, name) or a 4-tuple of that plus stack information. (type: `tuple`)

def __call__(self, event): (source)

from twisted.logger.ILogObserver

Format an event and bridge it to Python logging.

twisted.logger.STDLibLogObserver(object) class documentation

`twisted.logger.STDLibLogObserver(object)` class documentation