logging模塊

1.log日志級別

log日志級別主要有DEBUG，INFO，WARNING，ERROR，CRITICAL，日志級別是逐漸增加的。

"簡單用法"
#!/usr/bin/env python
# -*- coding:utf-8 -*-
# Author: vita
import logging
logging.warning("warning message!")
logging.critical("critical message!")

E:\PythonProject\python-test\venvP3\Scripts\python.exe E:/PythonProject/python-test/BasicGrammer/test.py
WARNING:root:warning message!
CRITICAL:root:critical message!

Process finished with exit code 0

"level=logging.INFO意思是把日志級別設置為info，即只有比日志info級別更高的日志才會記錄到文件中，在這個例子中，debug級別的日志是不會被記錄的，如果想要記錄debug的日志，需要設置為lvel=logging.DEBUG"
"把日志寫到文件中"
#!/usr/bin/env python
# -*- coding:utf-8 -*-
# Author: vita
import logging
logging.basicConfig(filename='example.log',level=logging.INFO)
logging.debug("debug message!")
logging.info("info message!")
logging.warning("warning message!")
logging.critical("critical message!")

E:\PythonProject\python-test\venvP3\Scripts\python.exe E:/PythonProject/python-test/BasicGrammer/test.py

Process finished with exit code 0

查看文件內容
INFO:root:info message!
WARNING:root:warning message!
CRITICAL:root:critical message!

2.自定義日志格式

#!/usr/bin/env python
# -*- coding:utf-8 -*-
# Author: vita
import logging
logging.basicConfig(filename='example.log',level=logging.INFO,format='%(asctime)s %(message)s', datefmt='%m/%d/%Y %I:%M:%S %p')
logging.debug("debug message!")
logging.info("info message!")
logging.warning("warning message!")
logging.critical("critical message!")

E:\PythonProject\python-test\venvP3\Scripts\python.exe E:/PythonProject/python-test/BasicGrammer/test.py

Process finished with exit code 0
查看日志
05/06/2019 06:48:18 PM info message!
05/06/2019 06:48:18 PM warning message!
05/06/2019 06:48:18 PM critical message!

"還可以自定義其他格式"
%(name)s    Logger的名字
%(levelno)s 數字形式的日志級別
%(levelname)s   文本形式的日志級別
%(pathname)s    調用日志輸出函數的模塊的完整路徑名，可能沒有
%(filename)s    調用日志輸出函數的模塊的文件名
%(module)s  調用日志輸出函數的模塊名
%(funcName)s    調用日志輸出函數的函數名
%(lineno)d  調用日志輸出函數的語句所在的代碼行
%(created)f 當前時間，用UNIX標準的表示時間的浮 點數表示
%(relativeCreated)d 輸出日志信息時的，自Logger創建以 來的毫秒數
%(asctime)s 字符串形式的當前時間。默認格式是 “2003-07-08 16:49:45,896”。逗號后面的是毫秒
%(thread)d  線程ID。可能沒有
%(threadName)s  線程名。可能沒有
%(process)d 進程ID。可能沒有
%(message)s 用戶輸出的消息

#!/usr/bin/env python
# -*- coding:utf-8 -*-
# Author: vita
import logging
logging.basicConfig(format='%(process)d %(threadName)s %(thread)d %(relativeCreated)d %(created)f %(lineno)d %(funcName)s %(module)s %(filename)s %(levelname)s %(levelno)s %(asctime)s %(message)s', datefmt='%m/%d/%Y %I:%M:%S %p')
logging.debug("debug message!")
logging.info("info message!")
logging.warning("warning message!")
logging.critical("critical message!")

E:\PythonProject\python-test\venvP3\Scripts\python.exe E:/PythonProject/python-test/BasicGrammer/test.py
6892 MainThread 13956 0 1557140166.898770 8 <module> test test.py WARNING 30 05/06/2019 06:56:06 PM warning message!
6892 MainThread 13956 0 1557140166.898770 9 <module> test test.py CRITICAL 50 05/06/2019 06:56:06 PM critical message!

Process finished with exit code 0

3.日志同時輸出到屏幕和文件

logger提供了應用程序可以直接使用的接口；
handler將(logger創建的)日志記錄發送到合適的目的輸出；
filter提供了細度設備來決定輸出哪條日志記錄；
formatter決定日志記錄的最終輸出格式

3.1logger

每個程序在輸出信息之前都需要獲得一個logger對象。logger通常對應著模塊名,同時也是生成的日志文件的文件名
Logger=logging.getLogger("modulename")
還可以為他綁定handler和filter
Logger.setLevel(lel):指定最低的日志級別，低于lel的級別將被忽略。debug是最低的內置級別，critical為最高
Logger.addFilter(filt)、Logger.removeFilter(filt):添加或刪除指定的filter
Logger.addHandler(hdlr)、Logger.removeHandler(hdlr)：增加或刪除指定的handler
Logger.debug()、Logger.info()、Logger.warning()、Logger.error()、Logger.critical()：可以用于輸出相應級別的日志

3.2handler

handler對象負責發送相關的信息到指定目的地。Python的日志系統有多種Handler可以使用。StreamHandler可以把日志信息輸出到控制臺，FileHandler可以把日志信息輸出到文件中，可以通過addHandler()為logger對象添加多個handler

Handler.setLevel(lel):指定被處理的信息級別，低于lel級別的信息將被忽略
Handler.setFormatter()：給這個handler選擇一個格式
Handler.addFilter(filt)、Handler.removeFilter(filt)：新增或刪除一個filter對象

3.2.1常用的Handler

