django日志官方文档https://docs.djangoproject.com/en/1.11/topics/logging/
本文摘自http://davidbj.blog.51cto.com/4159484/1433741
日志在程序开发中是少不了的,通过日志我们可以分析到错误在什么地方,有什么异常。在生产环境下有很大的用途。在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配置文件
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
|
#导入模块 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代码配置
1
2
3
4
5
6
|
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',
},
},
}
复制代码