光谱-python 0.9.8

概述

Spectrum 是一个帮助开发者筛选和检查本地开发或调试过程中的日志的应用程序。它通过 REST API、syslog 或设置为跟踪本地文件来接受记录信息。所有这些记录源都可以根据开发者的当前需求轻松显示或隐藏。

此 Python 包使得将 Python 和/或 Django 的记录推送到 Spectrum 变得非常简单。

Python

为 Spectrum 安装 Python 支持与以下步骤一样简单

$ pip install spectrum-python

设置记录处理程序也非常简单

import logging
from spectrum.handlers import Spectrum

logger = logging.getLogger(__name__)
logger.setLevel(logging.DEBUG)

spectrum = Spectrum('my-logging-sublevel')
logger.addHandler(spectrum)

for i in range(5):
    logger.info("This would be sent as INFO.my-logging-sublevel")
    logger.warn("This would be sent as WARNING.my-logging-sublevel")
    logger.debug("This would be sent as DEBUG.my-logging-sublevel")

Django

要将您的 Django 项目的所有记录定向到 Spectrum，您可以在设置中使用预定义的 FIRE_HOSE 记录配置

# settings.py

from spectrum.django import FIRE_HOSE
LOGGING = FIRE_HOSE

如果您使用 celery，则需要添加一个额外的设置

CELERYD_HIJACK_ROOT_LOGGER = False

您还可以使用 fire_hose 便利方法快速修改任何预构建的记录配置字典

from spectrum.django import fire_hose


LOGGING = fire_hose()

LOGGING = fire_hose(log_db=False)

LOGGING = fire_hose(levels=(
    ('my.overly.verbose.module', 'WARNING'),
    ('some.other.module', 'CRITICAL'),
)

LOGGING = fire_hose(handler_kwargs={'url': '127.0.0.1:12345'})

如果您更喜欢更细粒度的方法，您可以为特定的处理程序进行配置

# settings.py

LOGGING = {
    ...
    'filters': {
        'request_id': {
            '()': 'spectrum.filters.RequestIdFilter'
        }
    },
    'handlers': {
        'myloggername': {
            'level': 'DEBUG',
            'class': 'spectrum.handlers.RestSpectrum',
            'sublevel': 'myloggername',
            'filters': ['request_id']
        }
    }
}

确保您包括 request_id 过滤器以过滤掉光谱自身的请求与其他请求。否则，Python 将记录光谱的请求，而这些日志又会生成自己的光谱请求，导致无限递归。