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

<filter>:

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

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

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

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

<level>:設(shè)置過濾級別

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

例如：過濾掉所有低于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,，也是默認(rèn)的鑒別器，它以任意的java布爾值表達(dá)式作為求值條件,，求值條件在配置文件解釋過成功被動態(tài)編譯,，布爾值表達(dá)式返回true就表示符合過濾條件。evaluator有個子標(biāo)簽<expression>,，用于配置求值條件,。

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

<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> <!-- 默認(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)行模式匹配,，但會導(dǎo)致每次調(diào)用過濾器時都會創(chuàng)建一個新的Pattern對象，為了消除這種開銷,，可以預(yù)定義一個或多個matcher對象,，定以后就可以在求值表達(dá)式中重復(fù)引用。<matcher>是<evaluator>的子標(biāo)簽,。

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