1.logging.StreamHandler
使用這個Handler可以向類似與sys.stdout或者sys.stderr的任何文件對象(file object)輸出信息。
2.logging.FileHandler
和StreamHandler 類似，用于向一個文件輸出日志信息。不過FileHandler會幫你打開這個文件
3.logging.handlers.RotatingFileHandler
這個Handler類似于上面的FileHandler，但是它可以管理文件大小。當文件達到一定大小之后，它會自動將當前日志文件改名，然后創建 一個新的同名日志文件繼續輸出。比如日志文件是chat.log。當chat.log達到指定的大小之后，RotatingFileHandler自動把 文件改名為chat.log.1。不過，如果chat.log.1已經存在，會先把chat.log.1重命名為chat.log.2。。。最后重新創建 chat.log，繼續輸出日志信息。它的函數是：

RotatingFileHandler( filename[, mode[, maxBytes[, backupCount]]])
其中filename和mode兩個參數和FileHandler一樣。

maxBytes用于指定日志文件的最大文件大小。如果maxBytes為0，意味著日志文件可以無限大，這時上面描述的重命名過程就不會發生。
backupCount用于指定保留的備份文件的個數。比如，如果指定為2，當上面描述的重命名過程發生時，原有的chat.log.2并不會被更名，而是被刪除。

4.logging.handlers.TimedRotatingFileHandler
這個Handler和RotatingFileHandler類似，不過，它沒有通過判斷文件大小來決定何時重新創建日志文件，而是間隔一定時間就 自動創建新的日志文件。重命名的過程與RotatingFileHandler類似，不過新的文件不是附加數字，而是當前時間。它的函數是：

TimedRotatingFileHandler( filename [,when [,interval [,backupCount]]])
其中filename參數和backupCount參數和RotatingFileHandler具有相同的意義。

interval是時間間隔。

when參數是一個字符串。表示時間間隔的單位，不區分大小寫。它有以下取值：
S 秒
M 分
H 小時
D 天
W 每星期（interval==0時代表星期一）
midnight 每天凌晨

3.3formatter

日志的formatter是個獨立的組件，可以跟handler組合
fh = logging.FileHandler("access.log")
formatter = logging.Formatter('%(asctime)s - %(name)s - %(levelname)s - %(message)s')

fh.setFormatter(formatter) #把formmater綁定到fh上

3.4filter

自定義filter
class IgnoreBackupLogFilter(logging.Filter):
    """忽略帶db backup 的日志"""
    def filter(self, record): #固定寫法
        return   "db backup" not in record.getMessage()
注意filter函數會返加True or False，logger根據此值決定是否輸出此日志
然后把這個filter添加到logger中
logger.addFilter(IgnoreBackupLogFilter())
下面的日志就會把符合filter條件的過濾掉

logger.debug("test ....")
logger.info("test info ....")
logger.warning("start to run db backup job ....")
logger.error("test error ....")

3.5一個同時輸出到屏幕、文件、帶filter的完整例子

#!/usr/bin/env python
# -*- coding:utf-8 -*-
# Author: vita
import logging
class IgnoreBackupLogFilter(logging.Filter):
    """忽略帶db backup 的日志"""
    def filter(self, record): #固定寫法
        return   "db backup" not in record.getMessage()

#console handler
ch = logging.StreamHandler()
ch.setLevel(logging.INFO)
#file handler
fh = logging.FileHandler('mysql.log')
fh.setLevel(logging.WARNING)

#formatter
formatter = logging.Formatter('%(asctime)s - %(name)s - %(levelname)s - %(message)s')
#bind formatter to ch
ch.setFormatter(formatter)
fh.setFormatter(formatter)

logger = logging.getLogger("Mysql")
logger.setLevel(logging.DEBUG) #logger 優先級高于其它輸出途徑的，這里是全局的日志級別設置，默認是warning級別

#add handler   to logger instance
logger.addHandler(ch)
logger.addHandler(fh)

#add filter
logger.addFilter(IgnoreBackupLogFilter())

logger.debug("test ....")
logger.info("test info ....")
logger.warning("start to run db backup job ....")
logger.warning("warning ....")
logger.error("test error ....")

控制臺的日志
E:\PythonProject\python-test\venvP3\Scripts\python.exe E:/PythonProject/python-test/BasicGrammer/test.py
2019-05-06 19:48:24,999 - Mysql - INFO - test info ....
2019-05-06 19:48:24,999 - Mysql - WARNING - warning ....
2019-05-06 19:48:25,000 - Mysql - ERROR - test error ....

Process finished with exit code 0

mysql.log文件中內容
2019-05-06 19:47:49,338 - Mysql - ERROR - test error ....
2019-05-06 19:48:24,999 - Mysql - WARNING - warning ....
2019-05-06 19:48:25,000 - Mysql - ERROR - test error ....

"其中有三處設置了日志級別，最先對日志進行過濾的是logger.setLevel(logging.DEBUG) ,然后剩下的日志，分別由handler的日志級別對日志進行過濾，只有級別高于設置的level的日志才能輸出"

3.6文件自動截斷的例子

#!/usr/bin/env python
# -*- coding:utf-8 -*-
# Author: vita
import logging
import logging

from logging import handlers

logger = logging.getLogger(__name__)

log_file = "timelog.log"
#fh = handlers.RotatingFileHandler(filename=log_file,maxBytes=10,backupCount=3)
fh = handlers.TimedRotatingFileHandler(filename=log_file,when="S",interval=2,backupCount=3)

formatter = logging.Formatter('%(asctime)s %(module)s:%(lineno)d %(message)s')

fh.setFormatter(formatter)

logger.addHandler(fh)

logger.warning("test1")
logger.warning("test12")
logger.warning("test13")
logger.warning("test14")

E:\PythonProject\python-test\venvP3\Scripts\python.exe E:/PythonProject/python-test/BasicGrammer/test.py

Process finished with exit code 0