python标準日志子產品logging的使用方法

<a href="http://www.jb51.net/article/42626.htm" target="_blank">參考位址</a>

最近寫一個爬蟲系統，需要用到python的日志記錄子產品，于是便學習了一下。

python的标準庫裡的日志系統從Python2.3開始支援。隻要import logging這個子產品即可使用。如果你想開發一個日志系統， 既要把日志輸出到控制台， 還要寫入日志檔案，隻要這樣使用：

import logging

# 建立一個logger

logger = logging.getLogger('mylogger')

logger.setLevel(logging.DEBUG)

# 建立一個handler，用于寫入日志檔案

fh = logging.FileHandler('test.log')

fh.setLevel(logging.DEBUG)

# 再建立一個handler，用于輸出到控制台

ch = logging.StreamHandler()

ch.setLevel(logging.DEBUG)

# 定義handler的輸出格式

formatter = logging.Formatter('%(asctime)s - %(name)s - %(levelname)s - %(message)s')

fh.setFormatter(formatter)

ch.setFormatter(formatter)

# 給logger添加handler

logger.addHandler(fh)

logger.addHandler(ch)

# 記錄一條日志

logger.info('foorbar')

結合上面的例子，我們說下幾個最常使用的API：

　　logging.getLogger([name])

　　傳回一個logger執行個體，如果沒有指定name，傳回root logger。隻要name相同，傳回的logger執行個體都是同一個而且隻有一個，即name和logger執行個體是一一對應的。這意味着，無需把logger執行個體在各個子產品中傳遞。隻要知道name，就能得到同一個logger執行個體。

　　Logger.setLevel(lvl)

　　設定logger的level， level有以下幾個級别：

　　　　

　　級别高低順序：NOTSET &lt; DEBUG &lt; INFO &lt; WARNING &lt; ERROR &lt; CRITICAL

　　如果把looger的級别設定為INFO， 那麼小于INFO級别的日志都不輸出， 大于等于INFO級别的日志都輸出　　

logger.debug("foobar")    # 不輸出   

logger.info("foobar")        # 輸出  

logger.warning("foobar")  # 輸出  

logger.error("foobar")      # 輸出  

logger.critical("foobar")    # 輸出  

Logger.addHandler(hdlr)

通過handler對象可以把日志内容寫到不同的地方。比如簡單的StreamHandler就是把日志寫到類似檔案的地方。python提供了十幾種實用handler，比較常用有：

StreamHandler: 輸出到控制台

 FileHandler:   輸出到檔案

BaseRotatingHandler 可以按時間寫入到不同的日志中。比如将日志按天寫入不同的日期結尾的檔案檔案。

SocketHandler 用TCP網絡連接配接寫LOG

DatagramHandler 用UDP網絡連接配接寫LOG

SMTPHandler 把LOG寫成EMAIL郵寄出去

logging.basicConfig([**kwargs])* 這個函數用來配置root logger， 為root logger建立一個StreamHandler，設定預設的格式。* 這些函數： logging.debug()、logging.info()、logging.warning()、logging.error()、logging.critical() 如果調用的時候發現root logger沒有任何handler，會自動調用basicConfig添加一個handler* 如果root logger已有handler，這個函數不做任何事情使用basicConfig來配置root logger的輸出格式和level：

logging.basicConfig(format='%(levelname)s:%(message)s', level=logging.DEBUG)

logging.debug('This message should appear on the console')

ogger對象直接提供日志接口。formatter描述日志的格式。handler把日志寫到不同的地方，你可以把日志儲存成本地檔案，也可以每個小時寫一個日志檔案，還可以把日志通過socket傳到别的機器上。

從最簡單的formatter對象來看。formatter指定的是每一條日志記錄的擡頭資訊，也就是你可以指定日志記錄的時間格式、程序号、檔案名、函數名等資訊。可以用這個方法來建立一個formatter對象：

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

fmt參數指定程序号、檔案名、函數名等資訊是否出現以及格式， datefmt為日期時間格式，預設的日期格式精确到微秒，例如‘2003-07-08 16:49:45,896'。fmt中可以指定多個字段，每個字段的格式為“%(&lt;dictionary key&gt;)s”， 例如你想列印時間、日志級别、日志資訊可以用下面的format:

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

在記錄爬蟲系統日志的時候需要定義記錄日志的級别，級别越高表示打出來的日志越詳細。我們可以用一個字典來設定不同級别對應的不同日志資訊：

#用字典儲存日志級别

format_dict = {

   1 : logging.Formatter('%(asctime)s - %(name)s - %(levelname)s - %(message)s'),

   2 : logging.Formatter('%(asctime)s - %(name)s - %(levelname)s - %(message)s'),

   3 : logging.Formatter('%(asctime)s - %(name)s - %(levelname)s - %(message)s'),

   4 : logging.Formatter('%(asctime)s - %(name)s - %(levelname)s - %(message)s'),

   5 : logging.Formatter('%(asctime)s - %(name)s - %(levelname)s - %(message)s')

}

将本文開始的代碼封裝在一個類中

#開發一個日志系統， 既要把日志輸出到控制台， 還要寫入日志檔案   

class Logger():

    def __init__(self, logname, loglevel, logger):

        '''

           指定儲存日志的檔案路徑，日志級别，以及調用檔案

           将日志存入到指定的檔案中

        # 建立一個logger

        self.logger = logging.getLogger(logger)

        self.logger.setLevel(logging.DEBUG)

        # 建立一個handler，用于寫入日志檔案

        fh = logging.FileHandler(logname)

        fh.setLevel(logging.DEBUG)

        # 再建立一個handler，用于輸出到控制台

        ch = logging.StreamHandler()

        ch.setLevel(logging.DEBUG)

        # 定義handler的輸出格式

        #formatter = logging.Formatter('%(asctime)s - %(name)s - %(levelname)s - %(message)s')

        formatter = format_dict[int(loglevel)]

        fh.setFormatter(formatter)

        ch.setFormatter(formatter)

        # 給logger添加handler

        self.logger.addHandler(fh)

        self.logger.addHandler(ch)

    def getlog(self):

        return self.logger

再通過以下方式調用，便是一個簡單的日志系統了

logger = Logger(logname='log.txt', loglevel=1, logger="fox").getlog()