看完這個不會配置 logback ，請你吃瓜！

時間  2019-11-07
標籤 看完 這個 不會 配置 logback 請你 简体版
原文   原文鏈接

以前在 日誌？聊一聊slf4j吧 這篇文章中聊了下slf4j。本文也從實際的例子出發，針對logback的日誌配置進行學習。java

logack 簡介

logback 官網：https://logback.qos.ch/git

目前尚未看過日誌類框架的源碼，僅限於如何使用。因此就不說那些「空話」了。最直觀的認知是：github

  • logback和log4j是一我的寫的
  • springboot默認使用的日誌框架是logback。
  • 三個模塊組成
    • logback-core
    • logback-classic
    • logback-access
  • 其餘的關於性能，關於內存佔用，關於測試，關於文檔詳見源碼及官網說明

logback-core 是其它模塊的基礎設施，其它模塊基於它構建，顯然，logback-core 提供了一些關鍵的通用機制。logback-classic 的地位和做用等同於 Log4J，它也被認爲是 Log4J 的一個改進版，而且它實現了簡單日誌門面 SLF4J；而 logback-access 主要做爲一個與 Servlet 容器交互的模塊，好比說tomcat或者 jetty，提供一些與 HTTP 訪問相關的功能。web

配置文件詳解

這部分主要來學習下logback配置文件的一些配置項。算法

configuration

先來看這張圖，這個結構就是整個logback.xml配置文件的結構。spring

對應來看下配置文件： 

<configuration scan="true" scanPeriod="60 seconds" debug="false">  
    <property name="glmapper-name" value="glmapper-demo" /> 
    <contextName>${glmapper-name}</contextName> 
    
    
    <appender>
        //xxxx
    </appender>   
    
    <logger>
        //xxxx
    </logger>
    
    <root>             
       //xxxx
    </root>  
</configuration>  
複製代碼

ps：想使用spring擴展profile支持，要以logback-spring.xml命名，其餘如property須要改成springPropertysql

  • scan:當此屬性設置爲true時，配置文件若是發生改變，將會被從新加載，默認值爲true。
  • scanPeriod:設置監測配置文件是否有修改的時間間隔，若是沒有給出時間單位，默認單位是毫秒。當scan爲true時，此屬性生效。默認的時間間隔爲1分鐘。
  • debug:當此屬性設置爲true時，將打印出logback內部日誌信息，實時查看logback運行狀態。默認值爲false。

contextName

每一個logger都關聯到logger上下文，默認上下文名稱爲「default」。但可使用contextName標籤設置成其餘名字，用於區分不一樣應用程序的記錄數組

property

用來定義變量值的標籤，property標籤有兩個屬性，name和value；其中name的值是變量的名稱，value的值時變量定義的值。經過property定義的值會被插入到logger上下文中。定義變量後，可使「${name}」來使用變量。如上面的xml所示。tomcat

logger

用來設置某一個包或者具體的某一個類的日誌打印級別以及指定appender。springboot

root

根logger，也是一種logger，且只有一個level屬性

appender

負責寫日誌的組件，下面會細說

filter

filter實際上是appender裏面的子元素。它做爲過濾器存在，執行一個過濾器會有返回DENY，NEUTRAL，ACCEPT三個枚舉值中的一個。

  • DENY：日誌將當即被拋棄再也不通過其餘過濾器
  • NEUTRAL：有序列表裏的下個過濾器過接着處理日誌
  • ACCEPT：日誌會被當即處理，再也不通過剩餘過濾器

案例分析

首先來配置一個很是簡單的文件。這裏申請下，我使用的是 logback-spring.xml。和 logback.xml 在properties上有略微差異。其餘都同樣。

工程：springboot+web

先來看下項目目錄

properties中就是指定了日誌的打印級別和日誌的輸出位置：

#設置應用的日誌級別
logging.level.com.glmapper.spring.boot=INFO
#路徑
logging.path=./logs
複製代碼

經過控制檯輸出的log

logback-spring.xml的配置以下：

