logback 常用配置詳解（三） <filter>

<filter>:

過濾器，執(zhí)行一個過濾器會有返回個枚舉值，即DENY，NEUTRAL，ACCEPT其中之一。返回DENY，日志將立即被拋棄不再經過其他過濾器；返回NEUTRAL，有序列表里的下個過濾器過接著處理日志；返回ACCEPT，日志會被立即處理，不再經過剩余過濾器。

過濾器被添加到<Appender> 中，為<Appender> 添加一個或多個過濾器后，可以用任意條件對日志進行過濾。<Appender> 有多個過濾器時，按照配置順序執(zhí)行。

下面是幾個常用的過濾器：

LevelFilter： 級別過濾器，根據(jù)日志級別進行過濾。如果日志級別等于配置級別，過濾器會根據(jù)onMath 和 onMismatch接收或拒絕日志。有以下子節(jié)點：

<level>:設置過濾級別

<onMatch>:用于配置符合過濾條件的操作

<onMismatch>:用于配置不符合過濾條件的操作

例如：將過濾器的日志級別配置為INFO，所有INFO級別的日志交給appender處理，非INFO級別的日志，被過濾掉。

Xml代碼  

1. <configuration>   
2.   <appender name="CONSOLE" class="ch.qos.logback.core.ConsoleAppender">   
3.     <filter class="ch.qos.logback.classic.filter.LevelFilter">   
4.       <level>INFO</level>   
5.       <onMatch>ACCEPT</onMatch>   
6.       <onMismatch>DENY</onMismatch>   
7.     </filter>   
8.     <encoder>   
9.       <pattern>   
10.         %-4relative [%thread] %-5level %logger{30} - %msg%n   
11.       </pattern>   
12.     </encoder>   
13.   </appender>   
14.   <root level="DEBUG">   
15.     <appender-ref ref="CONSOLE" />   
16.   </root>   
17. </configuration>  

ThresholdFilter： 臨界值過濾器，過濾掉低于指定臨界值的日志。當日志級別等于或高于臨界值時，過濾器返回NEUTRAL；當日志級別低于臨界值時，日志會被拒絕。

例如：過濾掉所有低于INFO級別的日志。

Xml代碼  

1. <configuration>   
2.   <appender name="CONSOLE"   
3.     class="ch.qos.logback.core.ConsoleAppender">   
4.     <!-- 過濾掉 TRACE 和 DEBUG 級別的日志-->   
5.     <filter class="ch.qos.logback.classic.filter.ThresholdFilter">   
6.       <level>INFO</level>   
7.     </filter>   
8.     <encoder>   
9.       <pattern>   
10.         %-4relative [%thread] %-5level %logger{30} - %msg%n   
11.       </pattern>   
12.     </encoder>   
13.   </appender>   
14.   <root level="DEBUG">   
15.     <appender-ref ref="CONSOLE" />   
16.   </root>   
17. </configuration>  

EvaluatorFilter： 求值過濾器，評估、鑒別日志是否符合指定條件。有一下子節(jié)點：

<evaluator>:

鑒別器，常用的鑒別器是JaninoEventEvaluato，也是默認的鑒別器，它以任意的java布爾值表達式作為求值條件，求值條件在配置文件解釋過成功被動態(tài)編譯，布爾值表達式返回true就表示符合過濾條件。evaluator有個子標簽<expression>，用于配置求值條件。

求值表達式作用于當前日志，logback向求值表達式暴露日志的各種字段：

<onMatch>:用于配置符合過濾條件的操作

<onMismatch>:用于配置不符合過濾條件的操作

例如：過濾掉所有日志消息中不包含“billing”字符串的日志。

Xml代碼  

1. <configuration>   
2.    
3.   <appender name="STDOUT" class="ch.qos.logback.core.ConsoleAppender">   
4.     <filter class="ch.qos.logback.core.filter.EvaluatorFilter">         
5.       <evaluator> <!-- 默認為 ch.qos.logback.classic.boolex.JaninoEventEvaluator -->   
6.         <expression>return message.contains("billing");</expression>   
7.       </evaluator>   
8.       <OnMatch>ACCEPT </OnMatch>  
9.       <OnMismatch>DENY</OnMismatch>  
10.     </filter>   
11.     <encoder>   
12.       <pattern>   
13.         %-4relative [%thread] %-5level %logger - %msg%n   
14.       </pattern>   
15.     </encoder>   
16.   </appender>   
17.    
18.   <root level="INFO">   
19.     <appender-ref ref="STDOUT" />   
20.   </root>   
21. </configuration>  

<matcher> ：

匹配器，盡管可以使用String類的matches()方法進行模式匹配，但會導致每次調用過濾器時都會創(chuàng)建一個新的Pattern對象，為了消除這種開銷，可以預定義一個或多個matcher對象，定以后就可以在求值表達式中重復引用。<matcher>是<evaluator>的子標簽。

<matcher>中包含兩個子標簽，一個是<name>，用于定義matcher的名字，求值表達式中使用這個名字來引用matcher；另一個是<regex>，用于配置匹配條件。

例如：

Xml代碼  

1. <configuration debug="true">   
2.    
3.   <appender name="STDOUT" class="ch.qos.logback.core.ConsoleAppender">   
4.     <filter class="ch.qos.logback.core.filter.EvaluatorFilter">   
5.       <evaluator>           
6.         <matcher>   
7.           <Name>odd</Name>   
8.           <!-- filter out odd numbered statements -->   
9.           <regex>statement [13579]</regex>   
10.         </matcher>   
11.            
12.         <expression>odd.matches(formattedMessage)</expression>   
13.       </evaluator>   
14.       <OnMismatch>NEUTRAL</OnMismatch>   
15.       <OnMatch>DENY</OnMatch>   
16.     </filter>   
17.     <encoder>   
18.       <pattern>%-4relative [%thread] %-5level %logger - %msg%n</pattern>   
19.     </encoder>   
20.   </appender>   
21.    
22.   <root level="DEBUG">   
23.     <appender-ref ref="STDOUT" />   
24.   </root>   
25. </configuration>  

其他Filter不太常用我這里就不講了，大家可以參見官網。