本文來寫說下logback-spring.xml相關(guān)的知識與概念

概述

對于xml日志文件的配置，大多數(shù)人第一次接觸時有一種望而生畏的感覺，其實如果仔細(xì)分析，會發(fā)現(xiàn)核心的部分只有三個元素：appender、logger、root。

通過上圖我們可以清晰的了解整個xml文件的元素及功能。

其中configuration是根元素，必須的；logger和root可視為同一類，都是日志組件；logger定義日志從哪里（包）獲取以及級別；appender配置日志格式、如何過濾、文件處理等。property和contextName元素，分別用來定義變量和應(yīng)用上下文名稱，非必須。

先通過一個簡單的日志模板，從視覺上感受一下：

<configuration>
  <appender name="STDOUT" class="ch.qos.logback.core.ConsoleAppender">
    <encoder>
      <pattern>%d{HH:mm:ss.SSS} [%thread] %-5level %
      logger{36} - %msg%n</pattern>
    </encoder>
  </appender>
  <logger name="chapters.configuration" level="INFO"/>
  <root level="DEBUG">          
    <appender-ref ref="STDOUT" />
  </root>  
</configuration>

上述實例定義了控制臺輸出debug級別日志的配置。下面對相關(guān)的元素進(jìn)行逐一講解。

configuration元素

logback.xml配置文件的基本結(jié)構(gòu)可以描述為configuration元素，包含零個或多個appender元素，后跟零個或多個logger元素，后跟最多一個root元素(也可以沒有)。

根元素configuration有三個屬性：

• debug：默認(rèn)為false，若設(shè)置為true，則打印出logback內(nèi)部日志信息。
• scan：默認(rèn)值為true，若設(shè)置為true，配置文件如果發(fā)生改變，將會被重新加載。
• scanPeriod：與scan配合使用，當(dāng)scan為true時，此屬性生效，默認(rèn)的時間間隔為1分鐘，設(shè)置監(jiān)測配置文件是否有修改的時間間隔，如果沒有給出時間單位，默認(rèn)單位是毫秒。如可以設(shè)置為scanPeriod="30 seconds"每30秒檢測一次。

定義上下文名稱

contextName元素，每一個日志組件（logger）都會關(guān)聯(lián)到日志上下文，默認(rèn)上下文名稱是’default’，用于標(biāo)識應(yīng)用，如果多個應(yīng)用輸出到同一個地方，就有必要使用%contextName來區(qū)別。

上線文的配置直接在configuration元素下：

<configuration>
    <contextName>HelloWorld-log</contextName>
</configuration>

經(jīng)過定義之后，在其他property屬性或appender中便可通過“%contextName”來獲取和使用該上下文名稱了。

定義變量

通過property元素可定義變量。它有name和value兩個屬性。變量可以使“${name}”來使用變量。作用類似于代碼中的常量字符串，定義之后公共地方便可以統(tǒng)一使用。如日志文件名稱前綴、日志路徑、日志輸出格式等。

<configuration>
    <property name="log.path" value="./log" />
</configuration>

上面便是定義了日志的根路徑的變量。

如果是在Spring或SpringBoot項目當(dāng)中，想讓value值是通過配置文件獲取，可使用springProperty來定義。

<springProperty scope="context" name="log.path" 
source="catalina.base"/>

其中source指定的catalina.base便是在application.properties當(dāng)中配置變量。此配置還是比較常用的，可以做到靈活區(qū)分環(huán)境。

appender組件

appender組件用來定義日志輸出格式，日志如何過濾以及日志文件的處理。appender的結(jié)構(gòu)如下：

appender的屬性有name和class。name指定appender名稱，后面使用該appender是也是通過名稱來指定。

class屬性指定要實例化的appender類的完全限定名稱。appender類默認(rèn)有以下幾種：

• ConsoleAppender：日志輸出到控制臺，類名ch.qos.logback.core.ConsoleAppender。
• FileAppender：日志輸入到文件，類名ch.qos.logback.core.FileAppender。
• RollingFileAppender：滾動記錄文件，F(xiàn)ileAppender的子類，當(dāng)符合條件（大小、時間），日志進(jìn)行切分處理。類名：ch.qos.logback.core.rolling.RollingFileAppender。

