Python logging 模塊
例子
-
代碼
Paste_Image.png -
輸出結(jié)果
Paste_Image.png
詳解
- logging.basicConfig()函數(shù)中可通過具體參數(shù)來更改logging模塊默認(rèn)行為兔朦，可用參數(shù)
- filename：用于指定文件名創(chuàng)建FileHandler，存儲日志到指定文件中示括。
- filemode：文件打開方式罪佳，在指定了filename時使用這個參數(shù)，默認(rèn)值為"a"（只讀）虫几，還可指定為"w"（只寫）锤灿。
- format：指定handler使用的日志顯示格式。
- datefmt：指定日期時間格式辆脸。
- level：設(shè)置rootlog的日志級別但校。
- stream：用指定的stream創(chuàng)建StreamHandler》惹猓可以指定輸出到sys.stderr状囱，sys.stdout或者文件术裸，默認(rèn)為sys.stderr。若同時列出了fliename和stream兩個參數(shù)亭枷，則stream參數(shù)會被忽略袭艺。
format 參數(shù)中可能用到的格式化串：
- %(name)s Logger的名字
- %(levelno)s 數(shù)字形式的日志
- %(levelname)s 文本形式的日志
- %(pathname)s 調(diào)用日志輸出函數(shù)的模塊的完整路徑名，可能沒有
- %(filename)s 調(diào)用日志輸出函數(shù)的模塊的文件名
- %(module)s 調(diào)用日志輸出函數(shù)的模塊名
- %(funcName)s 調(diào)用日志輸出函數(shù)的函數(shù)名
- %(lineno)d 調(diào)用日志輸出函數(shù)的語句所在的代碼行
- %(created)f 當(dāng)前時間叨粘，用UNIX標(biāo)準(zhǔn)的表示時間的浮點數(shù)表示
- %(relativeCreated)d 輸出日志信息時的猾编，自logger創(chuàng)建以來的毫秒數(shù)。
- %(asctime)s 字符串形式的當(dāng)前時間升敲。默認(rèn)格式"2016-07-19 16:06:46,292"
- %(thread)d 線程名答倡。可能沒有
- %(process)d 進(jìn)程ID冻晤∥郏可能沒有
- %(message)s 用戶輸出的信息。
logging
- logging 庫提供了多個組件：Logger鼻弧、Handler设江、Filter、Formatter攘轩。Logger對象提供應(yīng)用程序可直接使用的接口叉存，Handler發(fā)生日志到適當(dāng)?shù)哪康牡兀現(xiàn)ilter提供了過濾日志信息的方法度帮，F(xiàn)ormatter指定日志顯示格式歼捏。
Logger
Logger 是一個樹形層級結(jié)構(gòu)，輸出信息之前都要獲得一個Logger（如果沒有顯示的獲取則自動創(chuàng)建并使用root Logger）笨篷。logger=logging.getLogger()返回一個默認(rèn)的Logger也即root Logger瞳秽，并應(yīng)用默認(rèn)日志級別、Handler和Formatter設(shè)置率翅。當(dāng)然也可以通過Logger.setLevel(lel)指定最低的日志級別练俐，可用的日志級別有l(wèi)ogging.DEBUG、logging.INFO冕臭、logging.WARNING腺晾、logging.ERROR、logging.CRITICAL辜贵。
Logger.debug()悯蝉、Logger.info()、Logger.warning()托慨、Logger.error()鼻由、Logger.critical()輸出不同級別的日志，只有日志等級大于或等于設(shè)置的日志級別的日志才會被輸出。
-
創(chuàng)建一個logger
日志級別等級
- 默認(rèn)的日志級別設(shè)置為WARNING嗡靡，日志級別等級CRITICAL > ERROR > WARNING > INFO > DEBUG > NOTSET
Handler
- 定義Handler
fh = logging.FileHandler('test.log')
ch = logging.StreamHandler() - Handler 對象負(fù)責(zé)發(fā)送相關(guān)信息到指定目的地跺撼，有幾個常用的Handler方法：
Handler.setLevel(lev)：指定日志級別窟感，低于級別的日志將被忽略
Handler.setFormatter()：給這個handler選擇一個Formatter
Handler.addFilter(filt)：新增一個filter對象
Handler.removeFilter(filt)：刪除一個filter對象 - 為 Logger 添加多個Handler：
logger.addHandler(fh)
logger.addHandler(ch) - 有多種可用的Handler：
logging.StreamHandler 可以向類似與sys.stdout或者sys.stderr的任何文件對象(file object)輸出信息
logging.FileHandler 用于向一個文件輸出日志信息logging.handlers.RotatingFileHandler 類似于上面的FileHandler讨彼，但是它可以管理文件大小。當(dāng)文件達(dá)到一定大小之后柿祈，它會自動將當(dāng)前日志文件改名哈误，然后創(chuàng)建一個新的同名日志文件繼續(xù)輸出logging.handlers.TimedRotatingFileHandler 和RotatingFileHandler類似，不過躏嚎，它沒有通過判斷文件大小來決定何時重新創(chuàng)建日志文件蜜自，而是間隔一定時間就自動創(chuàng)建新的日志文件
logging.handlers.SocketHandler 使用TCP協(xié)議，將日志信息發(fā)送到網(wǎng)絡(luò)卢佣。
logging.handlers.DatagramHandler 使用UDP協(xié)議重荠，將日志信息發(fā)送到網(wǎng)絡(luò)。
logging.handlers.SysLogHandler 日志輸出到sysloglogging.handlers.NTEventLogHandler 遠(yuǎn)程輸出日志到Windows NT/2000/XP的事件日志
logging.handlers.SMTPHandler 遠(yuǎn)程輸出日志到郵件地址logging.handlers.MemoryHandler 日志輸出到內(nèi)存中的制定bufferlogging.handlers.HTTPHandler 通過"GET"或"POST"遠(yuǎn)程輸出到HTTP服務(wù)器
https://docs.python.org/2/library/logging.handlers.html#module-logging.handlers
Formatter
- Formatter 對象設(shè)置日志信息最后的規(guī)則虚茶、結(jié)構(gòu)戈鲁、和內(nèi)容，默認(rèn)時間格式為 %Y-%m-%d %H:%M:%S
- 定義 Formatter
formatter = logging.Formatter('%(asctime)s - %(name)s - %(levename)s - %(message)s') - 為Handler添加Formatter
fh.setFormatter(formatter)
ch.setFormatter(formatter)
Filter
- 限制只有滿足過濾規(guī)則的日志才會輸出
- 比如我們定義了filter = logging.Filter('a.b.c')嘹叫，并將這個Filter添加到了一個Handler上婆殿，則使用該Handler的Logger中只有名字帶a.b.c前綴的Logger才能輸出其日志
filter = logging.Filter('mylogger.child1.child2')
fh.addFilter(filter) - 若為Handler添加Filter則所有使用了該Handler的logger都會受到影響。而為Logger添加Filer只會影響到自身罩扇。婆芦、
