Python日志记录器logging百科全书之日志回滚

Python 日志记录器logging 百科全书 之 日志回滚 前言

在之前的文章中，我们学习了关于Python日志记录的基础配置。

本文将深入探讨Python中的日志回滚机制，这是一种高效管理日志文件的方法，特别适用于长时间运行或高流量的应用。

知识点📖📖 模块释义loggingPython 的日志记录工具，标准库RotatingFileHandler基于文件大小进行日志回滚的处理器。TimedRotatingFileHandler基于时间间隔进行日志回滚的处理器。

导入模块

import logging from logging.handlers import (RotatingFileHandler, TimedRotatingFileHandler)

---

文章脉络：

点击直达：万字长文 - Python 日志记录器logging 百科全书 之 基础配置点击直达：Python 日志记录器logging 百科全书 之 日志回滚

---

日志回滚

在Python中，日志回滚通常通过logging.handlers模块中的RotatingFileHandler或TimedRotatingFileHandler实现。

RotatingFileHandler: 当日志文件达到指定大小时，自动“回滚”日志文件，即创建一个新的日志文件，并将旧文件保留为备份。RotatingFileHandler: 根据时间间隔回滚日志文件，可以是每秒、每分钟、每小时或每天等。 概念

通过灵活地使用Logger和多个Handler，可以构建一个强大而灵活的日志系统，它可以同时满足日志记录的多样化需求，如日志的级别、格式、输出目的地等，从而为应用程序的监控和故障排查提供强有力的支持。

Logger（日志记录器）

Logger是日志系统的入口。应用程序通过Logger实例来记录日志。功能：Logger负责捕获日志消息并将它们分发给所有附加的Handler。日志级别：Logger可以设置日志级别，以决定要处理哪些级别的日志消息。

Handler（日志处理器）

Handler负责将日志消息发送到指定的目的地，这个目的地可以是文件、控制台、网络等。类型：包括但不限于StreamHandler（控制台输出）、FileHandler（写入文件）、RotatingFileHandler（基于文件大小回滚的文件写入）、TimedRotatingFileHandler（基于时间间隔回滚的文件写入）等。独立配置：每个Handler可以有自己的日志级别和格式设置（通过Formatter）。这允许不同的Handler以不同的方式处理相同的日志消息。

多处理器配置

灵活性：一个Logger可以附加多个Handler，每个Handler可以独立配置，增加了日志系统的灵活性和可定制性。举例：例如配置一个Logger，使其同时将日志消息输出到控制台（使用StreamHandler）和文件（使用FileHandler或RotatingFileHandler）。级别和格式的多样性：不同的Handler可以设置不同的日志级别和格式。例如对于调试目的，在控制台上输出所有级别的日志，而在文件中只记录警告或更高级别的日志。

---

步骤

值得注意的是，这里的设置日志级别和日志格式，与前文的basicConfig是不一样滴~，细看下文！！！

设置日志回滚的步骤如下：

创建日志记录器（Logger）：实例化一个日志记录器，为日志消息提供一个捕获和分发的入口点；创建日志格式（Formatter）：创建一个Formatter对象，指定日志消息的格式；实例化日志处理器（Handler）：根据需要选择适当的处理器，例如FileHandler、RotatingFileHandler等；添加处理器（Handler）到记录器（Logger）：最后，将这些处理器添加到日志记录器（Logger）；记录日志：使用配置好的日志记录器来记录消息（可选）清理旧日志文件

---

1. 创建日志记录器（Logger） 实例化一个日志记录器，为日志消息提供一个捕获和分发的入口点。命名可随意，如不传入，默认返回 root logger logger = logging.getLogger(name="my_application_logger") logger.setLevel(logging.INFO) 2. 创建日志格式（Formatter） 创建一个Formatter对象，定义日志消息的输出格式。这可以包括时间戳、日志级别、消息等。 formatter = logging.Formatter('%(asctime)s - %(name)s - %(levelname)s - %(message)s') 3. 实例化日志处理器（Handler）

根据需要选择适当的处理器，

对于基于文件大小的回滚：

创建一个RotatingFileHandler，设置最大文件大小和备份文件数量。 rotating_handler = RotatingFileHandler("my_log.log", maxBytes=1024*1024, backupCount=5) rotating_handler.setFormatter(formatter)

对于基于时间的回滚：

创建一个TimedRotatingFileHandler，设置回滚时间（如午夜）、间隔和备份文件数量。 timed_handler = TimedRotatingFileHandler("my_log.log", when="midnight", interval=1, backupCount=7) timed_handler.setFormatter(formatter) 4. 添加处理器（Handler）到记录器（Logger） 将配置好的处理器添加到日志记录器。这使得日志消息可以按照处理器的配置被处理和输出。同时添加多个日志处理器 也没任何问题~ logger.addHandler(rotating_handler) logger.addHandler(timed_handler) 5. 记录日志 使用配置好的日志记录器来记录消息。根据记录器和处理器的配置，日志消息将按照指定的方式被处理和存储。 logger.info("This is a test log message.") 6. (可选) 清理旧日志文件 定期清理旧的日志文件是维护日志系统的一部分。可以编写脚本或使用工具来自动删除过时的日志文件，以释放磁盘空间。 import os import glob import time log_dir = '/logs' # 查找目录中所有扩展名为.log的文件 log_files = glob.glob(os.path.join(log_dir, '*.log')) for log_file in log_files: # 检查文件的最后修改日期 # 判断文件的最后修改时间是否早于当前时间7天（7 * 24 * 3600秒） if os.path.getmtime(log_file) < (time.time() - 7 * 24 * 3600): os.remove(log_file)

