SpringBoot學習篇2[日誌配置]

一 SpringBoot默認日誌配置

SpringBoot爲Java Util Logging,Log4J2和Logback提供了默認配置。SpringBoot默認配置日誌輸出到控制檯,同時還提供可選文件輸出。
SpringBoot默認採用SLF4j(日誌抽象層)+ Logback(日誌實現)的組合。

1.1 日誌輸出實戰

  1. 新創建SpringBoot工程,起名爲spring-boot-logging
    在這裏插入圖片描述
    先直接運行程序,看控制檯的輸出
    在這裏插入圖片描述
    可以看到,在不做任何配置的情況下,控制檯已經有日誌輸出了。這也印證了我們前面所說的。

接下來在測試類中使用一下SpringBoot的日誌:

package com.yky.springboot;

import org.junit.jupiter.api.Test;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
import org.springframework.boot.test.context.SpringBootTest;

@SpringBootTest
class SpringBootLoggingApplicationTests {

    private Logger logger = LoggerFactory.getLogger(getClass());
    @Test
    void contextLoads() {
        logger.info("這是info級別的日誌");
    }

}

注:這裏使用的Logger的全類名是org.slf4j.Logger

輸出結果
在這裏插入圖片描述

1.2 控制檯輸出

通過上面的驗證,可以得出結論:
SpringBoot的日誌記錄器,默認情況下在控制檯輸出以下項目:

  • 日期和時間:毫秒精度,易於排序。
  • 日誌級別:ERROR,WARN,INFO,DEBUG,或TRACE。
  • 進程ID。
  • 一個—分隔符來區分實際日誌消息的開始。
  • 線程名稱:用方括號括起來(對於控制檯輸出可能會被截斷)。
  • 記錄器名稱:這通常是源類名稱(通常縮寫)。
  • 日誌消息。

1.3 文件輸出

SpringBoot默認情況下只在控制檯輸出日誌。要想讓它輸出日誌到文件,需要更改其默認配置,此時需要設置logging.file.name或logging.file.path的屬性值。

logging.file.name logging.file.path 示例 描述
null null 只在控制檯輸出
給定值 null my.log 寫入指定的日誌文件。名稱可以是確切位置,也可以是相對於當前目錄的位置。
null 給定值 /var/log 寫入日誌到指定目錄,名稱可以是確切位置,也可以是相對於當前目錄的位置,文件名爲springboot.log
給定值 給定值 同時賦值,優先採用logging.file.name
  • SpringBoot默認配置單個日誌文件大小限定爲10M,當單個文件達到所設定的最大大小時,將會產生一個備份文件,並創建一個新的日誌文件重新記錄當前日誌。可以通過更改logging.file.max-size屬性更改大小限制。

注意:

  • 與控制檯輸出一樣,默認情況下會記錄ERROR-level,WARN-level和INFO-level的日誌消息。

  • 除非logging.file.max-history已設置屬性,否則將會無限期存檔。

  • 日誌檔案的總大小可以通過設置logging.file.total-size-cap的值來限定。當日志歸檔的總大小超過該閾值時,將刪除備份。要在應用程序啓動時強制清除日誌存檔,請使用logging.file.clean-history-on-start屬性。

上面全是在講理論,接下來實踐一下,在resources目錄新創建application.yml文件並寫入以下內容:

logging:
  file:
    name: /Users/yky/springboot/log/my.log

運行測試程序看一下:
在這裏插入圖片描述

二 常用日誌配置的修改

2.1 輸出級別

日誌記錄器包含以下級別(級別由低到高):

級別 示例 說明
trace logger.trace(“消息內容”) 跟蹤運行信息
debug logger.debug(“消息內容”) 調試信息
info logger.info(“消息內容”) 自定義信息
warn logger.warn(“消息內容”) 警告信息
error logger.error(“消息內容”) 錯誤信息

