日志

日志是跟蹤軟件運(yùn)行時(shí)所發(fā)生的事件的一種方法。軟件開(kāi)發(fā)者在代碼中調(diào)用日志函數(shù)，表明發(fā)生了特定的事件。事件由描述性消息描述，該描述性消息可以可選地包含可變數(shù)據(jù)（即，對(duì)于事件的每次出現(xiàn)都潛在地不同的數(shù)據(jù)）。事件還具有開(kāi)發(fā)者歸因于事件的重要性；重要性也可以稱(chēng)為級(jí)別或嚴(yán)重性。

logging提供了一組便利的函數(shù)，用來(lái)做簡(jiǎn)單的日志。它們是 debug()、 info()、 warning()、 error() 和 critical()。

?

logging函數(shù)根據(jù)它們用來(lái)跟蹤的事件的級(jí)別或嚴(yán)重程度來(lái)命名。標(biāo)準(zhǔn)級(jí)別及其適用性描述如下（以嚴(yán)重程度遞增排序）：

級(jí)別何時(shí)使用

DEBUG	詳細(xì)信息，一般只在調(diào)試問(wèn)題時(shí)使用。
INFO	證明事情按預(yù)期工作。
WARNING	某些沒(méi)有預(yù)料到的事件的提示，或者在將來(lái)可能會(huì)出現(xiàn)的問(wèn)題提示。例如：磁盤(pán)空間不足。但是軟件還是會(huì)照常運(yùn)行。
ERROR	由于更嚴(yán)重的問(wèn)題，軟件已不能執(zhí)行一些功能了。
CRITICAL	嚴(yán)重錯(cuò)誤，表明軟件已不能繼續(xù)運(yùn)行了。

?

級(jí)別數(shù)字值

CRITICAL	50
ERROR	40
WARNING	30
INFO	20
DEBUG	10
NOTSET	0 ?

?

默認(rèn)等級(jí)是WARNING，這意味著僅僅這個(gè)等級(jí)及以上的才會(huì)反饋信息，除非logging模塊被用來(lái)做其它事情。

被跟蹤的事件能以不同的方式被處理。最簡(jiǎn)單的處理方法就是把它們?cè)诳刂婆_(tái)上打印出來(lái)。另一種常見(jiàn)的方法就是寫(xiě)入磁盤(pán)文件。

?

一、打印到控制臺(tái)

import logging logging.debug('debug 信息') logging.warning('只有這個(gè)會(huì)輸出。。。') logging.info('info 信息')

由于默認(rèn)設(shè)置的等級(jí)是warning，所有只有warning的信息會(huì)輸出到控制臺(tái)。

WARNING:root:只有這個(gè)會(huì)輸出。。。

?

利用logging.basicConfig()打印信息到控制臺(tái)

import logging logging.basicConfig(format='%(asctime)s - %(pathname)s[line:%(lineno)d] - %(levelname)s: %(message)s',level=logging.DEBUG) logging.debug('debug 信息') logging.info('info 信息') logging.warning('warning 信息') logging.error('error 信息') logging.critical('critial 信息')

由于在logging.basicConfig()中的level 的值設(shè)置為logging.DEBUG, 所有debug, info, warning, error, critical 的log都會(huì)打印到控制臺(tái)。

日志級(jí)別： debug < info < warning < error < critical logging.debug('debug級(jí)別，最低級(jí)別，一般開(kāi)發(fā)人員用來(lái)打印一些調(diào)試信息') logging.info('info級(jí)別，正常輸出信息，一般用來(lái)打印一些正常的操作') logging.warning('waring級(jí)別，一般用來(lái)打印警信息') logging.error('error級(jí)別，一般用來(lái)打印一些錯(cuò)誤信息') logging.critical('critical 級(jí)別，一般用來(lái)打印一些致命的錯(cuò)誤信息,等級(jí)最高')

所以如果設(shè)置level = logging.info()的話(huà)，debug 的信息則不會(huì)輸出到控制臺(tái)。

?

二、利用logging.basicConfig()保存log到文件