appender元素可以包含零個或一個layout元素，零個或多個encoder元素以及零個或多個filter元素。

實戰(zhàn)中ConsoleAppender及RollingFileAppender使用較多，若需要自定義如把日志輸出到消息隊列，可以自定義實現(xiàn)AppenderBase接口。

ConsoleAppender上面已經(jīng)有示例，主要作用就是將日志輸出到控制臺，并通過pattern元素指定了輸出的格式。下面重點看一下RollingFileAppender的配置。

RollingFileAppender配置

RollingFileAppender是FileAppender的子類，擴展了FileAppender，具有翻轉(zhuǎn)日志文件的功能。

例如，RollingFileAppender可以記錄到名為log.txt文件的文件，并且一旦滿足某個條件，就將其日志記錄目標(biāo)更改為另一個文件。

RollingFileAppender通常包括File、filter，rollingPolicy，encoder和layout元素。

encoder用來指定日志的輸出格式及編碼等：

<!-- 文件輸出日志格式 -->
<property name="FILE_LOG_PATTERN" value="%d{yyyy-MM-dd HH:mm:ss.SSS} 
%contextName [%thread] %-5level %logger{36} - %msg%n" />
<appender>
    <!--日志文件輸出格式-->
    <encoder>
        <pattern>${FILE_LOG_PATTERN}</pattern>
        <charset class="java.nio.charset.Charset">UTF-8</charset>
    </encoder>
</appender>

file元素用來配置日志的路徑和名稱，一般把路徑和文件名前綴定義到變量(property中)。

<encoder>
    <!-- 正在記錄的日志文件的路徑及文件名 -->
    <file>${log.path}/log_error.log</file>
</appender>

${log.path}獲取的便是前面屬性中定義的變量。

appender中可以有多個filter元素，比如用ThresholdFilter來過濾低于指定臨界值的日志；用LevelFilter來過濾日志級別。以LevelFilter為例：

<!-- 過濾器，只記錄debug級別的日志 -->
<filter class="ch.qos.logback.classic.filter.LevelFilter">
    <level>DEBUG</level>
    <OnMismatch>DENY</OnMismatch>
    <OnMatch>ACCEPT</OnMatch>
</filter>

其中l(wèi)evel指定日志級別，onMath指定符合過濾條件的操作接收（ACCEPT），onMismatch指定不符合條件的拒絕（DENY）。

如果需要將不同級別的日志輸出到不同的日志文件，那么就需要配置多個filter，每個filter像上面一樣指定level級別：DEBUG，INFO，WARN和ERROR。

通常情況下，日志輸出會配置三個，一個控制臺輸出用于開發(fā)階段；一個INFO及以上級別的日志輸出，可追蹤相應(yīng)的生產(chǎn)日志；一個單獨ERROR級別的日志輸出，方便快速檢查出異常日志。

rollingPolicy用于配置滾動策略，支持TimeBasedRollingPolicy、SizeAndTimeBasedRollingPolicy、FixedWindowRollingPolicy、SizeBasedTriggeringPolicy。

分別是基于時間滾動、基于大小和時間滾動、固定窗口滾動和大小觸發(fā)。其中FixedWindowRollingPolicy一般和SizeBasedTriggeringPolicy同時使用。下面以TimeBasedRollingPolicy為例，以天為單位輸出日志，每天一個日志。

<rollingPolicy class="ch.qos.logback.core.rolling.TimeBasedRollingPolicy">
    <!-- 日志輸出格式 -->
    <fileNamePattern>${log.path}/debug.%d{yyyy-MM-dd}.log</fileNamePattern>
    <!-- 日志保留天數(shù) -->
    <maxHistory>30</maxHistory>
</rollingPolicy>

fileNamePattern指定日志的路徑及名稱，此處是按日期輸出，即%d{yyyy-MM-dd}格式。maxHistory表示日志最多保留天數(shù)，存活超過30天的日志會被刪除。

logger配置

logger用來設(shè)置某一個類或者某個包的日志輸出級別、以及關(guān)聯(lián)的appender。

logger包含三個屬性：