<configuration>
    <!-- 默認的控制檯日誌輸出，通常生產環境都是後臺啓動，這個沒太大做用 -->
    <appender name="STDOUT" class="ch.qos.logback.core.ConsoleAppender">
        <encoder class="ch.qos.logback.classic.encoder.PatternLayoutEncoder">
            <Pattern>%d{HH:mm:ss.SSS} %-5level %logger{80} - %msg%n</Pattern>
        </encoder>
    </appender>
    
    <root level="info">
        <appender-ref ref="STDOUT"/>
    </root>
</configuration>
複製代碼

打印日誌的controller

private static final Logger LOGGER =
LoggerFactory.getLogger(HelloController.class);
@Autowired
private TestLogService testLogService;

@GetMapping("/hello")
public String hello(){
    LOGGER.info("GLMAPPER-SERVICE:info");
    LOGGER.error("GLMAPPER-SERVICE:error");
    testLogService.printLogToSpecialPackage();
    return "hello spring boot";
}
複製代碼

驗證結果：

01:50:39.633 INFO  com.glmapper.spring.boot.controller.HelloController
- GLMAPPER-SERVICE:info
01:50:39.633 ERROR com.glmapper.spring.boot.controller.HelloController
- GLMAPPER-SERVICE:error
複製代碼

上面的就是經過控制檯打印出來的，這個時候由於咱們沒有指定日誌文件的輸出，由於不會在工程目錄下生產logs文件夾。

控制檯不打印，直接輸出到日誌文件

先來看下配置文件：

<configuration>
    <!-- 屬性文件:在properties文件中找到對應的配置項 -->
    <springProperty scope="context" name="logging.path" source="logging.path"/>
    <springProperty scope="context" name="logging.level" source="logging.level.com.glmapper.spring.boot"/>
    <!-- 默認的控制檯日誌輸出，通常生產環境都是後臺啓動，這個沒太大做用 -->
    <appender name="STDOUT" class="ch.qos.logback.core.ConsoleAppender">
        <encoder class="ch.qos.logback.classic.encoder.PatternLayoutEncoder">
            <Pattern>%d{HH:mm:ss.SSS} %-5level %logger{80} - %msg%n</Pattern>
        </encoder>
    </appender>
    
    <appender name="GLMAPPER-LOGGERONE" class="ch.qos.logback.core.rolling.RollingFileAppender">
        <append>true</append>
        <filter class="ch.qos.logback.classic.filter.ThresholdFilter">
            <level>${logging.level}</level>
        </filter>
        <file>
            ${logging.path}/glmapper-spring-boot/glmapper-loggerone.log
        </file>
        <rollingPolicy class="ch.qos.logback.core.rolling.TimeBasedRollingPolicy">
            <FileNamePattern>${logging.path}/glmapper-spring-boot/glmapper-loggerone.log.%d{yyyy-MM-dd}</FileNamePattern>
            <MaxHistory>30</MaxHistory>
        </rollingPolicy>
        <encoder class="ch.qos.logback.classic.encoder.PatternLayoutEncoder">
            <pattern>%d{yyyy-MM-dd HH:mm:ss.SSS} [%thread] %-5level %logger{50} - %msg%n</pattern>
            <charset>UTF-8</charset>
        </encoder>
    </appender>
    
    <root level="info">
        <appender-ref ref="GLMAPPER-LOGGERONE"/>
    </root>
</configuration>
複製代碼

這裏咱們appender-ref指定的appender是GLMAPPER-LOGGERONE，由於以前沒有名字爲GLMAPPER-LOGGERONE的appender，因此要增長一個name爲GLMAPPER-LOGGERONE的appender。

注意上面這個配置，咱們是直接接將root的appender-ref直接指定到咱們的GLMAPPER-LOGGERONE這個appender的。因此控制檯中將只會打印出bannar以後就啥也不打印了，全部的啓動信息都會被打印在日誌文件glmapper-loggerone.log中。

可是實際上咱們不但願個人業務日誌中會包括這些啓動信息。因此這個時候咱們就須要經過logger標籤來搞事情了。將上面的配置文件進行簡單修改：

<logger name="com.glmapper.spring.boot.controller" level="${logging.level}" additivity="false">
    <appender-ref ref="GLMAPPER-LOGGERONE" />
</logger>

<root level="${logging.level}">
    <appender-ref ref="STDOUT"/>
</root>
複製代碼

