logging模塊

"""
logging 日誌模塊
    什麼是日誌?
    就像生活中的日記 用於記錄什麼時間發生了什麼事情

    爲何要記日誌?
        就是爲了在之後程序出現問題的時候,能經過日誌來找到問題的緣由

    怎麼記日誌
        能夠本身實現
        固然有功能更強大的logging模塊
"""

import logging
# 最基本的用法
logging.debug("debug")
logging.info("info")
logging.warning("warning")
logging.error("error")
logging.critical("critical")

# logging模塊將日誌分爲了五中級別

                                logging.debug() # 10
                                logging.info() # 20
                                logging.warning() # 30
                                logging.error()# 40
                                logging.critical() # 50

# 爲何要分級別? 是爲了在後期查看日誌時候方便定位
# logging的默認顯示級別爲WARNING,低於WARNING級別的都不會別顯示
# 默認輸出位置是終端
# 默認的輸出格式 WARNING(級別):root(日誌生成器的名字):warning(輸出的日誌消息)

# 修改默認行爲
# 日誌模塊中的四種角色
"""
1.logger 日誌生成器      生成一條日誌
2.filter 日誌的過濾器    對logger生成的日誌進行過濾(須要涉及到面向對象)
3.formatter  處理格式的  設置日誌的輸出格式
4.handler 處理器         最終負責將日誌輸出到指定的位置

"""


# 自定義日誌生成器
可用參數:

filename：用指定的文件名建立FiledHandler（後邊會具體講解handler的概念），這樣日誌會被存儲在指定的文件中。
filemode：文件打開方式，在指定了filename時使用這個參數，默認值爲「a」還可指定爲「w」。
format：指定handler使用的日誌顯示格式。
datefmt：指定日期時間格式。
level：設置rootlogger（後邊會講解具體概念）的日誌級別
stream：用指定的stream建立StreamHandler。能夠指定輸出到sys.stderr,sys.stdout或者文件，默認爲sys.stderr。若同時列出了filename和stream兩個參數，則stream參數會被忽略。

可用格式:

%(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：用戶輸出的消息

# 能夠爲生成器指定名字 是由於 能夠存在多個生成器
logger = logging.getLogger("logger1")
# 設置日誌級別
# logging模塊內部使用整數區分級別
# 此處能夠直接寫對應整數,可是建議寫常量
logger.setLevel(logging.WARNING)

# logger.warning("這是一個警告信息")

# 建立一個處理器
handler = logging.FileHandler("test.log","a",encoding="utf-8")

fm = logging.Formatter("%(asctime)s - %(name)s -%(filename)s - %(message)s")

handler.setFormatter(fm)

# 將handler與生成器綁定
# 能夠爲一個生成器指定多個處理器
logger.addHandler(handler)

logger.error("這是一個錯誤信息....")





使用字典配置logging

from conf import settings

# 一堆日誌格式
standard_format = '[%(asctime)s][%(threadName)s:%(thread)d][task_id:%(name)s][%(filename)s:%(lineno)d]' \
                  '[%(levelname)s][%(message)s]' #其中name爲getlogger指定的名字

simple_format = '[%(levelname)s][%(asctime)s][%(filename)s:%(lineno)d]%(message)s'

id_simple_format = '[%(levelname)s][%(asctime)s] %(message)s'




LOGGING_DIC = {
    'version': 1, #只能爲1
    'disable_existing_loggers': False, # 是否禁用已經存在的生成器,一般爲False
    'formatters': { # 不能修改 內部能夠有多個格式處理器
        'standard': { # 是格式處理器的名字 能夠自定義
            'format': standard_format # key不能修改
        },
    },
    'filters': {},
    'handlers': { # key不能修改
        #打印到終端的日誌
        'console': { # 處理的名字 能夠修改
            'level': 'DEBUG',
            'class': 'logging.StreamHandler',  # 打印到屏幕
            'formatter': 'standard' # 指定處理器的格式
        },
        #打印到文件的日誌,收集info及以上的日誌
        'default': {
            'level': 'DEBUG',
            'class': 'logging.handlers.RotatingFileHandler',  # Rotatin日誌輪轉 保存到文件
            'formatter': 'standard',
            'filename': settings.LOG_PATH,  # 日誌文件的路徑
            'maxBytes': 1024*1024*5,  # 日誌大小 5M
            'backupCount': 5,# 最多存在五個日誌文件
            'encoding': 'utf-8',  # 日誌文件的編碼，不再用擔憂中文log亂碼了
        },
    },
    'loggers': {
        #logging.getLogger(__name__)拿到的logger配置
        '': {  #設置爲空
            'handlers': ['default', 'console'],  # 這裏把上面定義的兩個handler都加上，即log數據既寫入文件又打印到屏幕
            'level': 'DEBUG',
            # 'propagate': True,  # 向上（更高level的logger）傳遞
        },
    },
}

# 以上字典中可能須要修改的地方
# 1.日誌文件的路徑
# 2.格式
# 3.生成器的名字


配置方法

import logging.config
logging.config.dictConfig(LOGGING_DIC)
logging.getLogger("aa").debug("測試")
# getLogger參數就是對應字典中loggers的key 若是沒有匹配的key 什麼都不作 不少狀況咱們的日誌可能對應不一樣的業務模塊 咱們須要在日誌中提現業務信息 那問題是 個人配置中不可能預先知道全部的業務名稱 這時候咱們能夠將key設置爲空 這樣同樣來 獲取的時候若是找不到對應的就是用默認的 而且日誌對象的名稱會變成你傳入的key