Log4j2配置文件节点解析
其他
Configuration
根节点Configuration有两个属性:status和monitorinterval;有两个子节点:Appenders和Loggers(可以定义多个Appender和Logger)。
- status:用来指定log4j2本身的打印日志的级别。
- monitorinterval:用于指定log4j自动重新配置的监测间隔时间,单位是s,最小是5s。
Appenders
Appenders节点,常见的子节点有:Console、RollingFile、File、SMTP。
Console
Console节点用来定义输出到控制台的Appender。
- name:指定Appender的名字。
- target:SYSTEM_OUT 或 SYSTEM_ERR,一般只设置默认:SYSTEM_OUT。
- PatternLayout:输出格式,不设置默认为:%m%n。
File
File节点用来定义输出到指定位置的文件的Appender。
- name:指定Appender的名字。
- fileName:指定输出日志的目的文件带全路径的文件名。
- PatternLayout:输出格式,不设置默认为:%m%n。
RollingFile
RollingFile节点用来定义超过指定大小自动删除旧的创建新的的Appender。
- name:指定Appender的名字。
- fileName:指定输出日志的目的文件带全路径的文件名。
- PatternLayout:输出格式,不设置默认为:%m%n。
- filePattern:指定新建日志文件的名称格式。
- Policies是指定滚动日志的策略,就是什么时候进行新建日志文件输出日志。
- TimeBasedTriggeringPolicy:Policies子节点,基于时间的滚动策略,interval属性用来指定多久滚动一次,默认是1 hour。modulate=true用来调整时间:比如现在是早上3am,interval是4,那么第一次滚动是在4am,接着是8am,12am...而不是7am。
- SizeBasedTriggeringPolicy:Policies子节点,基于指定文件大小的滚动策略,size属性用来定义每个日志文件的大小。
- DefaultRolloverStrategy:用来指定同一个文件夹下最多有几个日志文件时开始删除最旧的,创建新的(通过max属性)。
SMTP
RollingFile节点用来定义错误日志邮件发送功能。
- name:指定SMTP的名字
- subject:邮件的主题
- to:邮件发送的目标地址
- from:邮件的发送地址
- smtpHost:服务器 例:smtp.163.com
- smtpUsername:用户名
- smtpPassword:密码
- bufferSize:信件中所能包含的最大log 结果量
Loggers
Loggers节点,常见子节点有:Root和Logger。
Root
Root节点用来指定项目的根日志,如果没有单独指定Logger,那么就会默认使用该Root日志输出
- level:日志输出级别,共有8个级别,按照从低到高为:All < Trace < Debug < Info < Warn < Error < Fatal < OFF。
- AppenderRef:Root的子节点,用来指定该日志输出到哪个Appender。
Logger
Logger节点用来单独指定日志的形式,比如要为指定包下的class指定不同的日志级别等。
- level:日志输出级别,共有8个级别,按照从低到高为:All < Trace < Debug < Info < Warn < Error < Fatal < OFF。
- name:用来指定该Logger所适用的类或者类所在的包全路径,继承自Root节点。
- AppenderRef:Logger的子节点,用来指定该日志输出到哪个Appender,如果没有指定,就会默认继承自Root.如果指定了,那么会在指定的这个Appender和Root的Appender中都会输出,此时我们可以设置Logger的additivity="false"只在自定义的Appender中进行输出。
关于日志level
共有8个级别,按照从低到高为:All < Trace < Debug < Info < Warn < Error < Fatal < OFF。
- All:最低等级的,用于打开所有日志记录。
- Trace:是追踪,就是程序推进以下,你就可以写个trace输出,所以trace应该会特别多,不过没关系,我们可以设置最低日志级别不让他输出。
- Debug:指出细粒度信息事件对调试应用程序是非常有帮助的。
- Info:消息在粗粒度级别上突出强调应用程序的运行过程。
- Warn:输出警告及warn以下级别的日志。
- Error:输出错误信息日志。
- Fatal:输出每个严重的错误事件将会导致应用程序的退出的日志。
- OFF:最高等级的,用于关闭所有日志记录。
程序会打印高于或等于所设置级别的日志,设置的日志等级越高,打印出来的日志就越少。
参考文档:
聊一聊log4j2配置文件log4j2.xml
Log4j2配置之Appenders