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

<filter>:

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

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

下面是幾個(gè)常用的過(guò)濾器：

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

<level>:設(shè)置過(guò)濾級(jí)別

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

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

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

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： 臨界值過(guò)濾器，過(guò)濾掉低于指定臨界值的日志。當(dāng)日志級(jí)別等于或高于臨界值時(shí)，過(guò)濾器返回NEUTRAL；當(dāng)日志級(jí)別低于臨界值時(shí)，日志會(huì)被拒絕。

例如：過(guò)濾掉所有低于INFO級(jí)別的日志。

Xml代碼  

1. <configuration>   
2.   <appender name="CONSOLE"   
3.     class="ch.qos.logback.core.ConsoleAppender">   
4.     <!-- 過(guò)濾掉 TRACE 和 DEBUG 級(jí)別的日志-->   
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： 求值過(guò)濾器，評(píng)估、鑒別日志是否符合指定條件。有一下子節(jié)點(diǎn)：

<evaluator>:

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

求值表達(dá)式作用于當(dāng)前日志，logback向求值表達(dá)式暴露日志的各種字段：

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

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

例如：過(guò)濾掉所有日志消息中不包含“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> <!-- 默認(rèn)為 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()方法進(jìn)行模式匹配，但會(huì)導(dǎo)致每次調(diào)用過(guò)濾器時(shí)都會(huì)創(chuàng)建一個(gè)新的Pattern對(duì)象，為了消除這種開銷，可以預(yù)定義一個(gè)或多個(gè)matcher對(duì)象，定以后就可以在求值表達(dá)式中重復(fù)引用。<matcher>是<evaluator>的子標(biāo)簽。

<matcher>中包含兩個(gè)子標(biāo)簽，一個(gè)是<name>，用于定義matcher的名字，求值表達(dá)式中使用這個(gè)名字來(lái)引用matcher；另一個(gè)是<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不太常用我這里就不講了，大家可以參見官網(wǎng)。