Python日志配置统一管理方案：使用配置文件实现多脚本日志隔离与轮转

慢慢来

发布时间：2026-10-14| 4人浏览过

原创

本文介绍如何通过统一的配置文件管理Python脚本的日志输出，避免在每个脚本中重复配置。通过示例展示了如何配置不同脚本的日志路径、控制台输出及按时间切割日志，实现日志管理的集中化与维护便捷性。

在Python脚本开发中，采用配置文件形式管理日志输出是一种高效做法，无需在每个独立脚本内部硬编码日志配置。

需求简述：

假设需要编写两个脚本a.py和b.py，要求a.py的日志输出至/var/log/a.log，b.py的日志输出至/var/log/b.log，且日志需按日期进行切割。若在每个脚本中单独配置日志，不仅耗时，还增加后期维护难度。

为解决上述问题，采用配置文件格式统一管理Python脚本的日志输出。所有后续Python脚本的日志配置均集中于此文件，脚本通过读取该配置实现日志功能，从而提升可维护性与代码可读性。

需求实现：

配置文件路径及内容如下：


vim /data/yw/conf/logconf.conf 
 
[loggers]
keys=root,alog,blog
[handlers]
keys=handdef,handalog,handblog
 
[formatters]
keys=formatdef
###############################################
[logger_root]
level=DEBUG
handlers=handdef
 
[logger_alog]
level=DEBUG
# 如果同时使用handalog,handdef ，那么在执行a.py脚本的时候日志即输出到控制台，也输出到日志文件
handlers=handalog,handdef
qualname=alog
propagate=0
 
[logger_blog]
#b.py 的日志我不让他输出到控制台，所以不用handdef 这个hands去处理日志
level=DEBUG
handlers=handblog
qualname=blog
propagate=0
 
###############################################
[handler_handdef]
# 输出到控制台
class=StreamHandler
level=INFO
formatter=formatdef
args=(sys.stderr,)
 
 
[handler_handalog]
# a.py 日志我按时间切割
# handlers.TimedRotatingFileHandler：使用时间格式切割日志，midnight为凌晨切割  
# 如果配置按时#间切割的话可以这样：class=FileHandler，然后写个脚本定时去切割。
class=handlers.TimedRotatingFileHandler
level=DEBUG
formatter=formatdef
args=('/var/log/a.log', 'midnight')
#args=('/var/log/a.log', 'a') 不使用时间切割可以这样配置args
#另一种写法：面三个参数含义: D 按天切割 1 每天只切割一个文件 5 保留5个日志文件
#args=('/data/ywlog/cron/cron_dbbackup.log', 'D', 1, 5)
 
[handler_handblog]
# b.py 日志我不进行切割
class=FileHandler
level=DEBUG
formatter=formatdef
args=('/var/log/b.log', 'a') 
###############################################
[formatter_formatdef]
format='%(asctime)s %(filename)s[line:%(lineno)d] %(levelname)s %(message)s'
datefmt='%a, %d %b %Y %H:%M:%S'

脚本引用配置文件的方式：

vi a.py


#!/usr/bin/python
# coding=utf-8
import logging, logging.config
reload(sys)
sys.setdefaultencoding('utf8')
 
logging.config.fileConfig("/data/yw/conf/logconf.conf")
logger = logging.getLogger('alog') #alog 为logconf.conf loggers 配置的关键字
# 日志输出
logger.info("aaaa 正确日志")
logger.error("aaaa 错误日志")

vi b.py


#!/usr/bin/python
# coding=utf-8
import logging, logging.config
reload(sys)
sys.setdefaultencoding('utf8')
 
logging.config.fileConfig("/data/yw/conf/logconf.conf")
logger = logging.getLogger('blog') #blog 为logconf.conf loggers 配置的关键字
# 日志输出
logger.info("bbbb 正确日志")
logger.error("bbbb 错误日志")

测试结果：

执行a.py时，日志同时输出至控制台和日志文件；而执行b.py时，日志仅输出至日志文件。此行为与配置文件中的注释说明一致。

未来若需添加c.py、d.py等新脚本，只需按相同格式在配置文件中新增对应日志配置即可，无需修改脚本内部代码。

本文介绍了Python日志输出使用配置文件格式的方法，更多相关Python日志内容可参考本站往期文章或继续浏览后续内容，感谢支持。