Django的日誌系統

日誌在程序開發中是少不了的，經過日誌咱們能夠分析到錯誤在什麼地方，有什麼異常。在生產環境下有很大的用途。在Java開發中一般用log4j,logback等第三方組件。那麼在django中是怎麼處理日誌？django利用的就是Python提供的logging模塊，但django中要用logging，還得有必定的配置規則，須要在setting中設置。下面簡單介紹一下logging。

logging是現成安全的，其主要是由4部分組成：

1. Logger                                                                                                                                                                                                                                                                                                                                                                                                    用戶使用的直接接口，將日誌傳遞給Handler
2. Handler                  　　                                                                                                                                                                                                                                                                                                                                                                        控制日誌輸出到哪裏，console，file… 

　　　　一個logger能夠有多個Handler

　　3.Filter 

　　　　控制哪些日誌能夠從logger流向Handler

　　4.Formatter 

　　　　控制日誌的格式

1、logging模塊

　　logging模塊爲應用程序提供了靈活的手段記錄事件、錯誤、警告和調試信息。對這些信息能夠進行收集、篩選、寫入文件、發送給系統日誌等操做，甚至還能夠經過網絡發送給遠程計算機。

一、日誌記錄級別

　　logging模塊的重點在於生成和處理日誌消息。每條消息由一些文本和指示其嚴重性的相關級別組成。級別包含符號名稱和數字值。

級別	值	描述
CRITICAL	50	關鍵錯誤/消息
ERROR	40	錯誤
WARNING	30	警告消息
INFO	20	通知消息
DEBUG	10	調試
NOTSET	0	無級別

 

 

 

 

 

 

二、記錄器

 　　記錄器負責管理日誌消息的默認行爲，包括日誌記錄級別、輸出目標位置、消息格式以及其它基本細節。

關鍵字參數	描述
filename	將日誌消息附加到指定文件名的文件
filemode	指定用於打開文件模式
format	用於生成日誌消息的格式字符串
datefmt	用於輸出日期和時間的格式字符串
level	設置記錄器的級別
stream	提供打開的文件，用於把日誌消息發送到文件。

 

 

 

 

 

 

三、format 日誌消息格式

格式	描述
%(name)s	記錄器的名稱
%(levelno)s	數字形式的日誌記錄級別
%(levelname)s	日誌記錄級別的文本名稱
%(filename)s	執行日誌記錄調用的源文件的文件名稱
%(pathname)s	執行日誌記錄調用的源文件的路徑名稱
%(funcName)s	執行日誌記錄調用的函數名稱
%(module)s	執行日誌記錄調用的模塊名稱
%(lineno)s	執行日誌記錄調用的行號
%(created)s	執行日誌記錄的時間
%(asctime)s	日期和時間
%(msecs)s	毫秒部分
%(thread)d	線程ID
%(threadName)s	線程名稱
%(process)d	進程ID
%(message)s	記錄的消息

 

 

 

 

 

 

 

 

 

 

 

 

 

 

四、內置處理器

　　logging模塊提供了一些處理器，能夠經過各類方式處理日誌消息。使用addHandler()方法將這些處理器添加給Logger對象。另外還能夠爲每一個處理器配置它本身的篩選和級別。

      handlers.DatagramHandler(host，port):發送日誌消息給位於制定host和port上的UDP服務器。

      handlers.FileHandler(filename):將日誌消息寫入文件filename。

      handlers.HTTPHandler(host, url):使用HTTP的GET或POST方法將日誌消息上傳到一臺HTTP 服務器。

      handlers.RotatingFileHandler(filename):將日誌消息寫入文件filename。若是文件的大小超出maxBytes制定的值，那麼它將被備份爲filename1。

    因爲內置處理器還有不少，若是想更深刻了解。能夠查看官方手冊。

2、Django使用logging記錄日誌

 如今大概瞭解了logging的使用方法，如今能夠結合django使用。

setting.py配置文件

在最後面的加上logging的配置

