logback LevelFilter 与 ThresholdFilter

概述

logback如果需要灵活的配置日志级别,需要结合过滤器,这个标签。需要注意的是,过滤器过滤的基础是在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以上的日志,被抛弃掉。

©著作权归作者所有,转载或内容合作请联系作者
平台声明:文章内容(如有图片或视频亦包括在内)由作者上传并发布,文章内容仅代表作者本人观点,简书系信息发布平台,仅提供信息存储服务。

推荐阅读更多精彩内容