• name：要輸出日志的包名或者類名，比如com.secbro2。必選項。
• level：設(shè)置日志級別，允許一個不區(qū)分大小寫的字符串值TRACE，DEBUG，INFO，WARN，ERROR，ALL或OFF。如果未設(shè)置，則logger會向上繼承最近一個非空級別?？蛇x項。
• additivity：是否將日志向上級傳遞，默認(rèn)為 true。可選項。

logger通過1個或多個子節(jié)點appender-ref來控制日志的輸出。

<logger name="org.springframework" level="WARN"/>
<logger name="com" level="debug" />

上面示例表示org.springframework包下的日志以warn級別輸出，com包下的日志以debug級別輸出。

<logger name="com.secbro2" level="info" additivity="true">
    <appender-ref ref="CONSOLE" />
</logger>

上面的示例對指定包指定appender進(jìn)行日志控制，由于設(shè)置了info級別，additivity為true，而且關(guān)聯(lián)CONSOLE的appender，因此info以上級別的日志會輸出到控制臺。

同時會把日志上傳到父級，即root。若root也有配置CONSOLE的輸出的話，會在控制臺輸出兩次。additivity為false，則不會。

root配置

root元素配置根記錄器。它是一個特殊的logger，是所有l(wèi)ogger的根節(jié)點，只有一個屬性level，默認(rèn)為DEBUG 。

<root level="info">
    <appender-ref ref="CONSOLE" />
    <appender-ref ref="LOGSTASH" />
    <appender-ref ref="INFO_FILE" />
    <appender-ref ref="ERROR_FILE" />
</root>

level屬性的值可以是不區(qū)分大小寫的字符串TRACE，DEBUG，INFO，WARN，ERROR，ALL或OFF之一。root元素可以包含零個或多個appender-ref元素；被引用的每個appender都被添加到根記錄器中。

如果是基于SpringBoot項目，針對不同環(huán)境（profile）有不同的日志輸出，比如開發(fā)（dev）環(huán)境只輸出CONSOLE的，生產(chǎn)環(huán)境（prod）只輸入info和error，那則可用到Spring支持的profile機制。對應(yīng)的元素為springProfile。

profile的值與springboot中配置文件的spring.profiles.active值進(jìn)行對照。

<!-- 開發(fā)環(huán)境 -->
<springProfile name="dev">
    <logger name="com" level="debug" />
    <root level="info">
        <appender-ref ref="CONSOLE" />
    </root>
</springProfile>
<!-- 測試環(huán)境+生產(chǎn)環(huán)境 -->
<springProfile name="test,prod">
    <logger name="com" level="info" />
    <root level="info">
        <appender-ref ref="INFO_FILE" />
        <appender-ref ref="ERROR_FILE" />
    </root>
</springProfile>

當(dāng)引入了springProfile，我們可以看到root元素可以出現(xiàn)多次了，但還是保證了一個環(huán)境只有一個root元素的要求。springProfile的name對應(yīng)spring.profiles.active的值，多個值用逗號分隔。

ELK的配置

如果項目中的日志采用的是基于ELK（Elasticsearch，Logstash，Kibana三個開源軟件的縮寫）來進(jìn)行日志管理。則可以在pom文件中引入logstash-logback-encoder依賴。

<dependency>
    <groupId>net.logstash.logback</groupId>
    <artifactId>logstash-logback-encoder</artifactId>
    <version>5.1</version>
</dependency>

然后在logback-spring.xml中配置對應(yīng)的appender：

<appender name="LOGSTASH" class="net.logstash.logback.appender.LogstashTcpSocketAppender">
    <filter class="ch.qos.logback.classic.filter.ThresholdFilter">
        <level>debug</level>
    </filter>
    <destination>192.168.0.11:5061</destination>
    <encoder charset="UTF-8" class="net.logstash.logback.encoder.LogstashEncoder">
        <customFields>{"project": "springboot-logback-elk"}</customFields>
    </encoder>
</appender>

該appender的使用與其他appender的使用無異。主要使用了LogstashTcpSocketAppender類來完成與Logstash的通信。其中destination為Logstash提供的服務(wù)地址。customFields為自定義的參數(shù)，便于Logstash識別日志是從哪個業(yè)務(wù)系統(tǒng)傳輸過來的。

輸出logback狀態(tài)數(shù)據(jù)