驗證一下:

		logger.trace("這是trace級別的日誌");
        logger.debug("這是debug級別的日誌");
        logger.info("這是info級別的日誌");
        logger.warn("這是warn級別的日誌");
        logger.error("這是error級別的日誌");

控制檯輸出結果:
在這裏插入圖片描述
日誌文件輸出結果:
在這裏插入圖片描述
可以看到,無論是控制檯還是文件,都只輸出了高於等於INFO級別的日誌,這是因爲SpringBoot默認配置的日誌輸出級別是INFO級別。若想修改日誌輸出級別可以通過設置“logging.level.root”屬性設置全局日誌輸出級別,還可以通過設置“logging.level.包名”設置某個包下的日誌輸出級別。

logging:
  file:
    name: /Users/yky/springboot/log/my.log
  level:
    root: debug

在設置了全局日誌輸出級別爲DEBUG後,可以看到高於等於DEBUG級別的日誌被打印了出來:
在這裏插入圖片描述
還可以針對某個包,設置其日誌級別,比如設定com.yky.springboot包下的日誌記錄器的日誌輸出級別爲trace:

logging:
  file:
    name: /Users/yky/springboot/log/my.log
  level:
    root: info
    com.yky.springboot: trace

控制檯輸出結果:
在這裏插入圖片描述
文件輸出結果:
在這裏插入圖片描述
從這裏可以看出,當logging.level.root和logging.level.包名 屬性同時被設置時,前者不會覆蓋掉後者。

2.2 修改日誌輸出格式

可以通過設置logging.pattern.console和logging.pattern.file分別配置日誌輸出到控制檯以及輸出到文件的格式。

logging:
  file:
    name: /Users/yky/springboot/log/my.log
  level:
    com.yky.springboot: trace
    root: info
  pattern:
    console: "%d{yyyy-MM-dd HH:mm:ss.SSS} >>> [%thread] >>> %-5level >>> %logger{50} >>> %msg%n"
    file: "%d{yyyy-MM-dd HH:mm:ss.SSS} --- [%thread] --- %-5level --- %logger{50} --- %msg%n"
  • %d{yyyy-MM-dd HH:mm:ss.SSS}——日誌輸出時間
  • %thread——輸出日誌的進程名字
  • %-5level——日誌級別,並且使用5個字符靠左對齊
  • %logger——日誌全類名長度限定爲50
  • %msg——日誌消息
  • %n——平臺的換行符

控制檯輸出效果:
在這裏插入圖片描述
文件輸出效果 :
在這裏插入圖片描述

2.3 日誌滾動輸出

和日誌滾動輸出有關的屬性有下面這幾個:

  • logging.file.max-size:單個日誌文件的最大大小(大於此大小時,保留日誌存檔,並創建一個新的日誌文件),默認10M
  • logging.file.max-history:設置最大存檔數,如果不設置此項,則會無限存檔(SpringBoot 2.1+默認爲7)。
  • logging.file.total-size-cap:配置日誌的總大小,超過此大小將刪除備份

上面的屬性介紹完了,接下來實戰一下。爲了方便看到效果,設置logging.file.max-size爲10KB,設置logging.file.max-history爲3,並清空之前的日誌文件:

logging:
  file:
    name: /Users/yky/springboot/log/my.log
    max-history: 3
    max-size: 10KB
  level:
    com.yky.springboot: trace
    root: info
  pattern:
    console: "%d{yyyy-MM-dd HH:mm:ss.SSS} >>> [%thread] >>> %-5level >>> %logger{50} >>> %msg%n"
    file: "%d{yyyy-MM-dd HH:mm:ss.SSS} --- [%thread] --- %-5level --- %logger{50} --- %msg%n"

運行幾次程序後看一下效果:
在這裏插入圖片描述
可以看到,在日誌大小達到特定大小時,SpringBoot會將當前存檔壓縮備份,並新創建一個log文件,重新存儲當前日誌。

