Django日志配置

技术分享 2年前 (2023-02-15) 0 999+

关注

Django使用Python内建的logging模块打印日志,配置由四个部分组成

记录器:Logger
处理程序:Handler
过滤器:Filter
格式化:formatter

记录器-Logger

Logger为日志系统的入口,每个logger命名都是bucket,可以向bucket写入需要处理的消息

Python定义以及几种日志级别:

DEBUG:用于调试目的的日志
INFO:普通的系统消息
WARNING:表示出现一个较小的问题
ERROR:表示出现一个较大的问题
CRITICAL:表示出现一个致命的问题

处理逻辑:

当一条消息传递给Logger的时候,消息的日志级别将与logger的日志级别进行比较

如果消息的日志级别大于等于logger的日志消息,该消息绩效往下处理,如果小于,该消息被忽略

Logger一旦决定消息需要处理,它将传递该消息给一个Handler

logger日志级别

级别	值	描述
CRITICAL	50	关键错误/消息
ERROR	40	错误
WARNING	30	警告消息
INFO	20	通知消息
DEBUG	10	调试
NOTSET	0	无级别

logger配置

logger对应的值是字典,其中每一个健都是logger的名字,每一个值又是个字典

level(可选) - logger的级别
propagate(可选) - logger的传播设置
filters(可选) - logger的fillter的标识符列表
handlers(可选) - logger的handler的标识符列表

配置示例

#settings LOGGING = {      #记录器     'loggers': {         'reboot': {             'handlers': ['reboot'],             'level': 'INFO',         }     } }  '''  level配置的日志级别为INFO 那么在程序中 如果使用logger.DEBUG,DEBUG级别小于INFO,则不会处理 如果是大于等于INFO，则会交给handlers处理日志 '''

处理程序-Handler

handler决定如何处理logger中的每条消息,它表示一个特定的日志行为,例如将消息写到屏幕、文件中或者网络socket

与logger一样,handler也有一个日志解蔽,如果消息的日志级别小于handler的级别,handler将忽略这条消息

logger可以有多个handler,而每个handler可以有不同的日志级别

#配置示例 settings LOGGING = {     # 记录器         'loggers': {         'reboot': {             'handlers': ['reboot'], # 处理器对应下方handlers中的reboot             'level': 'INFO',         }     },     # 处理器     'handlers': {         'reboot': {             'level': 'INFO',             'class': 'logging.StreamHandler', # 以流的形式写入             'formatter': 'reboot', # 指定交给哪个格式化处理         }     } } ''' loggers中的reboot,定义级别为INFO,如果满足INFO级别,交给handlers处理,loggers中的handler配置的是reboot 在下发的handlers配置reboot的具体处理方式 '''

class

logging.StreamHandler	                         类似与sys.stdout或者sys.stderr的任何文件对象(file object)输出信息 logging.FileHandler	                             将日志消息写入文件filename。 logging.handlers.DatagramHandler(host，port)     发送日志消息给位于制定host和port上的UDP服务器。使用UDP协议，将日志信息发送到网络 logging.handlers.HTTPHandler(host, url) 	     使用HTTP的GET或POST方法将日志消息上传到一台HTTP 服务器。 logging.handlers.RotatingFileHandler(filename)   将日志消息写入文件filename。如果文件的大小超出maxBytes制定的值，那么它将被备份为filenamel。 logging.handlers.SocketHandler	                 使用TCP协议，将日志信息发送到网络。 logging.handlers.SysLogHandler	                 日志输出到syslog logging.handlers.NTEventLogHandler	             远程输出日志到Windows NT/2000/XP的事件日志 logging.handlers.SMTPHandler	                 远程输出日志到邮件地址 logging.handlers.MemoryHandler	                 日志输出到内存中的指定buffer

过滤器-Filters

filter用于对从logger传递给handler的日志记录进行额外的控制

默认情况满足日志级别的任何消息都被处理,可以使用filter,对日志处理添加额外的条件,例如只允许处理特定源的ERROR消息

