twisted.logger.LogLevel(Names) class documentation

Part of twisted.logger View Source (View In Hierarchy)

Constants describing log levels.

Class Variable debug Debugging events: Information of use to a developer of the software, not generally of interest to someone running the software unless they are attempting to diagnose a software issue.
Class Variable info Informational events: Routine information about the status of an application, such as incoming connections, startup of a subsystem, etc.
Class Variable warn Warning events: Events that may require greater attention than informational events but are not a systemic failure condition, such as authorization failures, bad data from a network client, etc. Such events are of potential interest to system administrators, and should ideally be phrased in such a way, or documented, so as to indicate an action that an administrator might take to mitigate the warning.
Class Variable error Error conditions: Events indicating a systemic failure, such as programming errors in the form of unhandled exceptions, loss of connectivity to an external system without which no useful work can proceed, such as a database or API endpoint, or resource exhaustion. Similarly to warnings, errors that are related to operational parameters may be actionable to system administrators and should provide references to resources which an administrator might use to resolve them.
Class Variable critical Critical failures: Errors indicating systemic failure (ie. service outage), data corruption, imminent data loss, etc. which must be handled immediately. This includes errors unanticipated by the software, such as unhandled exceptions, wherein the cause and consequences are unknown.
Class Method levelWithName Get the log level with the given name.
Class Method _priorityForLevel No summary

Inherited from _ConstantsContainer (via Names):

Method __new__ Classes representing constants containers are not intended to be instantiated.
Class Method lookupByName Retrieve a constant by its name or raise a ValueError if there is no constant associated with that name.
Class Method iterconstants Iteration over a Names subclass results in all of the constants it contains.
Class Variable _constantType Specified by a _ConstantsContainer subclass to specify the type of constants allowed by that subclass.
Class Variable _enumerants A dict mapping the names of constants (eg NamedConstant instances) found in the class definition to those instances.
Class Method _constantFactory Construct the value for a new constant to add to this container.
debug =
Debugging events: Information of use to a developer of the software, not generally of interest to someone running the software unless they are attempting to diagnose a software issue.
info =
Informational events: Routine information about the status of an application, such as incoming connections, startup of a subsystem, etc.
warn =
Warning events: Events that may require greater attention than informational events but are not a systemic failure condition, such as authorization failures, bad data from a network client, etc. Such events are of potential interest to system administrators, and should ideally be phrased in such a way, or documented, so as to indicate an action that an administrator might take to mitigate the warning.
error =
Error conditions: Events indicating a systemic failure, such as programming errors in the form of unhandled exceptions, loss of connectivity to an external system without which no useful work can proceed, such as a database or API endpoint, or resource exhaustion. Similarly to warnings, errors that are related to operational parameters may be actionable to system administrators and should provide references to resources which an administrator might use to resolve them.
critical =
Critical failures: Errors indicating systemic failure (ie. service outage), data corruption, imminent data loss, etc. which must be handled immediately. This includes errors unanticipated by the software, such as unhandled exceptions, wherein the cause and consequences are unknown.
@classmethod
def levelWithName(cls, name): (source)

Get the log level with the given name.

ParametersnameThe name of a log level. (type: str (native string))
ReturnsThe LogLevel with the specified name. (type: LogLevel)
RaisesInvalidLogLevelErrorif the name does not name a valid log level.
@classmethod
def _priorityForLevel(cls, level): (source)

We want log levels to have defined ordering - the order of definition - but they aren't value constants (the only value is the name). This is arguably a bug in Twisted, so this is just a workaround for until this is fixed in some way.

ParameterslevelA log level. (type: LogLevel)
ReturnsA numeric index indicating priority (lower is higher level). (type: int)
API Documentation for Twisted, generated by pydoctor at 2016-04-04 15:02:49.