解壓一下壓縮文件,看一看壓縮前的大小,正是我們所期望的(當存儲完某一條日誌後發現文件大小超出了10KB,此時才觸發滾動輸出操作,所以在這裏看到的大小比10KB大一點點):
在這裏插入圖片描述

2.4 總結

SpringBoot官方文檔對日誌配置這一塊兒給出了很詳細的說明:
在這裏插入圖片描述
文檔鏈接:SpringBoot日誌配置

三 自定義日誌配置

3.1 爲什麼要自定義日誌配置

爲什麼要用到SpringBoot的自定義日誌配置?在開始之前肯定要先搞清楚這一點。
原因很簡單:當SpringBoot提供的日誌功能滿足不了我們的需求時,就需要用到自定義日誌配置了(比如高併發環境下,爲了儘可能的不讓日誌拖慢程序運行速度,需要將Logback配置成異步日誌記錄器)。

3.2 自定義日誌配置

SpringBoot支持自定義日誌配置,正如官方文檔裏所說:
在這裏插入圖片描述
如果想要使用自動義配置文件(當使用Logback作爲日誌實現時),只需要在配置文件目錄下給出logback-spring.xml, logback-spring.groovy, logback.xml, or logback.groovy這幾個文件中的某一個配置文件即可。

在這裏推薦使用logback-spring.xml文件作爲自定義配置文件的文件名:因爲在使用logback-spring.xxxx時,會先將配置送由SpringBoot進行解析(比如要想支持Profile特殊配置,必須命名爲logback-spring.xxxx這種形式),而在使用logback.xml時,配置文件將直接被日誌框架加載。使用logback-spring.xxxx將使SpringBoot得到完全控制權。
在resources目錄下創建logback-spring.xml並寫入以下內容:

<?xml version="1.0" encoding="UTF-8"?>
<!--
scan:當此屬性設置爲true時,配置文件如果發生改變,將會被重新加載,默認值爲true。
scanPeriod:設置監測配置文件是否有修改的時間間隔,如果沒有給出時間單位,默認單位是毫秒當scan爲true時,此屬性生效。默認的時間間隔爲1分鐘。
debug:當此屬性設置爲true時,將打印出logback內部日誌信息,實時查看logback運行狀態。默認值爲false。
-->
<configuration scan="false" scanPeriod="60 seconds" debug="false">
    <!-- 定義日誌的根目錄 -->
    <property name="LOG_HOME" value="/Users/yky/springboot/log" />
    <!-- 定義日誌文件名稱 -->
    <property name="appName" value="my-log"></property>
    <!-- ch.qos.logback.core.ConsoleAppender 表示控制檯輸出 -->
    <appender name="stdout" class="ch.qos.logback.core.ConsoleAppender">
        <!--
			日誌輸出格式說明:
				    %d 		輸出日期時間
				    %thread 輸出當前線程名
				    %-5level  	輸出日誌級別,左對齊5個字符寬度
				    %logger{50} 輸出全類名最長50個字符,超過按照句點分割
				    %msg  	日誌信息
				    %n    	換行符
        -->
        <layout class="ch.qos.logback.classic.PatternLayout">
