|
|
|
@ -1,712 +0,0 @@
|
|
|
|
|
# Copyright 2011 OpenStack Foundation.
|
|
|
|
|
# Copyright 2010 United States Government as represented by the
|
|
|
|
|
# Administrator of the National Aeronautics and Space Administration.
|
|
|
|
|
# All Rights Reserved.
|
|
|
|
|
#
|
|
|
|
|
# Licensed under the Apache License, Version 2.0 (the "License"); you may
|
|
|
|
|
# not use this file except in compliance with the License. You may obtain
|
|
|
|
|
# a copy of the License at
|
|
|
|
|
#
|
|
|
|
|
# http://www.apache.org/licenses/LICENSE-2.0
|
|
|
|
|
#
|
|
|
|
|
# Unless required by applicable law or agreed to in writing, software
|
|
|
|
|
# distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
|
|
|
|
|
# WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
|
|
|
|
|
# License for the specific language governing permissions and limitations
|
|
|
|
|
# under the License.
|
|
|
|
|
|
|
|
|
|
"""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.
|
|
|
|
|
|
|
|
|
|
"""
|
|
|
|
|
|
|
|
|
|
import inspect
|
|
|
|
|
import itertools
|
|
|
|
|
import logging
|
|
|
|
|
import logging.config
|
|
|
|
|
import logging.handlers
|
|
|
|
|
import os
|
|
|
|
|
import re
|
|
|
|
|
import sys
|
|
|
|
|
import traceback
|
|
|
|
|
|
|
|
|
|
from oslo.config import cfg
|
|
|
|
|
import six
|
|
|
|
|
from six import moves
|
|
|
|
|
|
|
|
|
|
from oslo.vmware.openstack.common.gettextutils import _
|
|
|
|
|
from oslo.vmware.openstack.common import importutils
|
|
|
|
|
from oslo.vmware.openstack.common import jsonutils
|
|
|
|
|
from oslo.vmware.openstack.common import local
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
_DEFAULT_LOG_DATE_FORMAT = "%Y-%m-%d %H:%M:%S"
|
|
|
|
|
|
|
|
|
|
_SANITIZE_KEYS = ['adminPass', 'admin_pass', 'password', 'admin_password']
|
|
|
|
|
|
|
|
|
|
# NOTE(ldbragst): Let's build a list of regex objects using the list of
|
|
|
|
|
# _SANITIZE_KEYS we already have. This way, we only have to add the new key
|
|
|
|
|
# to the list of _SANITIZE_KEYS and we can generate regular expressions
|
|
|
|
|
# for XML and JSON automatically.
|
|
|
|
|
_SANITIZE_PATTERNS = []
|
|
|
|
|
_FORMAT_PATTERNS = [r'(%(key)s\s*[=]\s*[\"\']).*?([\"\'])',
|
|
|
|
|
r'(<%(key)s>).*?(</%(key)s>)',
|
|
|
|
|
r'([\"\']%(key)s[\"\']\s*:\s*[\"\']).*?([\"\'])',
|
|
|
|
|
r'([\'"].*?%(key)s[\'"]\s*:\s*u?[\'"]).*?([\'"])']
|
|
|
|
|
|
|
|
|
|
for key in _SANITIZE_KEYS:
|
|
|
|
|
for pattern in _FORMAT_PATTERNS:
|
|
|
|
|
reg_ex = re.compile(pattern % {'key': key}, re.DOTALL)
|
|
|
|
|
_SANITIZE_PATTERNS.append(reg_ex)
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
common_cli_opts = [
|
|
|
|
|
cfg.BoolOpt('debug',
|
|
|
|
|
short='d',
|
|
|
|
|
default=False,
|
|
|
|
|
help='Print debugging output (set logging level to '
|
|
|
|
|
'DEBUG instead of default WARNING level).'),
|
|
|
|
|
cfg.BoolOpt('verbose',
|
|
|
|
|
short='v',
|
|
|
|
|
default=False,
|
|
|
|
|
help='Print more verbose output (set logging level to '
|
|
|
|
|
'INFO instead of default WARNING level).'),
|
|
|
|
|
]
|
|
|
|
|
|
|
|
|
|
logging_cli_opts = [
|
|
|
|
|
cfg.StrOpt('log-config-append',
|
|
|
|
|
metavar='PATH',
|
|
|
|
|
deprecated_name='log-config',
|
|
|
|
|
help='The name of logging configuration file. It does not '
|
|
|
|
|
'disable existing loggers, but just appends specified '
|
|
|
|
|
'logging configuration to any other existing logging '
|
|
|
|
|
'options. Please see the Python logging module '
|
|
|
|
|
'documentation for details on logging configuration '
|
|
|
|
|
'files.'),
|
|
|
|
|
cfg.StrOpt('log-format',
|
|
|
|
|
default=None,
|
|
|
|
|
metavar='FORMAT',
|
|
|
|
|
help='DEPRECATED. '
|
|
|
|
|
'A logging.Formatter log message format string which may '
|
|
|
|
|
'use any of the available logging.LogRecord attributes. '
|
|
|
|
|
'This option is deprecated. Please use '
|
|
|
|
|
'logging_context_format_string and '
|
|
|
|
|
'logging_default_format_string instead.'),
|
|
|
|
|
cfg.StrOpt('log-date-format',
|
|
|
|
|
default=_DEFAULT_LOG_DATE_FORMAT,
|
|
|
|
|
metavar='DATE_FORMAT',
|
|
|
|
|
help='Format string for %%(asctime)s in log records. '
|
|
|
|
|
'Default: %(default)s'),
|
|
|
|
|
cfg.StrOpt('log-file',
|
|
|
|
|
metavar='PATH',
|
|
|
|
|
deprecated_name='logfile',
|
|
|
|
|
help='(Optional) Name of log file to output to. '
|
|
|
|
|
'If no default is set, logging will go to stdout.'),
|
|
|
|
|
cfg.StrOpt('log-dir',
|
|
|
|
|
deprecated_name='logdir',
|
|
|
|
|
help='(Optional) The base directory used for relative '
|
|
|
|
|
'--log-file paths'),
|
|
|
|
|
cfg.BoolOpt('use-syslog',
|
|
|
|
|
default=False,
|
|
|
|
|
help='Use syslog for logging. '
|
|
|
|
|
'Existing syslog format is DEPRECATED during I, '
|
|
|
|
|
'and then will be changed in J to honor RFC5424'),
|
|
|
|
|
cfg.BoolOpt('use-syslog-rfc-format',
|
|
|
|
|
# TODO(bogdando) remove or use True after existing
|
|
|
|
|
# syslog format deprecation in J
|
|
|
|
|
default=False,
|
|
|
|
|
help='(Optional) Use syslog rfc5424 format for logging. '
|
|
|
|
|
'If enabled, will add APP-NAME (RFC5424) before the '
|
|
|
|
|
'MSG part of the syslog message. The old format '
|
|
|
|
|
'without APP-NAME is deprecated in I, '
|
|
|
|
|
'and will be removed in J.'),
|
|
|
|
|
cfg.StrOpt('syslog-log-facility',
|
|
|
|
|
default='LOG_USER',
|
|
|
|
|
help='Syslog facility to receive log lines')
|
|
|
|
|
]
|
|
|
|
|
|
|
|
|
|
generic_log_opts = [
|
|
|
|
|
cfg.BoolOpt('use_stderr',
|
|
|
|
|
default=True,
|
|
|
|
|
help='Log output to standard error')
|
|
|
|
|
]
|
|
|
|
|
|
|
|
|
|
log_opts = [
|
|
|
|
|
cfg.StrOpt('logging_context_format_string',
|
|
|
|
|
default='%(asctime)s.%(msecs)03d %(process)d %(levelname)s '
|
|
|
|
|
'%(name)s [%(request_id)s %(user_identity)s] '
|
|
|
|
|
'%(instance)s%(message)s',
|
|
|
|
|
help='Format string to use for log messages with context'),
|
|
|
|
|
cfg.StrOpt('logging_default_format_string',
|
|
|
|
|
default='%(asctime)s.%(msecs)03d %(process)d %(levelname)s '
|
|
|
|
|
'%(name)s [-] %(instance)s%(message)s',
|
|
|
|
|
help='Format string to use for log messages without context'),
|
|
|
|
|
cfg.StrOpt('logging_debug_format_suffix',
|
|
|
|
|
default='%(funcName)s %(pathname)s:%(lineno)d',
|
|
|
|
|
help='Data to append to log format when level is DEBUG'),
|
|
|
|
|
cfg.StrOpt('logging_exception_prefix',
|
|
|
|
|
default='%(asctime)s.%(msecs)03d %(process)d TRACE %(name)s '
|
|
|
|
|
'%(instance)s',
|
|
|
|
|
help='Prefix each line of exception output with this format'),
|
|
|
|
|
cfg.ListOpt('default_log_levels',
|
|
|
|
|
default=[
|
|
|
|
|
'amqp=WARN',
|
|
|
|
|
'amqplib=WARN',
|
|
|
|
|
'boto=WARN',
|
|
|
|
|
'qpid=WARN',
|
|
|
|
|
'sqlalchemy=WARN',
|
|
|
|
|
'suds=INFO',
|
|
|
|
|
'iso8601=WARN',
|
|
|
|
|
'requests.packages.urllib3.connectionpool=WARN'
|
|
|
|
|
],
|
|
|
|
|
help='List of logger=LEVEL pairs'),
|
|
|
|
|
cfg.BoolOpt('publish_errors',
|
|
|
|
|
default=False,
|
|
|
|
|
help='Publish error events'),
|
|
|
|
|
cfg.BoolOpt('fatal_deprecations',
|
|
|
|
|
default=False,
|
|
|
|
|
help='Make deprecations fatal'),
|
|
|
|
|
|
|
|
|
|
# NOTE(mikal): there are two options here because sometimes we are handed
|
|
|
|
|
# a full instance (and could include more information), and other times we
|
|
|
|
|
# are just handed a UUID for the instance.
|
|
|
|
|
cfg.StrOpt('instance_format',
|
|
|
|
|
default='[instance: %(uuid)s] ',
|
|
|
|
|
help='If an instance is passed with the log message, format '
|
|
|
|
|
'it like this'),
|
|
|
|
|
cfg.StrOpt('instance_uuid_format',
|
|
|
|
|
default='[instance: %(uuid)s] ',
|
|
|
|
|
help='If an instance UUID is passed with the log message, '
|
|
|
|
|
'format it like this'),
|
|
|
|
|
]
|
|
|
|
|
|
|
|
|
|
CONF = cfg.CONF
|
|
|
|
|
CONF.register_cli_opts(common_cli_opts)
|
|
|
|
|
CONF.register_cli_opts(logging_cli_opts)
|
|
|
|
|
CONF.register_opts(generic_log_opts)
|
|
|
|
|
CONF.register_opts(log_opts)
|
|
|
|
|
|
|
|
|
|
# our new audit level
|
|
|
|
|
# NOTE(jkoelker) Since we synthesized an audit level, make the logging
|
|
|
|
|
# module aware of it so it acts like other levels.
|
|
|
|
|
logging.AUDIT = logging.INFO + 1
|
|
|
|
|
logging.addLevelName(logging.AUDIT, 'AUDIT')
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
try:
|
|
|
|
|
NullHandler = logging.NullHandler
|
|
|
|
|
except AttributeError: # NOTE(jkoelker) NullHandler added in Python 2.7
|
|
|
|
|
class NullHandler(logging.Handler):
|
|
|
|
|
def handle(self, record):
|
|
|
|
|
pass
|
|
|
|
|
|
|
|
|
|
def emit(self, record):
|
|
|
|
|
pass
|
|
|
|
|
|
|
|
|
|
def createLock(self):
|
|
|
|
|
self.lock = None
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
def _dictify_context(context):
|
|
|
|
|
if context is None:
|
|
|
|
|
return None
|
|
|
|
|
if not isinstance(context, dict) and getattr(context, 'to_dict', None):
|
|
|
|
|
context = context.to_dict()
|
|
|
|
|
return context
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
def _get_binary_name():
|
|
|
|
|
return os.path.basename(inspect.stack()[-1][1])
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
def _get_log_file_path(binary=None):
|
|
|
|
|
logfile = CONF.log_file
|
|
|
|
|
logdir = CONF.log_dir
|
|
|
|
|
|
|
|
|
|
if logfile and not logdir:
|
|
|
|
|
return logfile
|
|
|
|
|
|
|
|
|
|
if logfile and logdir:
|
|
|
|
|
return os.path.join(logdir, logfile)
|
|
|
|
|
|
|
|
|
|
if logdir:
|
|
|
|
|
binary = binary or _get_binary_name()
|
|
|
|
|
return '%s.log' % (os.path.join(logdir, binary),)
|
|
|
|
|
|
|
|
|
|
return None
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
def mask_password(message, secret="***"):
|
|
|
|
|
"""Replace password with 'secret' in message.
|
|
|
|
|
|
|
|
|
|
:param message: The string which includes security information.
|
|
|
|
|
:param secret: value with which to replace passwords.
|
|
|
|
|
:returns: The unicode value of message with the password fields masked.
|
|
|
|
|
|
|
|
|
|
For example:
|
|
|
|
|
|
|
|
|
|
>>> mask_password("'adminPass' : 'aaaaa'")
|
|
|
|
|
"'adminPass' : '***'"
|
|
|
|
|
>>> mask_password("'admin_pass' : 'aaaaa'")
|
|
|
|
|
"'admin_pass' : '***'"
|
|
|
|
|
>>> mask_password('"password" : "aaaaa"')
|
|
|
|
|
'"password" : "***"'
|
|
|
|
|
>>> mask_password("'original_password' : 'aaaaa'")
|
|
|
|
|
"'original_password' : '***'"
|
|
|
|
|
>>> mask_password("u'original_password' : u'aaaaa'")
|
|
|
|
|
"u'original_password' : u'***'"
|
|
|
|
|
"""
|
|
|
|
|
message = six.text_type(message)
|
|
|
|
|
|
|
|
|
|
# NOTE(ldbragst): Check to see if anything in message contains any key
|
|
|
|
|
# specified in _SANITIZE_KEYS, if not then just return the message since
|
|
|
|
|
# we don't have to mask any passwords.
|
|
|
|
|
if not any(key in message for key in _SANITIZE_KEYS):
|
|
|
|
|
return message
|
|
|
|
|
|
|
|
|
|
secret = r'\g<1>' + secret + r'\g<2>'
|
|
|
|
|
for pattern in _SANITIZE_PATTERNS:
|
|
|
|
|
message = re.sub(pattern, secret, message)
|
|
|
|
|
return message
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
class BaseLoggerAdapter(logging.LoggerAdapter):
|
|
|
|
|
|
|
|
|
|
def audit(self, msg, *args, **kwargs):
|
|
|
|
|
self.log(logging.AUDIT, msg, *args, **kwargs)
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
class LazyAdapter(BaseLoggerAdapter):
|
|
|
|
|
def __init__(self, name='unknown', version='unknown'):
|
|
|
|
|
self._logger = None
|
|
|
|
|
self.extra = {}
|
|
|
|
|
self.name = name
|
|
|
|
|
self.version = version
|
|
|
|
|
|
|
|
|
|
@property
|
|
|
|
|
def logger(self):
|
|
|
|
|
if not self._logger:
|
|
|
|
|
self._logger = getLogger(self.name, self.version)
|
|
|
|
|
return self._logger
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
class ContextAdapter(BaseLoggerAdapter):
|
|
|
|
|
warn = logging.LoggerAdapter.warning
|
|
|
|
|
|
|
|
|
|
def __init__(self, logger, project_name, version_string):
|
|
|
|
|
self.logger = logger
|
|
|
|
|
self.project = project_name
|
|
|
|
|
self.version = version_string
|
|
|
|
|
self._deprecated_messages_sent = dict()
|
|
|
|
|
|
|
|
|
|
@property
|
|
|
|
|
def handlers(self):
|
|
|
|
|
return self.logger.handlers
|
|
|
|
|
|
|
|
|
|
def deprecated(self, msg, *args, **kwargs):
|
|
|
|
|
"""Call this method when a deprecated feature is used.
|
|
|
|
|
|
|
|
|
|
If the system is configured for fatal deprecations then the message
|
|
|
|
|
is logged at the 'critical' level and :class:`DeprecatedConfig` will
|
|
|
|
|
be raised.
|
|
|
|
|
|
|
|
|
|
Otherwise, the message will be logged (once) at the 'warn' level.
|
|
|
|
|
|
|
|
|
|
:raises: :class:`DeprecatedConfig` if the system is configured for
|
|
|
|
|
fatal deprecations.
|
|
|
|
|
|
|
|
|
|
"""
|
|
|
|
|
stdmsg = _("Deprecated: %s") % msg
|
|
|
|
|
if CONF.fatal_deprecations:
|
|
|
|
|
self.critical(stdmsg, *args, **kwargs)
|
|
|
|
|
raise DeprecatedConfig(msg=stdmsg)
|
|
|
|
|
|
|
|
|
|
# Using a list because a tuple with dict can't be stored in a set.
|
|
|
|
|
sent_args = self._deprecated_messages_sent.setdefault(msg, list())
|
|
|
|
|
|
|
|
|
|
if args in sent_args:
|
|
|
|
|
# Already logged this message, so don't log it again.
|
|
|
|
|
return
|
|
|
|
|
|
|
|
|
|
sent_args.append(args)
|
|
|
|
|
self.warn(stdmsg, *args, **kwargs)
|
|
|
|
|
|
|
|
|
|
def process(self, msg, kwargs):
|
|
|
|
|
# NOTE(mrodden): catch any Message/other object and
|
|
|
|
|
# coerce to unicode before they can get
|
|
|
|
|
# to the python logging and possibly
|
|
|
|
|
# cause string encoding trouble
|
|
|
|
|
if not isinstance(msg, six.string_types):
|
|
|
|
|
msg = six.text_type(msg)
|
|
|
|
|
|
|
|
|
|
if 'extra' not in kwargs:
|
|
|
|
|
kwargs['extra'] = {}
|
|
|
|
|
extra = kwargs['extra']
|
|
|
|
|
|
|
|
|
|
context = kwargs.pop('context', None)
|
|
|
|
|
if not context:
|
|
|
|
|
context = getattr(local.store, 'context', None)
|
|
|
|
|
if context:
|
|
|
|
|
extra.update(_dictify_context(context))
|
|
|
|
|
|
|
|
|
|
instance = kwargs.pop('instance', None)
|
|
|
|
|
instance_uuid = (extra.get('instance_uuid', None) or
|
|
|
|
|
kwargs.pop('instance_uuid', None))
|
|
|
|
|
instance_extra = ''
|
|
|
|
|
if instance:
|
|
|
|
|
instance_extra = CONF.instance_format % instance
|
|
|
|
|
elif instance_uuid:
|
|
|
|
|
instance_extra = (CONF.instance_uuid_format
|
|
|
|
|
% {'uuid': instance_uuid})
|
|
|
|
|
extra['instance'] = instance_extra
|
|
|
|
|
|
|
|
|
|
extra.setdefault('user_identity', kwargs.pop('user_identity', None))
|
|
|
|
|
|
|
|
|
|
extra['project'] = self.project
|
|
|
|
|
extra['version'] = self.version
|
|
|
|
|
extra['extra'] = extra.copy()
|
|
|
|
|
return msg, kwargs
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
class JSONFormatter(logging.Formatter):
|
|
|
|
|
def __init__(self, fmt=None, datefmt=None):
|
|
|
|
|
# NOTE(jkoelker) we ignore the fmt argument, but its still there
|
|
|
|
|
# since logging.config.fileConfig passes it.
|
|
|
|
|
self.datefmt = datefmt
|
|
|
|
|
|
|
|
|
|
def formatException(self, ei, strip_newlines=True):
|
|
|
|
|
lines = traceback.format_exception(*ei)
|
|
|
|
|
if strip_newlines:
|
|
|
|
|
lines = [moves.filter(
|
|
|
|
|
lambda x: x,
|
|
|
|
|
line.rstrip().splitlines()) for line in lines]
|
|
|
|
|
lines = list(itertools.chain(*lines))
|
|
|
|
|
return lines
|
|
|
|
|
|
|
|
|
|
def format(self, record):
|
|
|
|
|
message = {'message': record.getMessage(),
|
|
|
|
|
'asctime': self.formatTime(record, self.datefmt),
|
|
|
|
|
'name': record.name,
|
|
|
|
|
'msg': record.msg,
|
|
|
|
|
'args': record.args,
|
|
|
|
|
'levelname': record.levelname,
|
|
|
|
|
'levelno': record.levelno,
|
|
|
|
|
'pathname': record.pathname,
|
|
|
|
|
'filename': record.filename,
|
|
|
|
|
'module': record.module,
|
|
|
|
|
'lineno': record.lineno,
|
|
|
|
|
'funcname': record.funcName,
|
|
|
|
|
'created': record.created,
|
|
|
|
|
'msecs': record.msecs,
|
|
|
|
|
'relative_created': record.relativeCreated,
|
|
|
|
|
'thread': record.thread,
|
|
|
|
|
'thread_name': record.threadName,
|
|
|
|
|
'process_name': record.processName,
|
|
|
|
|
'process': record.process,
|
|
|
|
|
'traceback': None}
|
|
|
|
|
|
|
|
|
|
if hasattr(record, 'extra'):
|
|
|
|
|
message['extra'] = record.extra
|
|
|
|
|
|
|
|
|
|
if record.exc_info:
|
|
|
|
|
message['traceback'] = self.formatException(record.exc_info)
|
|
|
|
|
|
|
|
|
|
return jsonutils.dumps(message)
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
def _create_logging_excepthook(product_name):
|
|
|
|
|
def logging_excepthook(exc_type, value, tb):
|
|
|
|
|
extra = {}
|
|
|
|
|
if CONF.verbose or CONF.debug:
|
|
|
|
|
extra['exc_info'] = (exc_type, value, tb)
|
|
|
|
|
getLogger(product_name).critical(
|
|
|
|
|
"".join(traceback.format_exception_only(exc_type, value)),
|
|
|
|
|
**extra)
|
|
|
|
|
return logging_excepthook
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
class LogConfigError(Exception):
|
|
|
|
|
|
|
|
|
|
message = _('Error loading logging config %(log_config)s: %(err_msg)s')
|
|
|
|
|
|
|
|
|
|
def __init__(self, log_config, err_msg):
|
|
|
|
|
self.log_config = log_config
|
|
|
|
|
self.err_msg = err_msg
|
|
|
|
|
|
|
|
|
|
def __str__(self):
|
|
|
|
|
return self.message % dict(log_config=self.log_config,
|
|
|
|
|
err_msg=self.err_msg)
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
def _load_log_config(log_config_append):
|
|
|
|
|
try:
|
|
|
|
|
logging.config.fileConfig(log_config_append,
|
|
|
|
|
disable_existing_loggers=False)
|
|
|
|
|
except moves.configparser.Error as exc:
|
|
|
|
|
raise LogConfigError(log_config_append, str(exc))
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
def setup(product_name, version='unknown'):
|
|
|
|
|
"""Setup logging."""
|
|
|
|
|
if CONF.log_config_append:
|
|
|
|
|
_load_log_config(CONF.log_config_append)
|
|
|
|
|
else:
|
|
|
|
|
_setup_logging_from_conf(product_name, version)
|
|
|
|
|
sys.excepthook = _create_logging_excepthook(product_name)
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
def set_defaults(logging_context_format_string):
|
|
|
|
|
cfg.set_defaults(log_opts,
|
|
|
|
|
logging_context_format_string=
|
|
|
|
|
logging_context_format_string)
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
def _find_facility_from_conf():
|
|
|
|
|
facility_names = logging.handlers.SysLogHandler.facility_names
|
|
|
|
|
facility = getattr(logging.handlers.SysLogHandler,
|
|
|
|
|
CONF.syslog_log_facility,
|
|
|
|
|
None)
|
|
|
|
|
|
|
|
|
|
if facility is None and CONF.syslog_log_facility in facility_names:
|
|
|
|
|
facility = facility_names.get(CONF.syslog_log_facility)
|
|
|
|
|
|
|
|
|
|
if facility is None:
|
|
|
|
|
valid_facilities = facility_names.keys()
|
|
|
|
|
consts = ['LOG_AUTH', 'LOG_AUTHPRIV', 'LOG_CRON', 'LOG_DAEMON',
|
|
|
|
|
'LOG_FTP', 'LOG_KERN', 'LOG_LPR', 'LOG_MAIL', 'LOG_NEWS',
|
|
|
|
|
'LOG_AUTH', 'LOG_SYSLOG', 'LOG_USER', 'LOG_UUCP',
|
|
|
|
|
'LOG_LOCAL0', 'LOG_LOCAL1', 'LOG_LOCAL2', 'LOG_LOCAL3',
|
|
|
|
|
'LOG_LOCAL4', 'LOG_LOCAL5', 'LOG_LOCAL6', 'LOG_LOCAL7']
|
|
|
|
|
valid_facilities.extend(consts)
|
|
|
|
|
raise TypeError(_('syslog facility must be one of: %s') %
|
|
|
|
|
', '.join("'%s'" % fac
|
|
|
|
|
for fac in valid_facilities))
|
|
|
|
|
|
|
|
|
|
return facility
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
class RFCSysLogHandler(logging.handlers.SysLogHandler):
|
|
|
|
|
def __init__(self, *args, **kwargs):
|
|
|
|
|
self.binary_name = _get_binary_name()
|
|
|
|
|
super(RFCSysLogHandler, self).__init__(*args, **kwargs)
|
|
|
|
|
|
|
|
|
|
def format(self, record):
|
|
|
|
|
msg = super(RFCSysLogHandler, self).format(record)
|
|
|
|
|
msg = self.binary_name + ' ' + msg
|
|
|
|
|
return msg
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
def _setup_logging_from_conf(project, version):
|
|
|
|
|
log_root = getLogger(None).logger
|
|
|
|
|
for handler in log_root.handlers:
|
|
|
|
|
log_root.removeHandler(handler)
|
|
|
|
|
|
|
|
|
|
if CONF.use_syslog:
|
|
|
|
|
facility = _find_facility_from_conf()
|
|
|
|
|
# TODO(bogdando) use the format provided by RFCSysLogHandler
|
|
|
|
|
# after existing syslog format deprecation in J
|
|
|
|
|
if CONF.use_syslog_rfc_format:
|
|
|
|
|
syslog = RFCSysLogHandler(address='/dev/log',
|
|
|
|
|
facility=facility)
|
|
|
|
|
else:
|
|
|
|
|
syslog = logging.handlers.SysLogHandler(address='/dev/log',
|
|
|
|
|
facility=facility)
|
|
|
|
|
log_root.addHandler(syslog)
|
|
|
|
|
|
|
|
|
|
logpath = _get_log_file_path()
|
|
|
|
|
if logpath:
|
|
|
|
|
filelog = logging.handlers.WatchedFileHandler(logpath)
|
|
|
|
|
log_root.addHandler(filelog)
|
|
|
|
|
|
|
|
|
|
if CONF.use_stderr:
|
|
|
|
|
streamlog = ColorHandler()
|
|
|
|
|
log_root.addHandler(streamlog)
|
|
|
|
|
|
|
|
|
|
elif not logpath:
|
|
|
|
|
# pass sys.stdout as a positional argument
|
|
|
|
|
# python2.6 calls the argument strm, in 2.7 it's stream
|
|
|
|
|
streamlog = logging.StreamHandler(sys.stdout)
|
|
|
|
|
log_root.addHandler(streamlog)
|
|
|
|
|
|
|
|
|
|
if CONF.publish_errors:
|
|
|
|
|
handler = importutils.import_object(
|
|
|
|
|
"oslo.vmware.openstack.common.log_handler.PublishErrorsHandler",
|
|
|
|
|
logging.ERROR)
|
|
|
|
|
log_root.addHandler(handler)
|
|
|
|
|
|
|
|
|
|
datefmt = CONF.log_date_format
|
|
|
|
|
for handler in log_root.handlers:
|
|
|
|
|
# NOTE(alaski): CONF.log_format overrides everything currently. This
|
|
|
|
|
# should be deprecated in favor of context aware formatting.
|
|
|
|
|
if CONF.log_format:
|
|
|
|
|
handler.setFormatter(logging.Formatter(fmt=CONF.log_format,
|
|
|
|
|
datefmt=datefmt))
|
|
|
|
|
log_root.info('Deprecated: log_format is now deprecated and will '
|
|
|
|
|
'be removed in the next release')
|
|
|
|
|
else:
|
|
|
|
|
handler.setFormatter(ContextFormatter(project=project,
|
|
|
|
|
version=version,
|
|
|
|
|
datefmt=datefmt))
|
|
|
|
|
|
|
|
|
|
if CONF.debug:
|
|
|
|
|
log_root.setLevel(logging.DEBUG)
|
|
|
|
|
elif CONF.verbose:
|
|
|
|
|
log_root.setLevel(logging.INFO)
|
|
|
|
|
else:
|
|
|
|
|
log_root.setLevel(logging.WARNING)
|
|
|
|
|
|
|
|
|
|
for pair in CONF.default_log_levels:
|
|
|
|
|
mod, _sep, level_name = pair.partition('=')
|
|
|
|
|
level = logging.getLevelName(level_name)
|
|
|
|
|
logger = logging.getLogger(mod)
|
|
|
|
|
logger.setLevel(level)
|
|
|
|
|
|
|
|
|
|
_loggers = {}
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
def getLogger(name='unknown', version='unknown'):
|
|
|
|
|
if name not in _loggers:
|
|
|
|
|
_loggers[name] = ContextAdapter(logging.getLogger(name),
|
|
|
|
|
name,
|
|
|
|
|
version)
|
|
|
|
|
return _loggers[name]
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
def getLazyLogger(name='unknown', version='unknown'):
|
|
|
|
|
"""Returns lazy logger.
|
|
|
|
|
|
|
|
|
|
Creates a pass-through logger that does not create the real logger
|
|
|
|
|
until it is really needed and delegates all calls to the real logger
|
|
|
|
|
once it is created.
|
|
|
|
|
"""
|
|
|
|
|
return LazyAdapter(name, version)
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
class WritableLogger(object):
|
|
|
|
|
"""A thin wrapper that responds to `write` and logs."""
|
|
|
|
|
|
|
|
|
|
def __init__(self, logger, level=logging.INFO):
|
|
|
|
|
self.logger = logger
|
|
|
|
|
self.level = level
|
|
|
|
|
|
|
|
|
|
def write(self, msg):
|
|
|
|
|
self.logger.log(self.level, msg.rstrip())
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
class ContextFormatter(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
|
|
|
|
|
|
|
|
|
|
If available, uses the context value stored in TLS - local.store.context
|
|
|
|
|
|
|
|
|
|
"""
|
|
|
|
|
|
|
|
|
|
def __init__(self, *args, **kwargs):
|
|
|
|
|
"""Initialize ContextFormatter instance
|
|
|
|
|
|
|
|
|
|
Takes additional keyword arguments which can be used in the message
|
|
|
|
|
format string.
|
|
|
|
|
|
|
|
|
|
:keyword project: project name
|
|
|
|
|
:type project: string
|
|
|
|
|
:keyword version: project version
|
|
|
|
|
:type version: string
|
|
|
|
|
|
|
|
|
|
"""
|
|
|
|
|
|
|
|
|
|
self.project = kwargs.pop('project', 'unknown')
|
|
|
|
|
self.version = kwargs.pop('version', 'unknown')
|
|
|
|
|
|
|
|
|
|
logging.Formatter.__init__(self, *args, **kwargs)
|
|
|
|
|
|
|
|
|
|
def format(self, record):
|
|
|
|
|
"""Uses contextstring if request_id is set, otherwise default."""
|
|
|
|
|
|
|
|
|
|
# store project info
|
|
|
|
|
record.project = self.project
|
|
|
|
|
record.version = self.version
|
|
|
|
|
|
|
|
|
|
# store request info
|
|
|
|
|
context = getattr(local.store, 'context', None)
|
|
|
|
|
if context:
|
|
|
|
|
d = _dictify_context(context)
|
|
|
|
|
for k, v in d.items():
|
|
|
|
|
setattr(record, k, v)
|
|
|
|
|
|
|
|
|
|
# NOTE(sdague): default the fancier formatting params
|
|
|
|
|
# to an empty string so we don't throw an exception if
|
|
|
|
|
# they get used
|
|
|
|
|
for key in ('instance', 'color'):
|
|
|
|
|
if key not in record.__dict__:
|
|
|
|
|
record.__dict__[key] = ''
|
|
|
|
|
|
|
|
|
|
if record.__dict__.get('request_id', None):
|
|
|
|
|
self._fmt = CONF.logging_context_format_string
|
|
|
|
|
else:
|
|
|
|
|
self._fmt = CONF.logging_default_format_string
|
|
|
|
|
|
|
|
|
|
if (record.levelno == logging.DEBUG and
|
|
|
|
|
CONF.logging_debug_format_suffix):
|
|
|
|
|
self._fmt += " " + CONF.logging_debug_format_suffix
|
|
|
|
|
|
|
|
|
|
# Cache this on the record, Logger will respect our formatted copy
|
|
|
|
|
if record.exc_info:
|
|
|
|
|
record.exc_text = self.formatException(record.exc_info, record)
|
|
|
|
|
return logging.Formatter.format(self, record)
|
|
|
|
|
|
|
|
|
|
def formatException(self, exc_info, record=None):
|
|
|
|
|
"""Format exception output with CONF.logging_exception_prefix."""
|
|
|
|
|
if not record:
|
|
|
|
|
return logging.Formatter.formatException(self, exc_info)
|
|
|
|
|
|
|
|
|
|
stringbuffer = moves.StringIO()
|
|
|
|
|
traceback.print_exception(exc_info[0], exc_info[1], exc_info[2],
|
|
|
|
|
None, stringbuffer)
|
|
|
|
|
lines = stringbuffer.getvalue().split('\n')
|
|
|
|
|
stringbuffer.close()
|
|
|
|
|
|
|
|
|
|
if CONF.logging_exception_prefix.find('%(asctime)') != -1:
|
|
|
|
|
record.asctime = self.formatTime(record, self.datefmt)
|
|
|
|
|
|
|
|
|
|
formatted_lines = []
|
|
|
|
|
for line in lines:
|
|
|
|
|
pl = CONF.logging_exception_prefix % record.__dict__
|
|
|
|
|
fl = '%s%s' % (pl, line)
|
|
|
|
|
formatted_lines.append(fl)
|
|
|
|
|
return '\n'.join(formatted_lines)
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
class ColorHandler(logging.StreamHandler):
|
|
|
|
|
LEVEL_COLORS = {
|
|
|
|
|
logging.DEBUG: '\033[00;32m', # GREEN
|
|
|
|
|
logging.INFO: '\033[00;36m', # CYAN
|
|
|
|
|
logging.AUDIT: '\033[01;36m', # BOLD CYAN
|
|
|
|
|
logging.WARN: '\033[01;33m', # BOLD YELLOW
|
|
|
|
|
logging.ERROR: '\033[01;31m', # BOLD RED
|
|
|
|
|
logging.CRITICAL: '\033[01;31m', # BOLD RED
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
def format(self, record):
|
|
|
|
|
record.color = self.LEVEL_COLORS[record.levelno]
|
|
|
|
|
return logging.StreamHandler.format(self, record)
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
class DeprecatedConfig(Exception):
|
|
|
|
|
message = _("Fatal call to deprecated config: %(msg)s")
|
|
|
|
|
|
|
|
|
|
def __init__(self, msg):
|
|
|
|
|
super(Exception, self).__init__(self.message % dict(msg=msg))
|