基本實(shí)例
import logging
# 創(chuàng)建一個(gè)logger
logger = logging.getLogger('mylogger')
logger.setLevel(logging.DEBUG)
# 創(chuàng)建一個(gè)handler妇萄,用于寫(xiě)入日志文件
fh = logging.FileHandler('test.log')
fh.setLevel(logging.DEBUG)
# 再創(chuàng)建一個(gè)handler子寓,用于輸出到控制臺(tái)
sh = logging.StreamHandler()
sh.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(sh)
基本函數(shù)API
logging.getLogger([name])
返回一個(gè)logger實(shí)例食零,如果沒(méi)有指定name滑废,返回root logger蝗肪。只要name相同,返回的logger實(shí)例都是同一個(gè)而且只有一個(gè)蠕趁,即name和logger實(shí)例是一一對(duì)應(yīng)的薛闪。這意味著,無(wú)需把logger實(shí)例在各個(gè)模塊中傳遞俺陋。只要知道name豁延,就能得到同一個(gè)logger實(shí)例昙篙。
logger.setLevel(/v/)
設(shè)置logger的level,數(shù)值越高诱咏,優(yōu)先級(jí)越高苔可。取值如下:
Level | Numeric value 2 |
---|---|
CRITICAL | 50 |
ERROR | 40 |
WARNING | 30 |
INFO | 20 |
DEBUG | 10 |
NOTSET | 0 |
如果把logger的級(jí)別設(shè)置成INFO,那么小于INFO級(jí)別的日志都不輸出袋狞,大于等于INFO級(jí)別的日志都輸出焚辅。
logger.addHandler(hdlr)
通過(guò)handler對(duì)象可以把日志內(nèi)容寫(xiě)到不同的地方。比如簡(jiǎn)單的StreamHandler就是把日志寫(xiě)到類(lèi)似文件的地方苟鸯。python提供了十幾種實(shí)用handler同蜻,比較常用有:
- StreamHandler: 輸出到控制臺(tái)
- FileHandler: 輸出到文件
- BaseRotatingHandler 可以按時(shí)間寫(xiě)入到不同的日志中。比如將日志按天寫(xiě)入不同的日期結(jié)尾的文件文件早处。
- SocketHandler 用TCP網(wǎng)絡(luò)連接寫(xiě)LOG
- DatagramHandler 用UDP網(wǎng)絡(luò)連接寫(xiě)LOG
- SMTPHandler 把LOG寫(xiě)成EMAIL郵寄出去
logging.basicConfig([**kwargs])
這個(gè)函數(shù)用來(lái)配置root logger湾蔓, 為root logger創(chuàng)建一個(gè)StreamHandler,設(shè)置默認(rèn)的格式砌梆。
這些函數(shù): logging.debug()卵蛉、logging.info()、logging.warning()么库、logging.error()傻丝、logging.critical() 如果調(diào)用的時(shí)候發(fā)現(xiàn)root logger沒(méi)有任何handler,會(huì)自動(dòng)調(diào)用basicConfig添加一個(gè)handler
如果root logger已有handler诉儒,這個(gè)函數(shù)不做任何事情使用basicConfig來(lái)配置root logger的輸出格式和level:
import logging
logging.basicConfig(format='%(levelname)s:%(message)s', level=logging.DEBUG)
logging.debug('This message should appear on the console')