<!--            支持根據不同的環境做選擇-->
            <springProfile name="dev">
                <pattern>%d{yyyy-MM-dd HH:mm:ss.SSS} [ %thread ] - [ %-5level ] [ %logger{50} : %line ] - %msg%n</pattern>
            </springProfile>
            <springProfile name="!dev">
                <pattern>%d{yyyy-MM-dd HH:mm:ss.SSS} [ %thread ] >>> [ %-5level ] [ %logger{50} : %line ] >>> %msg%n</pattern>
            </springProfile>
        </layout>
    </appender>

    <!-- 滾動記錄文件,先將日誌記錄到指定文件,當符合某個條件時,將日誌記錄到其他文件 -->  
    <appender name="appLogAppender" class="ch.qos.logback.core.rolling.RollingFileAppender">
        <!-- 指定日誌文件的名稱 -->
        <file>${LOG_HOME}/${appName}.log</file>
        <!--
        當發生滾動時,決定 RollingFileAppender 的行爲,涉及文件移動和重命名
        TimeBasedRollingPolicy: 最常用的滾動策略,它根據時間來制定滾動策略,既負責滾動也負責出發滾動。
        -->
        <rollingPolicy class="ch.qos.logback.core.rolling.TimeBasedRollingPolicy">
            <!--
				滾動時產生的文件的存放位置及文件名稱 %d{yyyy-MM-dd}:按天進行日誌滾動 
				%i:當文件大小超過maxFileSize時,按照i進行文件滾動
            -->
            <fileNamePattern>${LOG_HOME}/${appName}-%d{yyyy-MM-dd}-%i.log</fileNamePattern>
            <!-- 
            可選節點,控制保留的歸檔文件的最大數量,超出數量就刪除舊文件。
			假設設置每天滾動,且maxHistory是365,則只保存最近365天的文件,刪除之前的舊文件。
			注意,刪除舊文件是,那些爲了歸檔而創建的目錄也會被刪除。
            -->
            <MaxHistory>365</MaxHistory>
            <!-- 
            當日志文件超過maxFileSize指定的大小是,根據上面提到的%i進行日誌文件滾動 注意此處配置SizeBasedTriggeringPolicy是無法實現按文件大小進行滾動的,必須配置timeBasedFileNamingAndTriggeringPolicy
            -->
            <timeBasedFileNamingAndTriggeringPolicy class="ch.qos.logback.core.rolling.SizeAndTimeBasedFNATP">
                <maxFileSize>100MB</maxFileSize>
            </timeBasedFileNamingAndTriggeringPolicy>
        </rollingPolicy>
        <!-- 日誌輸出格式: -->     
        <layout class="ch.qos.logback.classic.PatternLayout">
            <springProfile name="dev">
                <pattern>%d{yyyy-MM-dd HH:mm:ss.SSS} [ %thread ] - [ %-5level ] [ %logger{50} : %line ] - %msg%n</pattern>
            </springProfile>
            <springProfile name="!dev">
                <pattern>%d{yyyy-MM-dd HH:mm:ss.SSS} [ %thread ] >>> [ %-5level ] [ %logger{50} : %line ] >>> %msg%n</pattern>
            </springProfile>
        </layout>
    </appender>

    <!-- 
		logger主要用於存放日誌對象,也可以定義日誌類型、級別
		name:表示匹配的logger類型前綴,也就是包的前半部分
		level:要記錄的日誌級別,包括 TRACE < DEBUG < INFO < WARN < ERROR
		additivity:作用在於children-logger是否使用 rootLogger配置的appender進行輸出,
		false:表示只用當前logger的appender-ref,true:
		表示當前logger的appender-ref和rootLogger的appender-ref都有效
    -->
    <!-- hibernate logger -->
    <logger name="com.yky" level="debug"/>
    <!-- Spring framework logger -->
    <logger name="org.springframework" level="debug" additivity="false"></logger>


    <!-- 
    root與logger是父子關係,沒有特別定義則默認爲root,任何一個類只會和一個logger對應,
    要麼是定義的logger,要麼是root,判斷的關鍵在於找到這個logger,然後判斷這個logger的appender和level。 
    -->
    <root level="info">
        <appender-ref ref="stdout" />
        <appender-ref ref="appLogAppender" />
    </root>
</configuration> 

在上面的配置中,還用到了Profile特殊配置。使用Profile特殊配置,可根據不同的環境激活不同的日誌配置
在這裏插入圖片描述
生產環境下的日誌輸出:
在這裏插入圖片描述
開發環境下的日誌輸出:
在這裏插入圖片描述
關於SpringBoot的日誌配置就寫到這裏,如果有什麼紕漏,歡迎在評論區指出。

發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章