Python常用庫 - logging日志庫

用作記錄日志，預設分為六種日志級别（括号為級别對應的數值）

NOTSET（0）

DEBUG（10）

INFO（20）

WARNING（30）

ERROR（40）

CRITICAL（50）

在自定義日志級别時注意不要和預設的日志級别數值相同

logging 執行時輸出大于等于設定的日志級别的日志資訊，如設定日志級别是 INFO，則 INFO、WARNING、ERROR、CRITICAL 級别的日志都會輸出。

Logger：日志，暴露函數給應用程式，基于日志記錄器和過濾器級别決定哪些日志有效。

LogRecord ：日志記錄器，将日志傳到相應的處理器處理。

Handler ：處理器, 将(日志記錄器産生的)日志記錄發送至合适的目的地。

Filter ：過濾器, 提供了更好的粒度控制,它可以決定輸出哪些日志記錄。

Formatter：格式化器, 指明了最終輸出中日志記錄的格式。

logging 使用非常簡單，使用  basicConfig()  方法就能滿足基本的使用需要；如果方法沒有傳入參數，會根據預設的配置建立Logger 對象，預設的日志級别被設定為 WARNING，該函數可選的參數如下表所示。

參數名稱

參數描述

filename

日志輸出到檔案的檔案名

filemode

檔案模式，r[+]、w[+]、a[+]

format

日志輸出的格式

datefat

日志附帶日期時間的格式

style

格式占位符，預設為 "%" 和 “{}”

level

設定日志輸出級别

stream

定義輸出流，用來初始化 StreamHandler 對象，不能 filename 參數一起使用，否則會ValueError 異常

handles

定義處理器，用來建立 Handler 對象，不能和 filename 、stream 參數一起使用，否則也會抛出 ValueError 異常

但是當發生異常時，直接使用無參數的  debug() 、 info() 、 warning() 、 error() 、 critical() 方法并不能記錄異常資訊，需要設定  exc_info=True  才可以，或者使用  exception() 方法，還可以使用  log() 方法，但還要設定日志級别和  exc_info 參數

Formatter 對象用來設定具體的輸出格式，常用格式如下表所示

格式

變量描述

%(asctime)s

将日志的時間構造成可讀的形式，預設情況下是精确到毫秒，如 2018-10-13 23:24:57,832，可以額外指定 datefmt 參數來指定該變量的格式

%(name)

日志對象的名稱

%(filename)s

不包含路徑的檔案名

%(pathname)s

包含路徑的檔案名

%(funcName)s

日志記錄所在的函數名

%(levelname)s

日志的級别名稱

%(message)s

具體的日志資訊

%(lineno)d

日志記錄所在的行号

完整路徑

%(process)d

目前程序ID

%(processName)s

目前程序名稱

%(thread)d

目前線程ID

%threadName)s

目前線程名稱