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

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

本文介绍如何使用 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 相关产品和应用

全部下载
Selenium

Selenium

4.51.0 · Windows

用于浏览器自动化和 Web 测试的 Python 工具。

scikit-learn

scikit-learn

1.9.1 · Windows

常用 Python 机器学习算法与模型评估工具库。

Black

Black

26.10.1 · Windows

强调一致性的 Python 自动代码格式化工具。

Ruff

Ruff

0.17.1 · macOS

由 Rust 编写的高速 Python 代码检查和格式化工具。

pytest

pytest

9.1.1 · Windows

简洁而强大的 Python 自动化测试框架。

FastAPI

FastAPI

0.146.0 · Windows

高性能 Python API 框架,支持类型提示和自动接口文档。

Flask

Flask

3.1.3 · Windows

轻量灵活的 Python Web 应用框架。

Django

Django

6.1.2 · Windows

成熟的 Python Web 框架,适合构建内容站点和业务系统。

Spyder

Spyder

6.1.7 · Windows

面向科学计算与数据分析的 Python 集成开发环境。

SciPy

SciPy

1.18.1 · Windows

面向科学、工程和技术计算的 Python 算法库。