一.日志事件的信息流程如下:
二. 一份日志配置由Loggers
、Handlers
、Filters
、Formatters
四部分组成:
Loggers
Logger
即记录器,是日志系统的入口。它有三个重要的工作:
- 向应用程序(也就是你的项目)公开几种方法,以便运行时记录消息
- 根据传递给Logger的消息的严重性,确定出需要处理的消息
- 将需要处理的消息传递给所有感兴趣的处理器(
Handler
)
每一条写入logger的消息都是一条日志记录。每一条日志记录也包含级别,代表对应消息的严重程度。常用的级别如下:
DEBUG
:排查故障时使用的低级别系统信息,通常开发时使用INFO
:一般的系统信息,并不算问题WARNING
:描述系统发生的小问题的信息,但通常不影响功能ERROR
:描述系统发生的大问题的信息,可能会导致功能不正常CRITICAL
:描述系统发生严重问题的信息,应用程序有崩溃风险
当logger处理一条消息时,会将自己的日志级别和这条消息的日志级别做对比。如果消息的级别匹配或者高于logger的日志级别,它就会被进一步处理;否则这条消息就会被忽略掉。
当logger确定了一条消息需要处理之后,会把它传给Handler
。
Handlers
Handler
即处理器,它的主要功能是决定如何处理logger中每一条消息,比如把消息输出到屏幕、文件或者Email中。
和logger一样,handler也有级别的概念。如果一条日志记录的级别不匹配或者低于handler的日志级别,则会被handler忽略。
一个logger可以有多个handler,每一个handler可以有不同的日志级别。这样就可以根据消息的重要性不同,来提供不同类型的输出。例如,你可以添加一个handler把ERROR
和CRITICAL
消息发到你的Email,再添加另一个 handler把所有的消息(包括ERROR
和CRITICAL
消息)保存到文件里。
Filters
Filter
即过滤器。在日志记录从logger传到handler的过程中,使用Filter
来做额外的控制。例如只允许某个特定来源的ERROR
消息输出。
Filter还被用来在日志输出之前对日志记录做修改。例如当满足一定条件时,把日志记录从 ERROR
降到 WARNING
级别。
Filter在logger和handler中都可以添加;多个filter可以链接起来使用,来做多重过滤操作。
Formatters
Formatter
即格式化器,主要功能是确定最终输出的形式和内容。