python常識系列09-->logging模塊之handlers的使用

前言

      所有的勝利，與征服自我的勝利比起來，都是微不足道。

一、handlers是什么？

• logging模塊中包含的類
• 用來自定義日志對象的規則（比如：設置日志輸出格式、等級等）
• 常用3個子類：StreamHandler、FileHandler、TimedRotatingFileHandler

二、handlers基礎應用

• 2.1 StreamHandler 控制台輸出日志

import logging

#創建一個logger日志對象
logger = logging.getLogger('test_logger')
logger.setLevel(logging.DEBUG)    #設置默認的日志級別

#創建日志格式對象
formatter = logging.Formatter('%(asctime)s - %(name)s - %(levelname)s - %(message)s')

#創建StreamHandler對象
sh = logging.StreamHandler()
#StreamHandler對象自定義日志級別
sh.setLevel(logging.DEBUG)
#StreamHandler對象自定義日志格式
sh.setFormatter(formatter)

logger.addHandler(sh)    #logger日志對象加載StreamHandler對象
#日志輸出
logger.info('newdream')

上面代碼執行后，會在控制台輸出日志信息。

• 2.2 FileHandler 日志輸出到文件

import logging

#創建一個logger日志對象
logger = logging.getLogger('test_logger')
logger.setLevel(logging.DEBUG)    #設置默認的日志級別

#創建日志格式對象
formatter = logging.Formatter('%(asctime)s - %(name)s - %(levelname)s - %(message)s')

#創建FileHandler對象
fh = logging.FileHandler('test.log')
#FileHandler對象自定義日志級別
fh.setLevel(logging.DEBUG)
#FileHandler對象自定義日志格式
fh.setFormatter(formatter)

logger.addHandler(fh)    #logger日志對象加載FileHandler對象
#日志輸出
logger.info('newdream')

上面代碼執行后，控制台不會輸出日志信息，而會在當前文件夾新建一個test.log日志文件進行日志記錄。

• 2.3 TimedRotatingFileHandler 日志分割

import logging
from logging import handlers

#創建一個logger日志對象
logger = logging.getLogger('test_logger')
logger.setLevel(logging.DEBUG)    #設置默認的日志級別

#創建日志格式對象
formatter = logging.Formatter('%(asctime)s - %(name)s - %(levelname)s - %(message)s')

#創建TimedRotatingFileHandler對象
rh = handlers.TimedRotatingFileHandler("test.log", when='S', interval=1, backupCount=5)
#TimedRotatingFileHandler對象自定義日志級別
rh.setLevel(logging.DEBUG)
#TimedRotatingFileHandler對象自定義日志級別
rh.suffix = "%Y_%m_%d_%H_%M_%S.log"
#TimedRotatingFileHandler對象自定義日志格式
rh.setFormatter(formatter)

logger.addHandler(rh)    #logger日志對象加載TimedRotatingFileHandler對象
#日志輸出
logger.info('newdream')

上面代碼執行后，控制台不會輸出日志信息，而會在當前文件夾新建一個 test_年_月_日_時_分_秒.log 日志文件進行日志記錄。
在使用TimedRotatingFileHandler創建對象時，它的構造函數定義如下：
TimedRotatingFileHandler(filename [,when [,interval [,backupCount]]])
filename：是輸出日志文件名的前綴，比如log/myapp.log
when：按什么日期格式切分，接收指定字符串參數，接收的值如下：
“S”: Seconds
“M”: Minutes
“H”: Hours
“D”: Days
“W”: Week day (0=Monday)
“midnight”: Roll over at midnight
interval 是指等待多少個單位when的時間后，Logger會自動重建文件，這個文件的創建取決於filename+suffix，若這個文件跟之前的文件有重名，則會自動覆蓋掉以前的文件，所以有些情況suffix要定義不能因為when而重復。
backupCount 是保留日志個數。默認的0是不會自動刪除掉日志。若設為5，則在文件的創建過程中庫會判斷是否有超過這個5，若超過，則會從最先創建的開始刪除。

三、小結

• 以上的日志實例為了讓讀者更清晰的操作和理解，分開代碼單獨實現
• 在 2.3 中 如果想實現看是否達到5個日志就刪除的效果，可以把日志用循環輸出，如下：

while True:
    logger.info('newdream')

• 三種handlers日志可以共同使用，都是獨立的handler對象，但一般 FileHandler 和 TimedRotatingFileHandler 不會同時使用。