使用logback轻松管理日志

最近才开始在项目中使用logback，因为它很轻易的满足了我的几个需求：

 

1. 配置简单，易于上手

2. 一个日志文件中只能某一个级别的日志

3. 一个类中可以指定多个不同的日志，并且生成的每个日志文件中只包含其本身的内容

4. 可以关闭或者打开某几个包的日志，并且可以设置不同的包使用不同的日志级别。

 

一、易用性

logback的易用性不用多讲，只需要通过下面两行就可以在console中输出日志：

 

01.<pre class="html" name="code">Logger debugLogger = LoggerFactory.getLogger(MyClass.class);  
02.</pre>logger.info("This is a log");  

Logger debugLogger = LoggerFactory.getLogger(MyClass.class);

Logger debugLogger = LoggerFactory.getLogger(MyClass.class);

logger.info("This is a log");

程序运行时，logback会查找默认的配置文件logback.xml或者logback-test.xml文件，如果没有找到它就会使用默认的配置，将日志打印到console中。下面是一个简单配置文件（http://logback.qos.ch/manual/configuration.html）：

 

01.<configuration>  
02.  
03.  <appender name="STDOUT" class="ch.qos.logback.core.ConsoleAppender">  
04.    <!-- encoders are assigned the type  
05.         ch.qos.logback.classic.encoder.PatternLayoutEncoder by default -->  
06.    <encoder>  
07.      <pattern>%d{HH:mm:ss.SSS} [%thread] %-5level %logger{36} - %msg%n</pattern>  
08.    </encoder>  
09.  </appender>  
10.  
11.  <root level="debug">  
12.    <appender-ref ref="STDOUT" />  
13.  </root>  
14.</configuration> 

  

<configuration>

  <appender name="STDOUT" class="ch.qos.logback.core.ConsoleAppender">
    <!-- encoders are assigned the type
         ch.qos.logback.classic.encoder.PatternLayoutEncoder by default -->
    <encoder>
      <pattern>%d{HH:mm:ss.SSS} [%thread] %-5level %logger{36} - %msg%n</pattern>
    </encoder>
  </appender>

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

二、日志级别限制

 

在多数的Log工具中，级别是可以传递，例如如果指定了日志输出级别为DEBUG，那么INFO、ERROR级别的log也会出现在日志文件。这种默认给程序的调试带来了很多的麻烦。而在logback中可以通过appender中的filter来严格限制日志的输出级别：

 

01.<filter class="ch.qos.logback.classic.filter.LevelFilter">  
02.    <level>INFO</level>  
03.    <onMatch>ACCEPT</onMatch>  
04.    <onMismatch>DENY</onMismatch>  
05.</filter>  

 

		<filter class="ch.qos.logback.classic.filter.LevelFilter">
			<level>INFO</level>
			<onMatch>ACCEPT</onMatch>
			<onMismatch>DENY</onMismatch>
		</filter>

上面的设置中只会在文件中出现级别为INFO的日志内容。

 

 

三、同一个类中包含不同的日志

有时候一个类中可能要求打印不同的日志信息，例如有的用来调试，有的用来记录程序运行中的某些参数的变化等等。这时候可以通过下面的语句声明不同的日志：

01.Logger debugLogger = LoggerFactory.getLogger(MyClass.class);  
02.Logger monitorLogger = LoggerFactory.getLogger("monitor");  

  

Logger debugLogger = LoggerFactory.getLogger(MyClass.class);
Logger monitorLogger = LoggerFactory.getLogger("monitor");

然后在配置文件中分别指定不同的输出文件（debugLogger使用默认的配置）：

01.    <appender name="monitor" class="ch.qos.logback.core.rolling.RollingFileAppender">  
02.        <File>${log.dir}/monitor.log</File>  
03.        <encoder>  
04.            <pattern>%d{yyyy-MM-dd HH:mm:ss.SSS} : %m%n</pattern>  
05.        </encoder>  
06.        <filter class="ch.qos.logback.classic.filter.ThresholdFilter">  
07.            <level>INFO</level>  
08.        </filter>  
09.        <rollingPolicy class="ch.qos.logback.core.rolling.TimeBasedRollingPolicy">  
10.            <fileNamePattern>${log.dir}/sensitive.log.%d{yyyy-MM-dd}</fileNamePattern>  
11.        </rollingPolicy>  
12.    </appender>  
13.        <logger name="monitor" additivity="false" level="INFO">  
14.<span style="white-space: pre;">        </span><appender-ref ref="monitor" />  
15.<span style="white-space: pre;">    </span></logger>  

 

	<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>
        <logger name="monitor" additivity="false" level="INFO">
<appender-ref ref="monitor" />
</logger>

这里通过设置additivity="false"禁止monitor里的内容向上传递，否则会同时显示在默认的日志中。

 

 

四、精确控制日志的应用范围

在程序调试中，经常出现的情况是：错误只在某一个或者几个类或者包里，所以只需要打开这几个类或者包里的DEBUG级别的log。在以前的项目，使用Spring和Hibernate时，一旦打开DEBUG级别的log，程序本身的debug信息就会被Spring和Hibernate的大量日志淹没，大大降低了调试的效率。而logback让这一切变的简单起来了：

<logger name="org" level="ERROR" />  

  

	<logger name="org" level="ERROR" />

这一行就将org包下面的所有日志级别设为了ERROR，不会再打扰我们的DEBUG。