logging.basicConfig(level=logging.DEBUG,#控制臺(tái)打印的日志級(jí)別filename='new.log',filemode='a',##模式，有w和a，w就是寫(xiě)模式，每次都會(huì)重新寫(xiě)日志，覆蓋之前的日志#a是追加模式，默認(rèn)如果不寫(xiě)的話(huà)，就是追加模式format='%(asctime)s - %(pathname)s[line:%(lineno)d] - %(levelname)s: %(message)s'#日志格式)

如果在logging.basicConfig()設(shè)置filename 和filemode，則只會(huì)保存log到文件，不會(huì)輸出到控制臺(tái)。

?

三、既往屏幕輸入，也往文件寫(xiě)入log

?

logging庫(kù)采取了模塊化的設(shè)計(jì)，提供了許多組件：記錄器、處理器、過(guò)濾器和格式化器。

• Logger 暴露了應(yīng)用程序代碼能直接使用的接口。
• Handler將（記錄器產(chǎn)生的）日志記錄發(fā)送至合適的目的地。
• Filter提供了更好的粒度控制，它可以決定輸出哪些日志記錄。
• Formatter 指明了最終輸出中日志記錄的布局。

Loggers:

Logger 對(duì)象要做三件事情。首先，它們向應(yīng)用代碼暴露了許多方法，這樣應(yīng)用可以在運(yùn)行時(shí)記錄消息。其次，記錄器對(duì)象通過(guò)嚴(yán)重程度（默認(rèn)的過(guò)濾設(shè)施）或者過(guò)濾器對(duì)象來(lái)決定哪些日志消息需要記錄下來(lái)。第三，記錄器對(duì)象將相關(guān)的日志消息傳遞給所有感興趣的日志處理器。

常用的記錄器對(duì)象的方法分為兩類(lèi)：配置和發(fā)送消息。

這些是最常用的配置方法：

Logger.setLevel()指定logger將會(huì)處理的最低的安全等級(jí)日志信息, debug是最低的內(nèi)置安全等級(jí)，critical是最高的內(nèi)建安全等級(jí)。例如，如果嚴(yán)重程度為INFO，記錄器將只處理INFO，WARNING，ERROR和CRITICAL消息，DEBUG消息被忽略。
Logger.addHandler()和Logger.removeHandler()從記錄器對(duì)象中添加和刪除處理程序?qū)ο蟆Ｌ幚砥髟斠?jiàn)Handlers。
Logger.addFilter()和Logger.removeFilter()從記錄器對(duì)象添加和刪除過(guò)濾器對(duì)象。

Handlers

處理程序?qū)ο筘?fù)責(zé)將適當(dāng)?shù)娜罩鞠?#xff08;基于日志消息的嚴(yán)重性）分派到處理程序的指定目標(biāo)。Logger?對(duì)象可以通過(guò)addHandler()方法增加零個(gè)或多個(gè)handler對(duì)象。舉個(gè)例子，一個(gè)應(yīng)用可以將所有的日志消息發(fā)送至日志文件，所有的錯(cuò)誤級(jí)別（error）及以上的日志消息發(fā)送至標(biāo)準(zhǔn)輸出，所有的嚴(yán)重級(jí)別（critical）日志消息發(fā)送至某個(gè)電子郵箱。在這個(gè)例子中需要三個(gè)獨(dú)立的處理器，每一個(gè)負(fù)責(zé)將特定級(jí)別的消息發(fā)送至特定的位置。

常用的有4種：?

1) ? ?logging.StreamHandler ->?控制臺(tái)輸出?

使用這個(gè)Handler可以向類(lèi)似與sys.stdout或者sys.stderr的任何文件對(duì)象(file object)輸出信息。

它的構(gòu)造函數(shù)是：
StreamHandler([strm])
其中strm參數(shù)是一個(gè)文件對(duì)象。默認(rèn)是sys.stderr

2)?? logging.FileHandler? ->?文件輸出

和StreamHandler類(lèi)似，用于向一個(gè)文件輸出日志信息。不過(guò)FileHandler會(huì)幫你打開(kāi)這個(gè)文件。它的構(gòu)造函數(shù)是：
FileHandler(filename[,mode])
filename是文件名，必須指定一個(gè)文件名。
mode是文件的打開(kāi)方式。默認(rèn)是’a'，即添加到文件末尾。

