django 日志logging的配置以及处理

日志在程序开发中是少不了的，通过日志我们可以分析到错误在什么地方，有什么异常。在生产环境下有很大的用途。在Java开发中通常用log4j,logback等第三方组件。那么在django中是怎么处理日志？django利用的就是Python提供的logging模块，但django中要用logging，还得有一定的配置规则，需要在setting中设置。

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配置文件

#导入模块
import logging
import django.utils.log
import logging.handlers
 
 
LOGGING = {
    'version': 1,
    'disable_existing_loggers': True,
    'formatters': {
       'standard': {
            'format': '%(asctime)s [%(threadName)s:%(thread)d] [%(name)s:%(lineno)d] [%(module)s:%(funcName)s] [%(levelname)s]- %(message)s'}  #日志格式 
    },
    'filters': {
    },
    'handlers': {
        'mail_admins': {
            'level': 'ERROR',
            'class': 'django.utils.log.AdminEmailHandler',
            'include_html': True,
        },
        'default': {
            'level':'DEBUG',
            'class':'logging.handlers.RotatingFileHandler',
            'filename': '/sourceDns/log/all.log',     #日志输出文件
            'maxBytes': 1024*1024*5,                  #文件大小 
            'backupCount': 5,                         #备份份数
            'formatter':'standard',                   #使用哪种formatters日志格式
        },
        'error': {
            'level':'ERROR',
            'class':'logging.handlers.RotatingFileHandler',
            'filename': '/sourceDns/log/error.log',
            'maxBytes':1024*1024*5,
            'backupCount': 5,
            'formatter':'standard',
        },
        'console':{
            'level': 'DEBUG',
            'class': 'logging.StreamHandler',
            'formatter': 'standard'
        },
        'request_handler': {
            'level':'DEBUG',
            'class':'logging.handlers.RotatingFileHandler',
            'filename': '/sourceDns/log/script.log', 
            'maxBytes': 1024*1024*5, 
            'backupCount': 5,
            'formatter':'standard',
        },
        'scprits_handler': {
            'level':'DEBUG',
            'class':'logging.handlers.RotatingFileHandler',
            'filename':'/sourceDns/log/script.log', 
            'maxBytes': 1024*1024*5, 
            'backupCount': 5,
            'formatter':'standard',
        }
    },
    'loggers': {
        'django': {
            'handlers': ['default', 'console'],
            'level': 'DEBUG',
            'propagate': False 
        },
        'django.request': {
            'handlers': ['request_handler'],
            'level': 'DEBUG',
            'propagate': False,
        },
        'scripts': { 
            'handlers': ['scprits_handler'],
            'level': 'INFO',
            'propagate': False
        },
        'sourceDns.webdns.views': {
            'handlers': ['default', 'error'],
            'level': 'DEBUG',
            'propagate': True
        },
        'sourceDns.webdns.util':{
            'handlers': ['error'],
            'level': 'ERROR',
            'propagate': True
        }
    } 
}

解析：

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

2.handler：用来定义具体处理日志的方式，可以定义多种，"default"就是默认方式，"console"就是打印到控制台方式。

3.loggers:用来配置用那种handlers来处理日志，比如你同时需要输出日志到文件、控制台。

注意:

1.loggers类型为"django"这将处理所有类型日志。

2.sourceDns.webdns.views 应用的py文件

> views.py代码配置

logger = logging.getLogger('sourceDns.webdns.views')    #刚才在setting.py中配置的logger
 
try:
    mysql= connectMysql('127.0.0.1', '3306', 'david')
except Exception,e:
    logger.error(e)        #直接将错误写入到日志文件

在blog项目配了一个日志配置

# 日志配置 todo 文件路径上线需改
LOGGING = {
    'version': 1,
    'disable_existing_loggers': False,
    'formatters': {
        'verbose': {
            'format': '[%(asctime)s] [%(levelname)s] %(message)s',
        },
        # 以下定时任务错误日志控制台打印格式配置
        'command_error_console_formatter': {
            'format': '[%(levelname)s] [%(filename)s-%(funcName)s-%(name)s:%(lineno)d] <%(message)s>',
        },
        # 以下定时任务错误日志文件记录格式配置
        'command_error_file_formatter': {
            'format': '[%(levelname)s] (%(asctime)s) %(process)d [%(threadName)s:%(thread)d] <%(message)s>',
        },
    },
    'handlers': {
        'console': {
            'class': 'logging.StreamHandler',
        },
        'django_request_console': {
            'class': 'logging.StreamHandler',
        },
        # 以下HTTP请求错误日志文件配置，，每1天做一次日志文件分割，备份数量为50条日志（django_request最多保存50条日志，否则做日志切割）
        'django_request_file': {
            'level': 'WARNING',
            'class':'logging.handlers.TimedRotatingFileHandler',
            # 'filename': '/home/a/logs/django_request.log',
            'filename':'server/local_logs/django_request/django_request',
            'when': 'D',   #  日志分割周期单位为天
            'interval':1,  # 分割周期为1天
            'backupCount':50,
            # 备份数量为50条日志记录，当使用时间分割日志时，又有backupCount时，
            # 只有当备份日志django_request日志数量达到50条时才会做日志切割，
            # 若想严格按时间切割日志，则backupCount不要配置！！！！
            'formatter': 'verbose',
        },
        # 以下定时任务错误日志控制台打印配置
        'command_error_console': {
            'level': 'ERROR',
            'class': 'logging.StreamHandler',
            'formatter': 'command_error_console_formatter',
        },
        # 以下定时任务错误日志文件配置，每1周做一次日志文件分割，备份数量为50条日志
        'command_error_file': {
            'level': 'ERROR',
            'class':'logging.handlers.TimedRotatingFileHandler',
            # 'filename': '/home/a/logs/command_error.log',
            'filename':  'server/local_logs/command_error/command_error',
            'when': 'D',
            'interval':7,
            'backupCount':50,
            'formatter': 'command_error_file_formatter',
        },
        # 以下定时任务执行成功日志文件配置，每1周做一次日志文件分割，备份数量为50条日志
        'command_success_file': {
            'level': 'INFO',
            'class':'logging.handlers.TimedRotatingFileHandler',
            # 'filename': '/home/a/logs/command_success.log',
            'filename':  'server/local_logs/command_success/command_success',
            'when': 'D',
            'interval':7,
            'backupCount':50,
            'formatter': 'command_error_file_formatter',
        },
    },
    'loggers': {
        'django': {
            'handlers': ['console'],
            'propagate': True,
            'level': 'INFO',
        },
        # HTTP请求日志。后端或前端的错误，出现status_code 5XX（error级别），4XX（warning级别）
        'django.request': {
            'handlers': ['django_request_file', 'django_request_console'],
            'level': 'WARNING',
            'propagate': True,
        },
        # 以下定时任务错误logger配置
        'command_error': {
            'handlers': ['command_error_console', 'command_error_file'],
            'propagate': True,
            'level': 'ERROR',
        },
        # 以下定时任务执行成功logger配置
        'command_success': {
            'handlers': ['command_success_file'],
            'propagate': True,
            'level': 'INFO',
        },
    },
}
复制代码