filters还可以用于修改将要处理的日志记录的优先级,例如日志满足特定条件,可以通过filter将日志记录从ERROR降到WARNING

filters可以在logger上或者handler上，多个filter可以串联起来实现多层的filter行为

格式化-Formatters

日志记录需要转换成文本或者其他格式 ,formatter表示文本的格式

formatter通常由包含日志记录属性的Python格式字符串组成

消息日志格式

#配置示例  LOGGING = {     'version': 1,  # 版本     'disable_existing_loggers': False,# 默认为True，True：设置已存在的logger失效。False：让已存在的logger不失效，保证日志信息完整。一般情况下设置为False     # 记录器     'loggers': {         'reboot': {             'handlers': ['reboot'],             'level': 'INFO',         }     },     # 处理器     'handlers': {         'reboot': {             'level': 'INFO',             'class': 'logging.StreamHandler',             'formatter': 'reboot',  # 指定         }     },     # 格式化     'formatters': {         'reboot': {             'format': '%(asctime)s - %(pathname)s:%(lineno)d[%(levelname)s] - %(message)s'         }     } }

日志使用

import logging # 生成logger对象 参数指定交给哪个loggers处理 # 不传参可走Django内置的配置 logger = logging.getLogger('reboot')   logger.info('xxx')

Django内置logger

django-获取所有日志
django.request-处理与请求相关的日志,5xx响应报出ERROR日志,4xx报出warning日志
django.db.backends-处理与数据库之间交互的日志
django.security.* -处理与安全相关的日志
django.db.backends.schemea-处理数据库迁移时的日志

可用完整配置

# 日志配置 cur_path = os.path.dirname(os.path.realpath(__file__))  # log_path是存放日志的路径 log_path = os.path.join(os.path.dirname(cur_path), 'Log')  LOGGING = {     'version': 1,     'disable_existing_loggers': True,     'formatters': {         # 日志格式         'standard': {             'format': '[%(asctime)s] [%(filename)s:%(lineno)d] [%(module)s:%(funcName)s] '                       '[%(levelname)s]- %(message)s'},         'simple': {  # 简单格式             'format': '%(levelname)s %(message)s'         },     },     # 过滤     'filters': {     },     # 定义具体处理日志的方式     'handlers': {         # 默认记录所有日志         'default': {             'level': 'INFO',             'class': 'logging.handlers.RotatingFileHandler',             'filename': os.path.join(log_path, 'django.log'.format(time.strftime('%Y-%m'))),             'maxBytes': 1024 * 1024 * 5,  # 文件大小             'backupCount': 5,  # 备份数             'formatter': 'standard',  # 输出格式             'encoding': 'utf-8',  # 设置默认编码，否则打印出来汉字乱码         },         # 输出错误日志         'error': {             'level': 'ERROR',             'class': 'logging.handlers.RotatingFileHandler',             'filename': os.path.join(log_path, 'error-{}.log'.format(time.strftime('%Y-%m'))),             'maxBytes': 1024 * 1024 * 5,  # 文件大小             'backupCount': 5,  # 备份数             'formatter': 'standard',  # 输出格式             'encoding': 'utf-8',  # 设置默认编码         },         # 控制台输出         'console': {             'level': 'DEBUG',             'class': 'logging.StreamHandler',             'formatter': 'standard'         },         # 输出info日志         'info': {             'level': 'INFO',             'class': 'logging.handlers.RotatingFileHandler',             'filename': os.path.join(log_path, 'info-{}.log'.format(time.strftime('%Y-%m'))),             'maxBytes': 1024 * 1024 * 5,             'backupCount': 5,             'formatter': 'standard',             'encoding': 'utf-8',  # 设置默认编码         },     },     # 配置用哪几种 handlers 来处理日志     'loggers': {         # 类型 为 django 处理所有类型的日志， 默认调用         'django': {             'handlers': ['default', 'console'],             'level': 'INFO',             'propagate': False         },         # log 调用时需要当作参数传入         'log': {             'handlers': ['error', 'info', 'console', 'default'],             'level': 'INFO',             'propagate': True         },     } }

发表评论