BASE_LOG_DIR = os.path.join(BASE_DIR, "log")
LOGGING = {
    'version': 1,  # version表示版本，通常不用改
    # disable_existing_loggers表示棄用已經存在的日誌，True表示棄用，False表示不棄用。
    'disable_existing_loggers': False,  # 禁用已經存在的logger實例
    # 日誌文件的格式
    'formatters': {
        # 詳細的日誌格式
        'verbose': {
            'format': '[%(asctime)s][%(threadName)s:%(thread)d][task_id:%(name)s][%(filename)s:%(lineno)d]'
                      '[%(levelname)s][%(message)s]'
        },
        # 標準的日誌格式
        'standard': {
            'format': '[%(levelname)s][%(asctime)s][%(filename)s:%(lineno)d]%(message)s'
        },
        # 簡單的日誌格式
        'simple': {
            'format': '[%(levelname)s][ %(message)s]'
        },

        # 定義一個特殊的日誌格式
        'collect': {
            'format': '%(message)s'
        }
    },
    # 上面的日誌格式能夠本身隨便定義幾個
    # 過濾器
    'filters': {

    },
    # 處理器
    'handlers': {
        # 在終端打印
        'console': {
            'level': 'DEBUG',  # 日誌的級別
            'class': 'logging.StreamHandler',  #
            'formatter': 'simple'  # 使用哪一種日誌格式
        },
        # 默認的
        'default': {
            'level': 'INFO',
            'class': 'logging.handlers.RotatingFileHandler',  # 保存到文件，自動切
            'filename': os.path.join(BASE_LOG_DIR, "xxx_info.log"),  # 日誌文件的位置
            'maxBytes': 1024 * 1024 * 50,  # 日誌大小 50M
            'backupCount': 3,  # 最多備份幾個
            'formatter': 'standard',  # 使用哪一種日誌格式
            'encoding': 'utf-8',  # 保存的格式
        },
        # 專門用來記錯誤日誌
        'error': {
            'level': 'ERROR',
            'class': 'logging.handlers.RotatingFileHandler',  # 保存到文件，自動切
            'filename': os.path.join(BASE_LOG_DIR, "xxx_err.log"),  # 日誌文件
            'maxBytes': 1024 * 1024 * 50,  # 日誌大小 50M
            'backupCount': 5,
            'formatter': 'standard',
            'encoding': 'utf-8',
        },
        # 專門定義一個收集特定信息的日誌
        'collect': {
            'level': 'INFO',
            'class': 'logging.handlers.RotatingFileHandler',  # 保存到文件，自動切
            'filename': os.path.join(BASE_LOG_DIR, "xxx_collect.log"),
            'maxBytes': 1024 * 1024 * 50,  # 日誌大小 50M
            'backupCount': 5,
            'formatter': 'collect',
            'encoding': "utf-8"
        }
    },
    # 上面的處理器能夠根據本身的需求來配置
    'loggers': {
        # 默認的logger應用以下配置
        '': {
            'handlers': ['default', 'console', 'error'],  # 上線以後能夠把'console'移除
            'level': 'DEBUG',
            'propagate': True,  # 向不向更高級別的logger傳遞
        },
        # 名爲 'collect'的logger還單獨處理
        'collect': {
            'handlers': ['console', 'collect'],
            'level': 'INFO',
        }
    },
}

View Code

 

解析：

 1.formatters：配置打印日誌格式

 2.handler：用來定義具體處理日誌的方式，能夠定義多種，"default"就是默認方式，"console"就是打印到控制檯方式。

 3.loggers:用來配置用那種handlers來處理日誌，好比你同時須要輸出日誌到文件、控制檯。

 在views.py裏使用

import logging

# 生成一個以當前文件名爲名字的logger實例
logger = logging.getLogger(__name__)
# 生成一個名爲collect的logger實例
collect_logger = logging.getLogger("collect")


def index(request):
    logger.debug("這是一個調試信息1....")
    logger.info("這是一個信息")
    logger.debug("這是一個調試信息2....")

    collect_logger.info("用戶：北京")

    return HttpResponse("OK")