3) ??logging.handlers.RotatingFileHandler?->?按照大小自動(dòng)分割日志文件，一旦達(dá)到指定的大小重新生成文件?

這個(gè)Handler類(lèi)似于上面的FileHandler，但是它可以管理文件大小。當(dāng)文件達(dá)到一定大小之后，它會(huì)自動(dòng)將當(dāng)前日志文件改名，然后創(chuàng)建 一個(gè)新的同名日志文件繼續(xù)輸出。比如日志文件是chat.log。當(dāng)chat.log達(dá)到指定的大小之后，RotatingFileHandler自動(dòng)把 文件改名為chat.log.1。不過(guò)，如果chat.log.1已經(jīng)存在，會(huì)先把chat.log.1重命名為chat.log.2。。。最后重新創(chuàng)建 chat.log，繼續(xù)輸出日志信息。它的構(gòu)造函數(shù)是：
RotatingFileHandler( filename[, mode[, maxBytes[, backupCount]]])
其中filename和mode兩個(gè)參數(shù)和FileHandler一樣。
maxBytes用于指定日志文件的最大文件大小。如果maxBytes為0，意味著日志文件可以無(wú)限大，這時(shí)上面描述的重命名過(guò)程就不會(huì)發(fā)生。
backupCount用于指定保留的備份文件的個(gè)數(shù)。比如，如果指定為2，當(dāng)上面描述的重命名過(guò)程發(fā)生時(shí)，原有的chat.log.2并不會(huì)被更名，而是被刪除。

4)?? logging.handlers.TimedRotatingFileHandler? ->?按照時(shí)間自動(dòng)分割日志文件?

這個(gè)Handler和RotatingFileHandler類(lèi)似，不過(guò)，它沒(méi)有通過(guò)判斷文件大小來(lái)決定何時(shí)重新創(chuàng)建日志文件，而是間隔一定時(shí)間就 自動(dòng)創(chuàng)建新的日志文件。重命名的過(guò)程與RotatingFileHandler類(lèi)似，不過(guò)新的文件不是附加數(shù)字，而是當(dāng)前時(shí)間。它的構(gòu)造函數(shù)是：
TimedRotatingFileHandler( filename [,when [,interval [,backupCount]]])
其中filename參數(shù)和backupCount參數(shù)和RotatingFileHandler具有相同的意義。
interval是時(shí)間間隔。
when參數(shù)是一個(gè)字符串。表示時(shí)間間隔的單位，不區(qū)分大小寫(xiě)。它有以下取值：
S 秒
M 分
H 小時(shí)
D 天
W 每星期（interval==0時(shí)代表星期一）
midnight 每天凌晨
?

配置方法：

• setLevel()方法和日志對(duì)象的一樣，指明了將會(huì)分發(fā)日志的最低級(jí)別。為什么會(huì)有兩個(gè)setLevel()方法？記錄器的級(jí)別決定了消息是否要傳遞給處理器。每個(gè)處理器的級(jí)別決定了消息是否要分發(fā)。
• setFormatter()為該處理器選擇一個(gè)格式化器。
• addFilter()和removeFilter()分別配置和取消配置處理程序上的過(guò)濾器對(duì)象。

Formatters

Formatter對(duì)象設(shè)置日志信息最后的規(guī)則、結(jié)構(gòu)和內(nèi)容，默認(rèn)的時(shí)間格式為%Y-%m-%d %H:%M:%S，下面是Formatter常用的一些信息

