The heat.openstack.common.log Module

Openstack logging handler.

This module adds to logging functionality by adding the option to specify a context object when calling the various log methods. If the context object is not specified, default formatting is used. Additionally, an instance uuid may be passed as part of the log message, which is intended to make it easier for admins to find messages related to a specific instance.

It also allows setting of formatting information through conf.

class heat.openstack.common.log.ColorHandler(stream=None)[source]

Bases: logging.StreamHandler

LEVEL_COLORS = {40: '\x1b[01;31m', 10: '\x1b[00;32m', 50: '\x1b[01;31m', 20: '\x1b[00;36m', 21: '\x1b[01;36m', 30: '\x1b[01;33m'}
format(record)[source]
class heat.openstack.common.log.ContextAdapter(logger, project_name, version_string)[source]

Bases: logging.LoggerAdapter

audit(msg, *args, **kwargs)[source]
deprecated(msg, *args, **kwargs)[source]
process(msg, kwargs)[source]
warn(msg, *args, **kwargs)

Delegate a warning call to the underlying logger, after adding contextual information from this adapter instance.

exception heat.openstack.common.log.DeprecatedConfig(msg)[source]

Bases: exceptions.Exception

message = u'Fatal call to deprecated config: %(msg)s'
class heat.openstack.common.log.JSONFormatter(fmt=None, datefmt=None)[source]

Bases: logging.Formatter

format(record)[source]
formatException(ei, strip_newlines=True)[source]
class heat.openstack.common.log.LegacyFormatter(fmt=None, datefmt=None)[source]

Bases: logging.Formatter

A context.RequestContext aware formatter configured through flags.

The flags used to set format strings are: logging_context_format_string and logging_default_format_string. You can also specify logging_debug_format_suffix to append extra formatting if the log level is debug.

For information about what variables are available for the formatter see: http://docs.python.org/library/logging.html#formatter

format(record)[source]

Uses contextstring if request_id is set, otherwise default.

formatException(exc_info, record=None)[source]

Format exception output with CONF.logging_exception_prefix.

class heat.openstack.common.log.PublishErrorsHandler(level=0)[source]

Bases: logging.Handler

emit(record)[source]
class heat.openstack.common.log.WritableLogger(logger, level=20)[source]

Bases: object

A thin wrapper that responds to write and logs.

write(msg)[source]
heat.openstack.common.log.getLogger(name='unknown', version='unknown')[source]
heat.openstack.common.log.set_defaults(logging_context_format_string)[source]
heat.openstack.common.log.setup(product_name)[source]

Setup logging.

This Page