讓root指向控制檯輸出；logger負責打印包com.glmapper.spring.boot.controller下的日誌。

驗證結果

仍是經過咱們的測試controller來打印日誌爲例，可是這裏不會在控制檯出現日誌信息了。指望的日誌文件在./logs/glmapper-spring-boot/glmapper-loggerone.log。

logger和appender的關係

上面兩種是一個基本的配置方式，經過上面兩個案例，咱們先來了解下logger/appender/root之間的關係，而後再詳細的說下logger和appender的配置細節。

在最前面介紹中提到，root是根logger,因此他兩是一回事；只不過root中不能有name和additivity屬性，是有一個level。

appender是一個日誌打印的組件，這裏組件裏面定義了打印過濾的條件、打印輸出方式、滾動策略、編碼方式、打印格式等等。可是它僅僅是一個打印組件，若是咱們不使用一個logger或者root的appender-ref指定某個具體的appender時，它就沒有什麼意義。

所以appender讓咱們的應用知道怎麼打、打印到哪裏、打印成什麼樣；而logger則是告訴應用哪些能夠這麼打。例如某個類下的日誌可使用這個appender打印或者某個包下的日誌能夠這麼打印。

appender 配置詳解

這裏以上面案例中的名爲GLMAPPER-LOGGERONE的appender說明：

<appender name="GLMAPPER-LOGGERONE" class="ch.qos.logback.core.rolling.RollingFileAppender">
    <append>true</append>
    <filter class="ch.qos.logback.classic.filter.ThresholdFilter">
        <level>${logging.level}</level>
    </filter>
    <file>
        ${logging.path}/glmapper-spring-boot/glmapper-loggerone.log
    </file>
    <rollingPolicy class="ch.qos.logback.core.rolling.TimeBasedRollingPolicy">
        <FileNamePattern>${logging.path}/glmapper-spring-boot/glmapper-loggerone.log.%d{yyyy-MM-dd}</FileNamePattern>
        <MaxHistory>30</MaxHistory>
    </rollingPolicy>
    <encoder class="ch.qos.logback.classic.encoder.PatternLayoutEncoder">
        <pattern>%d{yyyy-MM-dd HH:mm:ss.SSS} [%thread] %-5level %logger{50} - %msg%n</pattern>
        <charset>UTF-8</charset>
    </encoder>
</appender>
複製代碼

appender 有兩個屬性 name和class;name指定appender名稱，class指定appender的全限定名。上面聲明的是名爲GLMAPPER-LOGGERONE，class爲ch.qos.logback.core.rolling.RollingFileAppender的一個appender。

appender 的種類

  • ConsoleAppender：把日誌添加到控制檯
  • FileAppender：把日誌添加到文件
  • RollingFileAppender：滾動記錄文件，先將日誌記錄到指定文件，當符合某個條件時，將日誌記錄到其餘文件。它是FileAppender的子類

append 子標籤

<append>true</append>
複製代碼

若是是 true，日誌被追加到文件結尾，若是是false，清空現存文件，默認是true。

filter 子標籤

在簡介中提到了filter；做用就是上面說的。能夠爲appender 添加一個或多個過濾器，能夠用任意條件對日誌進行過濾。appender 有多個過濾器時，按照配置順序執行。

ThresholdFilter

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

<filter class="ch.qos.logback.classic.filter.ThresholdFilter">
    <level>INFO</level>
</filter>
複製代碼

LevelFilter

級別過濾器，根據日誌級別進行過濾。若是日誌級別等於配置級別，過濾器會根據onMath(用於配置符合過濾條件的操做) 和 onMismatch(用於配置不符合過濾條件的操做)接收或拒絕日誌。

<filter class="ch.qos.logback.classic.filter.LevelFilter">   
  <level>INFO</level>   
  <onMatch>ACCEPT</onMatch>   
  <onMismatch>DENY</onMismatch>   
</filter> 
複製代碼

關於NEUTRAL、ACCEPT、DENY 見上文簡介中關於filter的介紹。

file 子標籤

file 標籤用於指定被寫入的文件名，能夠是相對目錄，也能夠是絕對目錄，若是上級目錄不存在會自動建立，沒有默認值。

<file>
    ${logging.path}/glmapper-spring-boot/glmapper-loggerone.log