%(name)s	Logger的名字
%(levelno)s	數(shù)字形式的日志級(jí)別
%(levelname)s	文本形式的日志級(jí)別
%(pathname)s	調(diào)用日志輸出函數(shù)的模塊的完整路徑名，可能沒(méi)有
%(filename)s	調(diào)用日志輸出函數(shù)的模塊的文件名
%(module)s	調(diào)用日志輸出函數(shù)的模塊名
%(funcName)s	調(diào)用日志輸出函數(shù)的函數(shù)名
%(lineno)d	調(diào)用日志輸出函數(shù)的語(yǔ)句所在的代碼行
%(created)f	當(dāng)前時(shí)間，用UNIX標(biāo)準(zhǔn)的表示時(shí)間的浮 點(diǎn)數(shù)表示
%(relativeCreated)d	輸出日志信息時(shí)的，自L(fǎng)ogger創(chuàng)建以 來(lái)的毫秒數(shù)
%(asctime)s	字符串形式的當(dāng)前時(shí)間。默認(rèn)格式是 “2003-07-08 16:49:45,896”。逗號(hào)后面的是毫秒
%(thread)d	線(xiàn)程ID。可能沒(méi)有
%(threadName)s	線(xiàn)程名。可能沒(méi)有
%(process)d	進(jìn)程ID。可能沒(méi)有
%(message)s	用戶(hù)輸出的消息 ?

?

需求：

輸出log到控制臺(tái)以及將日志寫(xiě)入log文件。
保存2種類(lèi)型的log， all.log 保存debug, info, warning, critical 信息， error.log則只保存error信息，同時(shí)按照時(shí)間自動(dòng)分割日志文件。

import logging from logging import handlersclass Logger(object):level_relations = {'debug':logging.DEBUG,'info':logging.INFO,'warning':logging.WARNING,'error':logging.ERROR,'crit':logging.CRITICAL}#日志級(jí)別關(guān)系映射def __init__(self,filename,level='info',when='D',backCount=3,fmt='%(asctime)s - %(pathname)s[line:%(lineno)d] - %(levelname)s: %(message)s'):self.logger = logging.getLogger(filename)format_str = logging.Formatter(fmt)#設(shè)置日志格式self.logger.setLevel(self.level_relations.get(level))#設(shè)置日志級(jí)別sh = logging.StreamHandler()#往屏幕上輸出sh.setFormatter(format_str) #設(shè)置屏幕上顯示的格式th = handlers.TimedRotatingFileHandler(filename=filename,when=when,backupCount=backCount,encoding='utf-8')#往文件里寫(xiě)入#指定間隔時(shí)間自動(dòng)生成文件的處理器#實(shí)例化TimedRotatingFileHandler#interval是時(shí)間間隔，backupCount是備份文件的個(gè)數(shù)，如果超過(guò)這個(gè)個(gè)數(shù)，就會(huì)自動(dòng)刪除，when是間隔的時(shí)間單位，單位有以下幾種：# S 秒# M 分# H 小時(shí)、# D 天、# W 每星期（interval==0時(shí)代表星期一）# midnight 每天凌晨th.setFormatter(format_str)#設(shè)置文件里寫(xiě)入的格式self.logger.addHandler(sh) #把對(duì)象加到logger里self.logger.addHandler(th) if __name__ == '__main__':log = Logger('all.log',level='debug')log.logger.debug('debug')log.logger.info('info')log.logger.warning('警告')log.logger.error('報(bào)錯(cuò)')log.logger.critical('嚴(yán)重')Logger('error.log', level='error').logger.error('error')

屏幕上的結(jié)果如下：

2018-03-13 21:06:46,092 - D:/write_to_log.py[line:25] - DEBUG: debug 2018-03-13 21:06:46,092 - D:/write_to_log.py[line:26] - INFO: info 2018-03-13 21:06:46,092 - D:/write_to_log.py[line:27] - WARNING: 警告 2018-03-13 21:06:46,099 - D:/write_to_log.py[line:28] - ERROR: 報(bào)錯(cuò) 2018-03-13 21:06:46,099 - D:/write_to_log.py[line:29] - CRITICAL: 嚴(yán)重 2018-03-13 21:06:46,100 - D:/write_to_log.py[line:30] - ERROR: error

由于when=D，新生成的文件名上會(huì)帶上時(shí)間，如下所示。

總結(jié)

以上是生活随笔為你收集整理的Python + logging 输出到屏幕，将log日志写入文件(亲测)的全部?jī)?nèi)容，希望文章能夠幫你解決所遇到的問(wèn)題。

如果覺(jué)得生活随笔網(wǎng)站內(nèi)容還不錯(cuò)，歡迎將生活随笔推薦給好友。