class RotatingFileHandler( filename[, mode[, maxBytes[, backupCount]]])
返回RotatingFileHandler
类的一个新实例。指定的文件将被打开并用作日志记录的流。如果未指定模式,则使用a
。默认情况下,文件会无限增长。
RotatingFileHandler
允许我们在当前日志文件达到一定大小时将日志语句旋转到新文件中。
在此示例中,当它达到500字节时,我们将将其旋转到一个新文件中,最多备份2个文件。
import logging
import logging.handlers as handlers
import time
logger = logging.getLogger('my_app')
logger.setLevel(logging.INFO)
logHandler = handlers.RotatingFileHandler('app.log', maxBytes=500, backupCount=2)
logHandler.setLevel(logging.INFO)
logger.addHandler(logHandler)
def main():
while True:
time.sleep(1)
logger.info("A Sample Log Statement")
main()
执行此操作后,您应该注意到每当
app.log
超过500个字节时,它将被关闭并重命名为
app.log.x
,其中
x
的值递增,直到达到我们设置的
backupCount
为止。
class TimedRotatingFileHandler( filename [,when [,interval [,backupCount]]])
返回
TimedRotatingFileHandler
类的新实例。指定的文件被打开并用作记录的流。在旋转时,它还设置文件名后缀。旋转基于when和interval的乘积而发生。
您可以使用when指定间隔类型。可能的值列表如下,注意它们不区分大小写:
| Value | Type of interval |
|:--------:|:---------------------:|
| S | Seconds |
| M | Minutes |
| H | Hours |
| D | Days |
| W | Week day (0=Monday) |
| midnight | Roll over at midnight |
TimedRotatingFileHandler
允许我们按时间切片来捕获日志文件。
import logging
import logging.handlers as handlers
import time
logger = logging.getLogger('my_app')
logger.setLevel(logging.INFO)
logHandler = handlers.TimedRotatingFileHandler('timed_app.log', when='M', interval=1)
logHandler.setLevel(logging.INFO)
logger.addHandler(logHandler)
def main():
while True:
time.sleep(1)
logger.info("A Sample Log Statement")
main()
运行此代码将无限期地每分钟创建新的日志文件。我们可以在logHandler
实例上设置backupCount
参数,它将限制我们创建的日志文件数量。
使用适当的日志级别
使用TimedRotatingFileHandler
和RotatingFileHandler
,可以做以下事情,例如将所有错误消息记录到旋转文件中,但将所有普通日志文件记录到TimedRotatingFileHandler
中,因为我们希望预计会有比错误消息更多的普通日志文件。
两个级别的记录被拆分为两个不同的日志级别:INFO
和ERROR
分别放置到不同的位置。
import logging
import logging.handlers as handlers
import time
logger = logging.getLogger('my_app')
logger.setLevel(logging.INFO)
formatter = logging.Formatter('%(asctime)s - %(name)s - %(levelname)s - %(message)s')
logHandler = handlers.TimedRotatingFileHandler('normal.log', when='M', interval=1, backupCount=0)
logHandler.setLevel(logging.INFO)
logHandler.setFormatter(formatter)
errorLogHandler = handlers.RotatingFileHandler('error.log', maxBytes=5000, backupCount=0)
errorLogHandler.setLevel(logging.ERROR)
errorLogHandler.setFormatter(formatter)
logger.addHandler(logHandler)
logger.addHandler(errorLogHandler)
def main():
while True:
time.sleep(1)
logger.info("A Sample Log Statement")
logger.error("An error log statement")
main()
请注意,在运行此代码时会创建3个日志文件。 error.log
只包含级别为ERROR
或更高级别的日志。 normal.log
将包含应用程序记录的所有日志消息的组合。
这些只是我认为在实现自己的日志系统时重要的几个方面。