夠用的 Python 寫日誌的知識——標準日誌模塊logging簡介

前一段工做的時候用到了python寫後臺系統，須要把一些系統的行爲記錄下來。本着不要去重複發明輪子的精神，就去搜索了一下python的系統庫自己是否有寫日誌的模塊。果真有。python語言做爲一門接口簡單，標準庫強大的語言，果真沒有令我失望。

簡單的使用方法

python的標準庫裏的日誌系統從Python2.3開始支持。只要import logging這個模塊便可使用。若是你想把日誌寫入指定的一個文件中，只要這樣使用：

import logging
logging.basicConfig(filename='example.log',level=logging.DEBUG)
logging.debug('This message should go to the log file')
logging.info('So should this')
logging.warning('And this %s %d, too','123',1)

basicConfig是指定文件的路徑和日誌的級別。

日誌一共分紅5個等級，從低到高分別是：DEBUG INFO WARNING ERROR CRITICAL。這5個等級，也分別對應5種打日誌的方法： debug info ,warning error critical。這5種方法都是相似C語言的printf的方法。 在basicConfig中設置的是日誌的最低級別，換句話說，在程序中，只有使用了更高等級的日誌信息纔會打印出來。 好比你設置的日誌級別是logging.INFO, 那麼只有使用info, warning, error, critical這4種方法日誌纔會被記錄下來，debug的日誌將會被忽略。

用上面的方法，簡單的日誌就能夠被打印出來了。不過logging模塊的功能很是強大，你還能夠經過更加自由的接口，自定義出更復雜的日誌形式。須要用到下面3種對象：

logger formatter handler .

logger

logger對象直接提供日誌接口。formatter描述日誌的格式。handler把日誌寫到不一樣的地方，你能夠把日誌保存成本地文件，也能夠每一個小時寫一個日誌文件，還能夠把日誌經過socket傳到別的機器上。

從最簡單的formatter對象來看。formatter指定的是每一條日誌記錄的擡頭信息，也就是你能夠指定日誌記錄的時間格式、進程號、文件名、函數名等信息。能夠用這個方法來建立一個formatter對象：

logging.Formatter.__init__( fmt=None, datefmt=None)

fmt參數指定進程號、文件名、函數名等信息是否出現以及格式， datefmt爲日期時間格式，默認的日期格式精確到微秒，例如‘2003-07-08 16:49:45,896’。fmt中能夠指定多個字段，每一個字段的格式爲「%(<dictionary key>)s」， 例如你想打印時間、日誌級別、日誌信息能夠用下面的format:

'%(asctime)s - %(levelname)s - %(message)s'

全部的可使用的字段以下表：

hander

經過handler對象能夠把日誌內容寫到不一樣的地方。好比簡單的StreamHandler就是把日誌寫到相似文件的地方。python提供了十幾種實用handler，比較經常使用和比較有意思的我列舉一下：

StreamHandler 寫入類文件的流。

BaseRotatingHandler 能夠按時間寫入到不一樣的日誌中。好比將日誌按天寫入不一樣的日期結尾的文件文件。

SocketHandler 用TCP網絡鏈接寫LOG

DatagramHandler 用UDP網絡鏈接寫LOG

SMTPHandler 把LOG寫成EMAIL郵寄出去

等等

簡單的例子來講明下 formatter handler logger 3個對象之間的交互吧。

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

import logging
import logging.handlers

logger = logging.getLogger()
logger.setLevel(logging.DEBUG)

rh=logging.handlers.TimedRotatingFileHandler('loggertester','D')
fm=logging.Formatter("%(asctime)s  %(levelname)s - %(message)s","%Y-%m-%d %H:%M:%S")
rh.setFormatter(fm)
logger.addHandler(rh)

debug=logger.debug
info=logger.info
warn=logger.warn
error=logger.error
critical=logger.critical

info("testlog1")
warn("warn you %s","costaxu")
critical("it is critical")