特点
- 配置简单,易于上手
- 一个日志文件中只能某一个级别的日志
- 一个类中可以指定多个不同的日志,并且生成的每个日志文件中只包含其本身的内容
- 可以关闭或者打开某几个包的日志,并且可以设置不同的包使用不同的日志级别
一、易用性
logback的易用性不用多讲,只需要通过下面两行就可以在console中输出日志:
Logger debugLogger = LoggerFactory.getLogger(MyClass.class);
logger.info("This is a log");
程序运行时,logback会查找默认的配置文件logback.xml或者logback-test.xml文件,如果没有找到它就会使用默认的配置,将日志打印到console中。下面是一个配置文件示例:
<?xml version="1.0" encoding="UTF-8" ?>
<configuration>
<!-- 设置日志输出根目录 -->
<property name="log.dir" value="logs" />
<property name="encoding" value="UTF-8" />
<property name="pattern"
value="%d{yyyy-MM-dd.HH:mm:ss} %-5level [%thread] %logger.%M:%L %msg%n" />
<!-- 控制台输出日志 -->
<appender name="STDOUT" class="ch.qos.logback.core.ConsoleAppender">
<layout class="ch.qos.logback.classic.PatternLayout">
<pattern>${pattern}</pattern>
</layout>
</appender>
<!-- 主日志 -->
<appender name="FILE"
class="ch.qos.logback.core.rolling.RollingFileAppender">
<File>main.log</File>
<filter class="ch.qos.logback.classic.filter.ThresholdFilter">
<level>INFO</level>
</filter>
<file>${log.dir}/main.log</file>
<prudent>false</prudent>
<encoder charset="UTF-8">
<pattern>${pattern}</pattern>
</encoder>
<rollingPolicy class="ch.qos.logback.core.rolling.TimeBasedRollingPolicy">
<fileNamePattern>${log.dir}/main.%d{yyyy-MM-dd-HH}.log.gz</fileNamePattern>
</rollingPolicy>
</appender>
<!-- 错误日志 -->
<appender name="ERROR_FILE"
class="ch.qos.logback.core.rolling.RollingFileAppender">
<File>error.log</File>
<filter class="ch.qos.logback.classic.filter.ThresholdFilter">
<level>ERROR</level>
</filter>
<file>${log.dir}/error.log</file>
<prudent>false</prudent>
<encoder charset="UTF-8">
<pattern>${pattern}</pattern>
</encoder>
<rollingPolicy class="ch.qos.logback.core.rolling.TimeBasedRollingPolicy">
<fileNamePattern>${log.dir}/error.%d{yyyy-MM-dd-HH}.log.gz</fileNamePattern>
</rollingPolicy>
</appender>
<logger name="com.qunar.fresh2017.exam1">
<level value="INFO" />
<appender-ref ref="STDOUT" />
<appender-ref ref="FILE" />
<appender-ref ref="ERROR_FILE" />
</logger>
</configuration>
二、日志级别限制
在多数的Log工具中,级别是可以传递,例如如果指定了日志输出级别为DEBUG,那么INFO、ERROR级别的log也会出现在日志文件。这种默认给程序的调试带来了很多的麻烦。而在logback中可以通过appender中的filter来严格限制日志的输出级别:
<filter class="ch.qos.logback.classic.filter.LevelFilter">
<level>INFO</level>
<onMatch>ACCEPT</onMatch>
<onMismatch>DENY</onMismatch>
</filter>
上面的设置中只会在文件中出现级别为INFO的日志内容。
三、同一个类中包含不同的日志
有时候一个类中可能要求打印不同的日志信息,例如有的用来调试,有的用来记录程序运行中的某些参数的变化等等。这时候可以通过下面的语句声明不同的日志:
<appender name="monitor" class="ch.qos.logback.core.rolling.RollingFileAppender">
<File>${log.dir}/monitor.log</File>
<encoder>
<pattern>%d{yyyy-MM-dd HH:mm:ss.SSS} : %m%n</pattern>
</encoder>
<filter class="ch.qos.logback.classic.filter.ThresholdFilter">
<level>INFO</level>
</filter>
<rollingPolicy class="ch.qos.logback.core.rolling.TimeBasedRollingPolicy">
<fileNamePattern>${log.dir}/sensitive.log.%d{yyyy-MM-dd}</fileNamePattern>
</rollingPolicy>
</appender>
# 这里通过设置additivity="false"禁止monitor里的内容向上传递,否则会同时显示在默认的日志中。
<logger name="monitor" additivity="false" level="INFO">
<span style="white-space:pre"></span>
<appender-ref ref="monitor" />
<span style="white-space:pre"></span>
</logger>
Logger debugLogger = LoggerFactory.getLogger(MyClass.class);
Logger monitorLogger = LoggerFactory.getLogger("monitor");
四、精确控制日志的应用范围
在程序调试中,经常出现的情况是:错误只在某一个或者几个类或者包里,所以只需要打开这几个类或者包里的DEBUG级别的log。在以前的项目,使用spring和hibernate时,一旦打开DEBUG级别的log,程序本身的debug信息就会被Spring和Hibernate的大量日志淹没,大大降低了调试的效率。而logback让这一切变的简单起来了:
<logger name="org" level="ERROR" />
这一行就将org包下面的所有日志级别设为了ERROR,不会再打扰我们的DEBUG。