某些時候為了了解logback配置文件加載情況，配置中對應(yīng)的appender、logger的裝載情況等，我們需要啟用logback狀態(tài)數(shù)據(jù)的輸出。這也是logback官網(wǎng)強烈推薦的，可以幫助我們排除診斷一些問題。

啟用狀態(tài)數(shù)據(jù)輸出有兩種方式：

• 在根元素(configuration) 中設(shè)置屬性debug=“true”。
• 添加元素(statusListener)，class使用OnConsoleStatusListener。如下：

<!-- 輸出logback的本身狀態(tài)數(shù)據(jù) -->
<statusListener class="ch.qos.logback.core.status.OnConsoleStatusListener" />

兩種方式選其一即可。第一種方式的debug與配置文件中的日志級別沒有關(guān)系，只用于表示輸出狀態(tài)數(shù)據(jù)。

異步輸出日志

前面講到的appender，日志輸出到文件是同步輸出的，即每次輸出都會直接寫IO到磁盤文件。對于高并發(fā)的應(yīng)用，會產(chǎn)生一定的阻塞，造成不必要的性能損耗。

logback提供了日志異步輸出的AsyncAppender。處理方式也很簡單，添加一個基于異步寫日志的appender，并指向原配置的appender即可：

<!-- 異步輸出 -->
<appender name="ASYNCDEBUG" class="ch.qos.logback.classic.AsyncAppender">
    <!-- 默認(rèn)如果隊列的80%已滿,則會丟棄TRACT、DEBUG、INFO級別的日志，若要保留全部日志，設(shè)置為0 -->
    <discardingThreshold>0</discardingThreshold>
    <!-- 更改默認(rèn)的隊列的深度,該值會影響性能.默認(rèn)值為256 -->
    <queueSize>1024</queueSize>
    <!-- 添加附加的appender,最多只能添加一個 -->
    <appender-ref ref="DEBUGFILE"/>
    <includeCallerData>true</includeCallerData>
</appender>
<!-- 異步輸出關(guān)聯(lián)到root -->
<root level="DEBUG">
    <appender-ref ref="STDOUT"/>
    <appender-ref ref="ASYNCDEBUG" />
    //...
</root>

AsyncAppender的實現(xiàn)原理是通過阻塞隊列(BlockingQueue)來避免日志直接輸出到文件，先把日志事件輸出到BlockingQueue中，然后啟動一個新的worker線程，主線程不阻塞，worker線程則從隊列中獲取需要寫的日志，異步輸出到對應(yīng)的位置。

代碼中的日志格式

在日常使用日志時，可以通過最開始的示例定義Logger對象，然后調(diào)用其對應(yīng)級別的日志輸出。當(dāng)然，如果采用Lombok的情況下，可直接類上使用@Slf4j注解來自動注入log屬性，不用再聲明：

private static final Logger log = LoggerFactory.getLogger(LogbackController.class);

替換為：

@Slf4j
@RestController
public class LogbackController {
}

其他內(nèi)容不變。

而在日志輸出格式也有多種，其中最不可取的形式是如下模式的日志輸出：

Object entry = new SomeObject(); 
logger.debug("The entry is " + entry);

這種模式會導(dǎo)致即使采用info基本輸出，debug中的對象toString和字符串拼裝依舊會處理。建議采用如下模式輸出：

Object entry = new SomeObject(); 
logger.debug("The entry is {}.", entry);

此時，如果日志輸出級別為info，則不會處理對象的toString和字符串的拼接。

logback作者進(jìn)行測試得出：第一種和第二種寫法輸出結(jié)果相同。但在禁用日志記錄語句的情況下，第二種將比第一種寫法優(yōu)于至少30倍。

本文小結(jié)

到此，關(guān)于logback日志框架的講解告一段落，如果你還想了解更多底層原理和一些表達(dá)式，建議看一下官方的手冊，雖然是英文的，但還是比較全面的。

本文用巨大篇幅，描述了logback日志常見的使用場景，想必讀到此處時，原來在那復(fù)雜的日志配置文件已經(jīng)變得十分簡單吧。趕快嘗試一下吧。用了兩天寫完這篇文章，多多支持，你懂得該怎么做的。

到此這篇關(guān)于logback-spring.xml詳解的文章就介紹到這了,更多相關(guān)logback-spring.xml內(nèi)容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家！