Python 日志管理最佳实践:使用 logbook 实现文件与控制台输出
本文介绍如何使用 Python 的 logbook 库进行标准化的日志管理。通过配置 logbook.more.ColorizedStderrHandler 实现控制台彩色输出,并结合 TimedRotatingFileHandler 实现按日期自动轮转的文件日志记录。示例代码展示了如何封装 get_logger 函数以简化调用,并包含邮件发送逻辑,适用于需要同时监控本地日志和远程告警的应用场景。
首先,将日志配置代码保存至 logger.py 文件中。该文件定义了日志目录 LOG_DIR,默认为当前路径下的 log 文件夹,若不存在则自动创建。核心函数 get_logger 用于初始化日志记录器,默认名称为 'test'。通过 logbook.set_datetime_format('local') 设置本地时间格式。使用 ColorizedStderrHandler 处理控制台输出,并通过 push_application() 将其加入应用栈。若启用 file_log 参数,则额外添加 TimedRotatingFileHandler,按 '%Y%m%d' 格式生成以日志名称命名的 .log 文件,并设置 bubble=True 以便日志向上传递。最后返回 logbook.Logger 实例。
import os
import logbook
from logbook.more import ColorizedStderrHandler
import smtplib
LOG_DIR = os.path.join('log')
if not os.path.exists(LOG_DIR):
os.makedirs(LOG_DIR)
def get_logger(name='test', file_log=False):
logbook.set_datetime_format('local')
ColorizedStderrHandler(bubble=False).push_application()
if file_log:
logbook.TimedRotatingFileHandler(os.path.join(LOG_DIR, '%s.log' % name), date_format='%Y%m%d', bubble=True).push_application()
return logbook.Logger(name)
LOG = get_logger(file_log=True)
def send_email(email_conf, message):
smtp = smtplib.SMTP()
smtp.connect(email_conf['host'], email_conf['port'])
smtp.login(email_conf['user'], email_conf['password'])
smtp.sendmail(email_conf['fromaddr'], email_conf['recipients'], message.as_string())
在实际业务代码中引入日志模块。通过 from logger import LOG 导入已配置好的日志记录器。在 __main__ 判断块中,调用 LOG.info 方法记录信息。例如,在检查特定日期 date 和数据类型 data_type 时,使用字符串格式化输出 'Checking %s:%s ...' 的日志信息,确保关键操作被准确记录。
from logger import LOG
if __name__ == "__main__":
LOG.info('Checking %s:%s ...' % (str(date), str(data_type)))
上述内容详细阐述了基于 Python logbook 库的正确日志配置与使用方式。希望该方案能为开发者提供可靠的日志管理参考,欢迎进一步测试与优化,并支持相关技术分享平台。
免责声明:本文内容仅供参考,不代表本站观点。转载或引用请注明出处。









