1.日志基础知识
日志与我们的软件程序密不可分。它记录了程序的运行情况,可以给我们调试程序和故障排查提供非常有用的信息。每一条日志信息记录了一个事件的发生。具体而言,它包括了:
- 事件发生时间
- 事件发生位置
- 事件的严重程度--日志级别
- 事件内容
日志的级别又分为:
- DEBUG:用于调试目的的低级系统信息
- INFO:一般系统信息
- WARNING:描述已发生的小问题的信息。
- ERROR:描述已发生的主要问题的信息。
- CRITICAL:描述已发生的严重问题的信息。
在Django项目中,我们可以针对日志的不同级别设置不同的处理方式。比如INFO级别及以上的日志我们写入到log文件里保存,Error级别及以上的日志我们直接通过邮件发送给系统管理员。
2.Django的日志模块
Django的日志模块其实就是python的logging模块。它由4部分组成:
- Logger 记录仪:生成和记录每条日志信息及级别
- Handler处理程序: 根据日志信息级别交由相应处理程序处理(比如生成文件或发送邮件)
- Filters 过滤器:日志交由处理程序处理前需要满足的过滤条件(比如Debug=True或False)
- Formaters 格式化程序:决定每条日志的打印输出格式,可以有完整版的,也有简单版的
2.1 Loggers
1)Logger 即记录器,是日志系统的入口。它有三个重要的工作:
- 向应用程序(也就是你的项目)公开几种方法,以便运行时记录消息
- 根据传递给 Logger 的消息的严重性,确定消息是否需要处理
- 将需要处理的消息传递给所有感兴趣的处理器 Handler
2) 每一条写入 Logger 的消息都是一条日志记录,每一条日志记录都包含级别,代表对应消息的严重程度。如下等级:
DEBUG: 排查故障时使用的低级别系统信息,通常开发时使用 INFO: 一般的系统信息,并不算问题 WARNING: 描述系统发生小问题的信息,但通常不影响功能 ERROR: 描述系统发生大问题的信息,可能会导致功能不正常 CRITICAL:描述系统发生严重问题的信息,应用程序有崩溃的风险
3) 当 Logger 处理一条消息时,会将自己的日志级别和这条消息配置的级别做对比。如果消息的级别匹配或者高于 Logger 的日志级别,它就会被进一步处理,否则这条消息就会被忽略掉。
4) 当 Logger 确定了一条消息需要处理之后,会把它传给 Handler。
2.2 Handlers
Handler 即处理器,它的主要功能是决定如何处理 Logger 中的每一条消息,比如把消息输出到屏幕、文件或者 Email 中。
和 Logger 一样,Handler 也有级别的概念。如果一条日志记录的级别不匹配或者低于 Handler 的日志级别,则会被 Handler 忽略。
一个 Logger 可以有多个 Handler,每一个 Handler 可以有不同的日志级别。这样就可以根据消息的重要性不同,来提供不同类型的输出。例如,你可以添加一个 Handler 把 ERROR 和 CRITICAL 消息发到你的 Email,再添加另一个 Handler 把所有的消息(包括 ERROR 和 CRITICAL 消息)保存到文件里。
2.3 Filters
Filter 即过滤器。在日志记录从 Logger 传到 Handler 的过程中,使用 Filter 来做额外的控制。例如,只允许某个特定来源的 ERROR 消息输出。
Filter 还被用来在日志输出之前对日志记录做修改。例如,当满足一定条件时,把日志级别从 ERROR 降到 WARNING 。
Filter 在 Logger 和 Handler 中都可以添加,多个 Filter 可以链接起来使用,来做多重过滤操作。
2.4 Formaters
Formatter 即格式化器,主要功能是确定最终输出的形式和内容。
3.settings.py推荐日志配置信息
# 给ADMINS发送邮件需要配置 ADMINS = ( ('admin_name','[email protected]'), ) MANAGERS = ADMINS # 创建log文件的文件夹 LOG_DIR = os.path.join(BASE_DIR, "logs") # 基本配置,可以复用的 LOGGING = { "version": 1, "disable_existing_loggers": False, "filters": {"require_debug_false": {"()": "django.utils.log.RequireDebugFalse"}}, "formatters": { # 定义了两种日志格式 "verbose": { # 标准 "format": "%(levelname)s %(asctime)s %(module)s " "%(process)d %(thread)d %(message)s" }, 'simple': { # 简单 'format': '[%(levelname)s][%(asctime)s][%(filename)s:%(lineno)d]%(message)s' }, }, "handlers": { # 定义了三种日志处理方式 "mail_admins": { # 只有debug=False且Error级别以上发邮件给admin "level": "ERROR", "filters": ["require_debug_false"], "class": "django.utils.log.AdminEmailHandler", }, 'file': { # Info级别以上保存到日志文件 'level': 'INFO', # 输出日志等级 'class': 'logging.handlers.RotatingFileHandler', # 日志类型 'filename': os.path.join(LOG_DIR,"info.log"), # 日志文件 'maxBytes': 1024 * 1024 * 10, # 日志大小 10M 'backupCount': 2, # 备份数为 2 'formatter': 'simple', # 简单格式 'encoding': 'utf-8', }, "console": { # 打印到终端console "level": "DEBUG", "class": "logging.StreamHandler", "formatter": "verbose", }, }, "root": {"level": "INFO", "handlers": ["console"]}, "loggers": { "django.request": { # Django的request发生error会自动记录 "handlers": ["mail_admins"], "level": "ERROR", "propagate": True, # 向不向更高级别的logger传递 }, "django.security.DisallowedHost": { # 对于不在 ALLOWED_HOSTS 中的请求不发送报错邮件 "level": "ERROR", "handlers": ["console", "mail_admins"], "propagate": True, }, }, }
标签:logging,Django,Handler,消息,设置,ERROR,日志,级别,Logger From: https://www.cnblogs.com/shaoyishi/p/17018573.html