Python logging日志库空间不足问题解决

星野

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

原创

针对Python项目中因未配置日志自动滚动导致的磁盘空间告警问题，本文介绍了使用logging.handlers.TimedRotatingFileHandler进行日志轮转的配置方法。通过详解when、interval和backupCount三个关键参数，结合代码示例展示了如何限制日志保留数量并随时间自动清理，从而有效解决磁盘空间占用过高的问题。

日志空间不足问题背景

项目中使用的日志库是基于Python官方logging模块封装的，但一直未配置日志自动滚动功能，导致经常收到磁盘空间已满的告警，需要人工清理。为此，我们深入研究并解决了这一问题。

参考文档：https://docs.python.org/2/library/logging.handlers.html

TimedRotatingFileHandler参数详解

TimedRotatingFileHandler的关键参数有三个。

when、interval、backupCount

when用于指定滚动的时间单位，可选值包括天、小时、分钟、秒等；interval指定经过多少个when单位后执行一次日志滚动；backupCount则用于设定最多保留的日志文件数量。

结合这三个参数，即可实现日志随时间自动滚动，并限制日志文件的总数量。

代码示例与结果验证

示例代码：


#!/usr/bin/env python
# -*- coding: utf-8 -*-

import sys
import os
import time
import logging
import logging.handlers

if __name__ == '__main__':
  if len(sys.argv) != 2:
    print('Usage:%s log_name' % (sys.argv[0]))
    sys.exit(0)

  log_dir = './log'
  log_name = sys.argv[1]
  logger = logging.getLogger(log_name)
  logger.setLevel(logging.DEBUG)

  # init handler
  formatter = logging.Formatter('%(message)s')
  file_time_handler = logging.handlers.TimedRotatingFileHandler(
      os.path.join(log_dir, log_name), "M", 1, 5)
  file_time_handler.setFormatter(formatter)
  file_time_handler.setLevel(logging.DEBUG)
  logger.addHandler(file_time_handler)

  while True:
    time.sleep(1)
    logger.info('Hello world %s' % (time.strftime("%Y/%M/%d-%H:%m:%S")))

运行结果：