Python 日志管理最佳实践:使用 logbook 实现文件与控制台输出

慢慢来
慢慢来
发布时间:2026-10-13 | 6人浏览过
原创

本文介绍如何使用 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 库的正确日志配置与使用方式。希望该方案能为开发者提供可靠的日志管理参考,欢迎进一步测试与优化,并支持相关技术分享平台。

相关标签:

本站声明

本文内容仅供参考,不代表本站观点。转载或引用请注明出处。如发现内容问题,请通过联系我们页面反馈。

Python 相关产品和应用

全部下载

专题列表