</file>
複製代碼

這個表示當前appender將會將日誌寫入到${logging.path}/glmapper-spring-boot/glmapper-loggerone.log這個目錄下。

rollingPolicy 子標籤

這個子標籤用來描述滾動策略的。這個只有appender的class是RollingFileAppender時才須要配置。這個也會涉及文件的移動和重命名（a.log->a.log.2018.07.22）。

TimeBasedRollingPolicy

最經常使用的滾動策略，它根據時間來制定滾動策略，既負責滾動也負責出發滾動。這個下面又包括了兩個屬性：

  • FileNamePattern
  • maxHistory
<rollingPolicy class="ch.qos.logback.core.rolling.TimeBasedRollingPolicy">
    <!--日誌文件輸出的文件名:按天回滾 daily -->
    <FileNamePattern>
        ${logging.path}/glmapper-spring-boot/glmapper-loggerone.log.%d{yyyy-MM-dd}
    </FileNamePattern>
    <!--日誌文件保留天數-->
    <MaxHistory>30</MaxHistory>
</rollingPolicy>
複製代碼

上面的這段配置代表天天生成一個日誌文件，保存30天的日誌文件

FixedWindowRollingPolicy

根據固定窗口算法重命名文件的滾動策略。

encoder 子標籤

對記錄事件進行格式化。它幹了兩件事：

  • 把日誌信息轉換成字節數組
  • 把字節數組寫入到輸出流
<encoder class="ch.qos.logback.classic.encoder.PatternLayoutEncoder">
    <pattern>%d{yyyy-MM-dd HH:mm:ss.SSS} [%thread] %-5level %logger{50}
    - %msg%n</pattern>
    <charset>UTF-8</charset>
</encoder>
複製代碼

目前encoder只有PatternLayoutEncoder一種類型。

定義一個只打印error級別日誌的appcener

<!-- 錯誤日誌 appender ： 按照天天生成日誌文件 -->
<appender name="ERROR-APPENDER" class="ch.qos.logback.core.rolling.RollingFileAppender">
    <append>true</append>
    <!-- 過濾器，只記錄 error 級別的日誌 -->
    <filter class="ch.qos.logback.classic.filter.ThresholdFilter">
        <level>error</level>
    </filter>
    <!-- 日誌名稱 -->
    <file>${logging.path}/glmapper-spring-boot/glmapper-error.log</file>
    <!-- 天天生成一個日誌文件，保存30天的日誌文件 -->
    <rollingPolicy class="ch.qos.logback.core.rolling.TimeBasedRollingPolicy">
        <!--日誌文件輸出的文件名:按天回滾 daily -->
        <FileNamePattern>${logging.path}/glmapper-spring-boot/glmapper-error.log.%d{yyyy-MM-dd}</FileNamePattern>
        <!--日誌文件保留天數-->
        <MaxHistory>30</MaxHistory>
    </rollingPolicy>
    <encoder class="ch.qos.logback.classic.encoder.PatternLayoutEncoder">
        <!--格式化輸出：%d表示日期，%thread表示線程名，%-5level：級別從左顯示5個字符寬度%msg：日誌消息，%n是換行符-->
        <pattern>%d{yyyy-MM-dd HH:mm:ss.SSS} [%thread] %-5level %logger{50} - %msg%n</pattern>
        <!-- 編碼 -->
        <charset>UTF-8</charset>
    </encoder>
</appender>
複製代碼

定義一個輸出到控制檯的appender

<!-- 默認的控制檯日誌輸出，通常生產環境都是後臺啓動，這個沒太大做用 -->
<appender name="STDOUT" class="ch.qos.logback.core.ConsoleAppender">
    <encoder class="ch.qos.logback.classic.encoder.PatternLayoutEncoder">
        <Pattern>%d{HH:mm:ss.SSS} %-5level %logger{80} - %msg%n</Pattern>
    </encoder>
</appender>
複製代碼

logger 配置詳解

<logger name="com.glmapper.spring.boot.controller" level="${logging.level}" additivity="false">
    <appender-ref ref="GLMAPPER-LOGGERONE" />
</logger>
複製代碼

