logback.xml配置文件详解

logback.xml常用配置详解

1、根节点<configuration>，包含三个属性

• scan：当此属性设置为true时，配置文件如果发生改变，将会被重新加载，默认值为true；
• scanPeriod：设置监测配置文件是否有修改的时间间隔，如果没有给出时间单位，默认单位是毫秒。当scan为true时，此属性生效。默认的间隔时间为1分钟；
• debug：当此属性设置为true时，将打印出logback内部日志信息，实时查看logback运行状态。默认值为false。

示例：

<configuration scan="true" scanPeriod="60" debug="false"> 
　　  <!--其他配置省略--> 
</configuration>

2、子节点<appender>：负责写日志的组件，它有两个必要属性name和class。name指定appender名称，class指定appender的权限定名。

下文只简述常见的appder，其他appender使用请参考官方文档。

2.1、ConsoleAppender把日志输出到控制台，有以下子节点：

• <encoder>：对日志进行格式化；
• <target>：字符串System.out（默认）或者System.err

示例：把大于等于DEBUG级别的日志都输出到控制台

<configuration> 
　　　<appender name="STDOUT" class="ch.qos.logback.core.ConsoleAppender"> 
　　　　　 <encoder> 
　　　　　　　　　<pattern>%-4relative [%thread] %-5level %logger{35} - %msg %n</pattern> 
　　　　　 </encoder> 
　　　</appender> 

　　　<root level="DEBUG"> 
　　　　　　<appender-ref ref="STDOUT" /> 
　　　</root> 
</configuration>

2.2、FileAppender：把日志添加到文件，有以下子节点：

• <file>：被写入的文件名，可以是相对目录，也可以是绝对目录，如果上级目录不存在会自动创建，没有默认值；
• <appender>：如果是true，日志被追加到文件结尾，如果是false，清空现存文件，默认是true；
• <encoder>：对记录事件进行格式化；
• <prudent>：如果是true，日志会被安全的写入文件，即使其他的FileAppender也在向此文件做写入操作，效率低，默认是false。

示例：把大于等于DEBUG级别的日志都输出到testFile.log

<configuration> 
　　　<appender name="STDOUT" class="ch.qos.logback.core.ConsoleAppender"> 
　　　　　 <encoder> 
　　　　　　　　　<pattern>%-4relative [%thread] %-5level %logger{35} - %msg %n</pattern> 
　　　　　 </encoder> 
　　　</appender> 

　　　<root level="DEBUG"> 
　　　　　　<appender-ref ref="STDOUT" /> 
　　　</root> 
</configuration>

2.3、RollingFileAppender：滚动记录文件，先将日志记录到指定文件，当符合某个条件时，将日志记录到其他文件，有以下几个子节点：

• <file>：被写入的文件名，可以是相对目录，也可以是绝对目录，如果上级目录不存在会自动创建，没有默认值；
• <append>：如果是true，日志被追加到文件结尾，如果是false，清空现存文件，默认是true；
• <rollingPolicy>：当发生滚动时，决定RollingFileAppender的行为，涉及文件移动和重命名。属性class定义具体的滚动策略类。

 

参考：

• https://www.cnblogs.com/gavincoder/p/10091757.html