Python中LOGGING模块的高级配置：日志轮转和归档
在Python中，logging模块提供了一个非常强大和灵活的日志记录功能，可以用于记录应用程序的运行情况和调试信息。通过logging模块，我们可以配置不同级别的日志、输出到不同的目标、并实现日志的轮转和归档。
本文将介绍如何使用logging模块进行日志轮转和归档，并提供了一个使用示例。
## 安装和导入logging模块
首先要确保你的Python环境中已经安装了logging模块，通常Python自带的标准库中就已经包含了logging模块，所以不需要额外安装。
导入logging模块：
import logging
## 配置日志轮转
日志轮转是指当日志文件达到一定大小或保存的时间超过一定时限时，会自动删除最旧的日志文件，以便保留最新的日志数据。logging模块中提供了许多用于配置日志轮转的函数和类。
### 使用RotatingFileHandler类
RotatingFileHandler类可以用于按文件大小轮转日志文件。
首先，需要创建一个RotatingFileHandler对象，并设置相关参数：
from logging.handlers import RotatingFileHandler log_filename = 'myapp.log' max_file_size = 10 * 1024 * 1024 # 10MB rotating_handler = RotatingFileHandler(filename=log_filename, maxBytes=max_file_size, backupCount=5)
- filename：表示日志文件的名称。如果文件不存在，将会被创建。
- maxBytes：表示单个日志文件的最大大小。当文件大小达到该值时，将会创建一个新的日志文件。
- backupCount：表示最多保留的日志文件数量。当创建新的日志文件超过该数量时，最旧的日志文件将会被删除。
然后，可以设置日志记录器的其他参数，例如日志级别、日志格式等：
rotating_handler.setLevel(logging.INFO)
formatter = logging.Formatter('%(asctime)s %(levelname)s: %(message)s')
rotating_handler.setFormatter(formatter)
最后，将RotatingFileHandler对象添加到日志记录器中：
logger = logging.getLogger('myapp')
logger.addHandler(rotating_handler)
### 使用TimedRotatingFileHandler类
TimedRotatingFileHandler类可以用于按时间轮转日志文件，并设置归档间隔。
首先，需要创建一个TimedRotatingFileHandler对象，并设置相关参数：
from logging.handlers import TimedRotatingFileHandler
log_filename = 'myapp.log'
when = 'midnight' # 每天凌晨创建一个新的日志文件
interval = 1 # 每天轮转
backup_count = 5 # 最多保留5个日志文件
timed_rotating_handler = TimedRotatingFileHandler(filename=log_filename, when=when, interval=interval,
backupCount=backup_count)
- filename：表示日志文件的名称。如果文件不存在，将会被创建。
- when：表示归档间隔。可以为以下值：midnight（每天凌晨）、W0~W6（每周一到周日凌晨）、M1~M12（每月的1号到12号凌晨）。
- interval：表示归档间隔的数量。配合when使用，例如interval=1表示每天轮转、interval=7表示每周轮转。
- backupCount：表示最多保留的日志文件数量。当创建新的归档文件超过该数量时，最旧的归档文件将会被删除。
然后，可以设置日志记录器的其他参数，例如日志级别、日志格式等：
timed_rotating_handler.setLevel(logging.INFO)
formatter = logging.Formatter('%(asctime)s %(levelname)s: %(message)s')
timed_rotating_handler.setFormatter(formatter)
最后，将TimedRotatingFileHandler对象添加到日志记录器中：
logger = logging.getLogger('myapp')
logger.addHandler(timed_rotating_handler)
## 配置归档日志
除了日志轮转，logging模块还提供了归档日志功能，可以将日志文件归档到指定的文件夹中。
### 使用FileHandler类
FileHandler类可以用于将日志文件归档到指定的文件夹中。
首先，需要创建一个FileHandler对象，并设置相关参数：
from logging.handlers import FileHandler log_filename = 'myapp.log' archive_folder = '/path/to/archive/folder' archive_handler = FileHandler(filename=log_filename) archive_handler.baseFilename = os.path.join(archive_folder, os.path.basename(log_filename))
- filename：表示日志文件的名称。
- baseFilename：表示归档后的日志文件路径。
然后，可以设置日志记录器的其他参数，例如日志级别、日志格式等：
archive_handler.setLevel(logging.INFO)
formatter = logging.Formatter('%(asctime)s %(levelname)s: %(message)s')
archive_handler.setFormatter(formatter)
最后，将FileHandler对象添加到日志记录器中：
logger = logging.getLogger('myapp')
logger.addHandler(archive_handler)
## 示例
下面是一个使用RotatingFileHandler和TimedRotatingFileHandler进行日志轮转的示例：
import logging
from logging.handlers import RotatingFileHandler, TimedRotatingFileHandler
# 创建RotatingFileHandler对象
rotating_handler = RotatingFileHandler(filename='myapp.log', maxBytes=10 * 1024 * 1024, backupCount=5)
rotating_handler.setLevel(logging.INFO)
formatter = logging.Formatter('%(asctime)s %(levelname)s: %(message)s')
rotating_handler.setFormatter(formatter)
# 创建TimedRotatingFileHandler对象
timed_rotating_handler = TimedRotatingFileHandler(filename='myapp.log', when='midnight', interval=1, backupCount=5)
timed_rotating_handler.setLevel(logging.INFO)
timed_rotating_handler.setFormatter(formatter)
# 创建日志记录器并添加处理器
logger = logging.getLogger('myapp')
logger.addHandler(rotating_handler)
logger.addHandler(timed_rotating_handler)
# 写入日志
logger.info('This is a logging message.')
上述示例中，日志记录器被配置为同时使用RotatingFileHandler和TimedRotatingFileHandler两种日志轮转方式，这意味着当日志文件大小超过10MB或每天凌晨时，会创建一个新的日志文件，并且最多保留5个日志文件。
总结：本文介绍了如何在Python中使用logging模块进行日志轮转和归档的高级配置。通过RotatingFileHandler和TimedRotatingFileHandler两种类，我们可以按文件大小或时间来轮转日志文件，并将日志文件归档到指定的文件夹中。希望本文的内容对你有所帮助！