上面的這個配置文件描述的是：com.glmapper.spring.boot.controller這個包下的${logging.level}級別的日誌將會使用GLMAPPER-LOGGERONE來打印。logger有三個屬性和一個子標籤：

  • name:用來指定受此logger約束的某一個包或者具體的某一個類。
  • level:用來設置打印級別（TRACE, DEBUG, INFO, WARN, ERROR, ALL 和 OFF），還有一個值INHERITED或者同義詞NULL，表明強制執行上級的級別。若是沒有設置此屬性，那麼當前logger將會繼承上級的級別。
  • addtivity:用來描述是否向上級logger傳遞打印信息。默認是true。

appender-ref則是用來指定具體appender的。

不一樣日誌隔離打印案例

在前面的例子中咱們有三種appender,一個是指定包約束的，一個是控制error級別的，一個是控制檯的。而後這小節咱們就來實現下不一樣日誌打印到不一樣的log文件中。

根據包進行日誌文件隔離

這個例子裏咱們將com.glmapper.spring.boot.controller中的日誌輸出到glmapper-controller.log；將com.glmapper.spring.boot.service中的日誌輸出到glmapper-service.log。

<!--打印日誌到glmapper-service.log的appender-->
<appender name="GLMAPPER-SERVICE" class="ch.qos.logback.core.rolling.RollingFileAppender">
    <append>true</append>
    <filter class="ch.qos.logback.classic.filter.ThresholdFilter">
        <level>${logging.level}</level>
    </filter>
    <file>
        ${logging.path}/glmapper-spring-boot/glmapper-service.log
    </file>
    <rollingPolicy class="ch.qos.logback.core.rolling.TimeBasedRollingPolicy">
        <FileNamePattern>${logging.path}/glmapper-spring-boot/glmapper-service.log.%d{yyyy-MM-dd}</FileNamePattern>
        <MaxHistory>30</MaxHistory>
    </rollingPolicy>
    <encoder class="ch.qos.logback.classic.encoder.PatternLayoutEncoder">
        <pattern>%d{yyyy-MM-dd HH:mm:ss.SSS} [%thread] %-5level %logger{50} - %msg%n</pattern>
        <charset>UTF-8</charset>
    </encoder>
</appender>

<!--打印日誌到glmapper-controller.log的appender-->
<appender name="GLMAPPER-CONTROLLER" class="ch.qos.logback.core.rolling.RollingFileAppender">
    <append>true</append>
    <filter class="ch.qos.logback.classic.filter.ThresholdFilter">
        <level>${logging.level}</level>
    </filter>
    <file>
        ${logging.path}/glmapper-spring-boot/glmapper-controller.log
    </file>
    <rollingPolicy class="ch.qos.logback.core.rolling.TimeBasedRollingPolicy">
        <FileNamePattern>${logging.path}/glmapper-spring-boot/glmapper-controller.log.%d{yyyy-MM-dd}</FileNamePattern>
        <MaxHistory>30</MaxHistory>
    </rollingPolicy>
    <encoder class="ch.qos.logback.classic.encoder.PatternLayoutEncoder">
        <pattern>%d{yyyy-MM-dd HH:mm:ss.SSS} [%thread] %-5level %logger{50} - %msg%n</pattern>
        <charset>UTF-8</charset>
    </encoder>
</appender>

<!--此logger約束將.controller包下的日誌輸出到GLMAPPER-CONTROLLER，錯誤日誌輸出到GERROR-APPENDE；GERROR-APPENDE見上面-->
<logger name="com.glmapper.spring.boot.controller" level="${logging.level}" additivity="false">
    <appender-ref ref="GLMAPPER-CONTROLLER" />
    <appender-ref ref="GERROR-APPENDER" />
</logger>

<!--此logger約束將.service包下的日誌輸出到GLMAPPER-SERVICE，錯誤日誌輸出到GERROR-APPENDE；GERROR-APPENDE見上面-->
<logger name="com.glmapper.spring.boot.service" level="${logging.level}" additivity="false">
    <appender-ref ref="GLMAPPER-SERVICE" />
    <appender-ref ref="GERROR-APPENDER" />
</logger>
複製代碼

來看運行結果

一、glmaper-controller

二、glmapper-service

三、glmapper-error

