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
},
}
}