关于logback日志级别的配置

Posted 2020-08-17 时间的法外狂徒

logback如果需要灵活的配置日志级别，需要结合过滤器，<filter></fiter>这个标签。需要注意的是，过滤器过滤的基础是在root标签的配置基础上进行的。

过滤器可以写在appender标签内，可以写一个或多个，顺序执行。过滤器会对每个级别的日志设置枚举值，表示对日志的处理方式。

　　DENY：日志将立即被抛弃不再经过其他过滤器；

　　NEUTRAL：有序列表里的下个过滤器过接着处理日志；（该级别既不处理，也不抛弃，相当于没有任何处理，日志会被保存下来并在本appender被执行）

　　ACCEPT：日志会被立即处理，不再经过剩余过滤器。

下面讲述两个常用的filter：

1、级别过滤器

　　LevelFilter： 级别过滤器，对特定某个级别的日志进行过滤。

<?xml version="1.0" encoding="UTF-8"?>
<configuration debug="false">
    
    <!-- 控制台输出 -->
    <appender name="STDOUT" class="ch.qos.logback.core.ConsoleAppender">
        <encoder class="ch.qos.logback.classic.encoder.PatternLayoutEncoder">
            <!-- 1格式化输出：%d表示日期，%thread表示线程名，%-5level：级别从左显示5个字符宽度%msg：日志消息，%n是换行符-->
            <pattern></pattern>
            <charset>utf-8</charset>
        </encoder>
        <!-- 过滤掉非info的日志 -->
         <filter class="ch.qos.logback.classic.filter.LevelFilter">   
              <level>INFO</level>   
              <onMatch>ACCEPT</onMatch>   
              <onMismatch>DENY</onMismatch>   
          </filter>   
    </appender>
    
    
    <!-- 日志级别排序为： TRACE < DEBUG < INFO < WARN < ERROR -->
    <!-- 日志输出级别 -->
    <root level="DEBUG">
        <appender-ref ref="STDOUT" />
        <appender-ref ref="FILE" />
    </root>
</configuration>

level：日志级别。

onMatch：对符合过滤级别的日志的操作。（DENY，NEUTRAL，ACCEPT）

onMismatch：对不符合过滤级别的日志的操作。（DENY，NEUTRAL，ACCEPT）

测试代码：

package com.dbzx.controller;

import java.util.Date;

import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.ResponseBody;

import com.dbzx.common.ResultModel;

@Controller
public class HelloController {
    
    Logger logger = LoggerFactory.getLogger(HelloController.class);
    
    
    @ResponseBody
    @RequestMapping("/hello")
    public ResultModel hello() {
        logger.trace("*****************trace**********");
        logger.debug("*************debug*************");
        logger.info("**************info****************");
        logger.warn("****************warn***************");
        logger.error("****************error*************");
        return ResultModel.ok("hello,dbzx"+new Date().getTime());
    }
    

}

结果：

2019-05-30 17:21:19.413 [http-nio-8888-exec-1] INFO  com.dbzx.controller.HelloController - **************info****************

过滤器的配置在配置级别的基础上过滤，即root标签的配置级别。本例中，是对大于等于debug级别的日志过滤。

 

ps：如果修改onMismatch参数为NEUTRAL。

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

结果：

2019-05-30 17:25:08.045 [http-nio-8888-exec-1] DEBUG com.dbzx.controller.HelloController - *************debug*************
2019-05-30 17:25:08.045 [http-nio-8888-exec-1] INFO  com.dbzx.controller.HelloController - **************info****************
2019-05-30 17:25:08.045 [http-nio-8888-exec-1] WARN  com.dbzx.controller.HelloController - ****************warn***************
2019-05-30 17:25:08.046 [http-nio-8888-exec-1] ERROR com.dbzx.controller.HelloController - ****************error*************

 

结果就是：出了info级别，debug、warn、error级别的日志也会被打印，即不符合配置级别的日志，同样被执行。

2、临界值过滤器

ThresholdFilter： 临界值过滤器，过滤掉低于指定临界值的日志。

它没有过多的参数，只有默认配置。当日志级别等于或高于临界值时，过滤器返回NEUTRAL；当日志级别低于临界值时，日志返回DENY。

<?xml version="1.0" encoding="UTF-8"?>
<configuration debug="false">
    
    <!-- 控制台输出 -->
    <appender name="STDOUT" class="ch.qos.logback.core.ConsoleAppender">
        <encoder class="ch.qos.logback.classic.encoder.PatternLayoutEncoder">
            <!-- 1格式化输出：%d表示日期，%thread表示线程名，%-5level：级别从左显示5个字符宽度%msg：日志消息，%n是换行符-->
            <pattern></pattern>
            <charset>utf-8</charset>
        </encoder>
       <!--临界值日志过滤级别配置 -->
        <filter class="ch.qos.logback.classic.filter.ThresholdFilter"><!-- 只打印DEBUG日志 --> 
            <!-- 在日志配置级别的基础上过滤掉info级别以下的日志 -->
            <level>INFO</level> 
        </filter> 
    </appender>  
    </appender>
    
    
    <!-- 日志级别排序为： TRACE < DEBUG < INFO < WARN < ERROR -->
    <!-- 日志输出级别 -->
    <root level="DEBUG">
        <appender-ref ref="STDOUT" />
        <appender-ref ref="FILE" />
    </root>
</configuration>

结果：

2019-05-30 17:26:42.755 [http-nio-8888-exec-1] INFO  com.dbzx.controller.HelloController - **************info****************
2019-05-30 17:26:42.755 [http-nio-8888-exec-1] WARN  com.dbzx.controller.HelloController - ****************warn***************
2019-05-30 17:26:42.756 [http-nio-8888-exec-1] ERROR com.dbzx.controller.HelloController - ****************error*************

在debug配置级别的基础上，过滤掉info一下的日志。最终，info及大于info级别的日志打印的控制台，info以下，debug及debug以上的日志，被抛弃掉。