知足咱們的預期，可是這裏有個小問題。在info日誌裏出現了error,固然這是正常的。假如咱們不想在info裏面出現error怎麼辦呢？很簡單，咱們以APPENDER-SERVICE爲例，將filter過濾器進行修改：

將下面的：

<filter class="ch.qos.logback.classic.filter.ThresholdFilter">
    <level>${logging.level}</level>
</filter>
複製代碼

修改成：

<filter class="ch.qos.logback.classic.filter.LevelFilter">
    <level>ERROR</level>
    <!-- 若是命中就禁止這條日誌 -->
    <onMatch>DENY</onMatch>  
    <!-- 若是沒有命中就使用這條規則 -->
    <onMismatch>ACCEPT</onMismatch>  
</filter>
複製代碼

這裏同時要注意的是，在logger中level須要設置爲info級別。

根據類進行日誌文件隔離

這個其實也是和上面那個差不過，只不過粒度更細一點，通常狀況下好比說咱們有個定時任務類須要單獨來記錄其日誌信息，這樣咱們就能夠考慮使用基於類維度來約束打印。

<!--特殊功能單獨appender 例如調度類的日誌-->
<appender name="SCHEDULERTASKLOCK-APPENDER" class="ch.qos.logback.core.rolling.RollingFileAppender">
    <append>true</append>
    <filter class="ch.qos.logback.classic.filter.ThresholdFilter">
        <level>${logging.level}</level>
    </filter>
    <file>${logging.path}/glmapper-spring-boot/scheduler-task-lock.log</file>
    <!-- 天天生成一個日誌文件，保存30天的日誌文件 -->
    <rollingPolicy class="ch.qos.logback.core.rolling.TimeBasedRollingPolicy">
        <!--日誌文件輸出的文件名:按天回滾 daily -->
        <FileNamePattern>${logging.path}/glmapper-spring-boot/scheduler-task-lock.log.%d{yyyy-MM-dd}</FileNamePattern>
        <!--日誌文件保留天數-->
        <MaxHistory>30</MaxHistory>
    </rollingPolicy>
    <encoder class="ch.qos.logback.classic.encoder.PatternLayoutEncoder">
        <!--格式化輸出：%d表示日期，%thread表示線程名，%-5level：級別從左顯示5個字符寬度%msg：日誌消息，%n是換行符-->
        <pattern>%d{yyyy-MM-dd HH:mm:ss.SSS} [%thread] %-5level %logger{50} - %msg%n</pattern>
        <!-- 編碼 -->
        <charset>UTF-8</charset>
    </encoder>
</appender>

<!--這裏指定到了具體的某一個類-->
<logger name="com.glmapper.spring.boot.task.TestLogTask" level="${logging.level}" additivity="true">
        <appender-ref ref="SCHEDULERTASKLOCK-APPENDER" />
        <appender-ref ref="ERROR-APPENDER" />
    </logger>
複製代碼

最終TestLogTask中的日誌將會被打印到這個本身獨立的log文件中。以下所示：

根據自定義 logger 的 name 進行日誌文件隔離

logger的name除了類、包等約束以外，固然還能夠這樣來玩。。。

在進行案例以前，這裏先把前面案例中logger聲明的代碼貼一下，以做對比,以TestLogTask類中的日誌爲例：

private static final Logger LOGGER =
 LoggerFactory.getLogger(TestLogTask.class);
複製代碼

在getLogger中咱們是將當前對象的class做爲參數的，這個是爲了打印時獲取其全限定名的（見下面3-）。

1-2018-07-21 11:15:42.003 [pool-1-thread-1] 
2-INFO  
3-com.glmapper.spring.boot.task.TestLogTask -
4-com.glmapper.spring.boot.task:info
複製代碼

業務類定義

咱們一樣是service包下定義一個類TestLogNameServiceImpl

package com.glmapper.spring.boot.service;

@Service("testLogNameService")
public class TestLogNameServiceImpl implements TestLogNameService {

    private static final Logger LOGGER =
    LoggerFactory.getLogger("GLMAPPER-TEST-LOG");

    @Override
    public void print() {
        LOGGER.info("GLMAPPER-TEST-LOG:this is special logger-----info");
        LOGGER.error("GLMAPPER-TEST-LOG:this is special logger-------error");
    }
}
複製代碼