---

RotatingFileHandler

RotatingFileHandler是用于基于文件大小的日志回滚。当日志文件达到指定大小时，它会自动 回滚 日志文件。

主要参数：

filename：日志文件的名称。mode：文件的打开模式。默认是 'a'，表示追加模式。其他常见模式包括 'w'（写模式，每次启动时覆盖文件）。maxBytes：日志文件的最大字节数。当文件大小超过这个值时，会创建一个新文件。如app.log.1, app.log.2 …backupCount：保留的备份文件数量。比如，如果设置为5，则除了原始日志文件外，还会有5个备份文件。encoding（可选）：文件的编码方式，同basicConfig。delay（可选）：如果设置为True，则直到第一次调用emit()方法时才会创建文件。即直到日志系统实际写入消息时才创建文件，避免创建空日志文件errors：指定如何处理编码错误，同basicConfig。

示例代码

import logging from logging.handlers import RotatingFileHandler # 创建日志记录器，设置日志级别为INFO logger = logging.getLogger("my_app_logger") logger.setLevel(logging.INFO) # 创建 RotatingFileHandler # 设置文件最大大小为1MB，最多保留3个备份 handler = RotatingFileHandler("./logs/app.log", maxBytes=1024*1024, backupCount=3) handler.setLevel(logging.INFO) # 创建日志格式并设置给处理器 formatter = logging.Formatter('%(asctime)s - %(name)s - %(levelname)s - %(message)s') handler.setFormatter(formatter) # 将处理器添加到日志记录器 logger.addHandler(handler) # 记录一些示例日志 for i in range(1000): logger.info(f"This is log message {i}") TimedRotatingFileHandler

TimedRotatingFileHandler用于基于时间的日志回滚。根据指定的时间间隔回滚日志文件。

主要参数：

filename：日志文件的名称。when：时间间隔的类型。常见值有'S'（秒），'M'（分钟），'H'（小时），'D'（天），'W0'-'W6'（周一至周日），'midnight'（每天午夜）。interval：回滚之间的时间间隔。与when参数一起使用。例如，when='H'和interval=6表示每6小时回滚一次日志文件。backupCount：保留的备份文件数量。比如，如果设置为5，则除了原始日志文件外，还会有5个备份文件。encoding（可选）：文件的编码方式，同basicConfig。delay（可选）：如果设置为True，则直到第一次调用emit()方法时才会创建文件。即直到日志系统实际写入消息时才创建文件，避免创建空日志文件utc：如果设置为True，则时间间隔的计算基于UTC时间。默认为False，基于本地时间。atTime（可选）：如果when设置为'midnight'，这个参数可以用来指定回滚发生的具体时间。errors：指定如何处理编码错误，同basicConfig。

示例代码

import logging from logging.handlers import TimedRotatingFileHandler # 创建日志记录器，设置日志级别为INFO logger = logging.getLogger("my_app_logger") logger.setLevel(logging.INFO) # 创建 TimedRotatingFileHandler # 设置每天午夜回滚一次日志，保留最多7个备份 handler = TimedRotatingFileHandler("./logs/app.log", when="midnight", interval=1, backupCount=7) handler.setLevel(logging.INFO) # 创建日志格式并设置给处理器 formatter = logging.Formatter('%(asctime)s - %(name)s - %(levelname)s - %(message)s') handler.setFormatter(formatter) # 将处理器添加到日志记录器 logger.addHandler(handler) # 记录一些示例日志 for i in range(1000): logger.info(f"This is log message {i}")

---

应用场景 日志处理器应用场景优势RotatingFileHandler- 日志活动频繁但数据量可预测的环境- 控制日志文件大小，避免单个文件过大- 防止日志文件过大，便于文件传输和查看- 适合稳定的日志输出环境TimedRotatingFileHandler- 需要按时间周期归档日志的情况- 定期审查或归档日志，如审计和系统监控- 根据时间自动组织日志文件- 便于日志的定期查找和分析 总结🐓🐓

本文详细探讨了Python中的日志回滚机制，包括RotatingFileHandler和TimedRotatingFileHandler两种关键的日志处理器。这些处理器不仅增强了日志系统的灵活性，还大大简化了日志管理，特别适用于长时间运行或高流量的应用。

日志回滚是一种高效的日志管理技术，能够自动控制日志文件的大小和生命周期。通过正确使用RotatingFileHandler和TimedRotatingFileHandler，我们可以为应用程序提供稳定、可靠的日志记录机制，保障应用程序的健康运行。

后话

本次分享到此结束，

see you~🐱‍🏍🐱‍🏍