appender和logger配置

<appender name="ROOT-APPENDER" class="ch.qos.logback.core.rolling.RollingFileAppender">
    <append>true</append>
    <filter class="ch.qos.logback.classic.filter.ThresholdFilter">
        <level>${logging.level}</level>
    </filter>
    <file>${logging.path}/glmapper-spring-boot/glmapper-test.log</file>
    <!-- 天天生成一個日誌文件，保存30天的日誌文件 -->
    <rollingPolicy class="ch.qos.logback.core.rolling.TimeBasedRollingPolicy">
        <!--日誌文件輸出的文件名:按天回滾 daily -->
        <FileNamePattern>${logging.path}/glmapper-spring-boot/glmapper-test.log.%d{yyyy-MM-dd}
        </FileNamePattern>
        <!--日誌文件保留天數-->
        <MaxHistory>30</MaxHistory>
    </rollingPolicy>
    <encoder class="ch.qos.logback.classic.encoder.PatternLayoutEncoder">
        <!--格式化輸出：%d表示日期，%thread表示線程名，%-5level：級別從左顯示5個字符寬度%msg：日誌消息，%n是換行符-->
        <pattern>%d{yyyy-MM-dd HH:mm:ss.SSS} [%thread] %-5level %logger{50} - %msg%n</pattern>
        <!-- 編碼 -->
        <charset>UTF-8</charset>
    </encoder>
</appender>

<!--這裏的name和業務類中的getLogger中的字符串是同樣的-->
<logger name="GLMAPPER-TEST-LOG" level="${logging.level}" additivity="true">
        <appender-ref ref="ROOT-APPENDER" />
        <appender-ref ref="ERROR-APPENDER" />
    </logger>
複製代碼

咱們這個預期的是TestLogNameServiceImpl中的日誌不打印到glmapper-service.log中，而是打印到glmapper-test.log中。

一、glmapper-test.log

二、glmapper-service.log

知足咱們的預期。

如何使用logback打印mybatis的sql語句

這個仍是比較坑的。爲何。看下這個：

<settings>
    <setting name="logImpl" value="slf4j" />
</settings>
複製代碼

在mybatis-configration.xml中，咱們經過這樣一個配置項來關聯到具體的日誌組件。可是logImpl的實現中是沒有logback的。那麼怎麼辦呢？這裏只能經過slf4j的方式橋接到logback。

而後在咱們的logback-spring.xml中進行以下配置：

<!-- 將sql語句輸出到具體的日誌文件中 -->
<logger name="com.alipay.sofa.cloudplatform.common.dao" level="${logging.sql.level}" additivity="false">
    <appender-ref ref="SQL-APPENDER"/>
</logger>
複製代碼

這裏有幾個點須要注意的。首先是${logging.sql.level}這個必須是debug，這個是由mybatis自己實現決定的。而這裏的name設定的com.alipay.sofa.cloudplatform.common.dao值就是咱們dao接口的包路徑。

網上看了一個比較典型的案例，這種方式只能輸出到控制檯，並不能將文件輸出到日誌文件；它是根據內部的一個實現機制偷了個懶。mybatis用logback日誌不顯示sql的解決辦法。

總結

本篇博客主要是整理最近工做中的一些日誌配置積累，將每一個細節進行總結一下，以做備忘。若是有時間的話會考慮看一個日誌框架的源碼。其實我以爲仍是頗有必要的，日誌組件畢竟是須要進行日誌文件落盤的，這個會涉及到許多的性能問題、緩衝區問題、隊列問題、固然還有一些鎖的問題、同步打印或者異步打印等問題。有興趣的小夥伴能夠看看，而後分享給咱們。

後面準備寫一寫螞蟻金服SOFABoot和SpringBoot的一些文章，若是有興趣能夠先看一波。

SOFABoot GitHub 傳送門

相關文章
相關標籤/搜索
每日一句
    每一个你不满意的现在，都有一个你没有努力的曾经。
本站公眾號
   歡迎關注本站公眾號,獲取更多信息
聯繫我們 最近搜索 最新文章 沪ICP备13005482号-10 MyBatis教程 SQL 教程 MySQL教程 Java 教程 Thymeleaf 教程 Hibernate教程 Spring教程 Redis教程