SpringBoot日志的配置及輸出的方法是什么

這篇文章主要介紹“SpringBoot日志的配置及輸出的方法是什么”，在日常操作中，相信很多人在SpringBoot日志的配置及輸出的方法是什么問(wèn)題上存在疑惑，小編查閱了各式資料，整理出簡(jiǎn)單好用的操作方法，希望對(duì)大家解答”SpringBoot日志的配置及輸出的方法是什么”的疑惑有所幫助！接下來(lái)，請(qǐng)跟著小編一起來(lái)學(xué)習(xí)吧！

默認(rèn)配置

Spring Boot 默認(rèn)使用 SLF4J+Logback 記錄日志，并提供了默認(rèn)配置，即使我們不進(jìn)行任何額外配，也可以使用 SLF4J+Logback 進(jìn)行日志輸出。

常見(jiàn)的日志配置包括日志級(jí)別、日志的輸入出格式等內(nèi)容。

日志級(jí)別

日志的輸出都是分級(jí)別的，當(dāng)一條日志信息的級(jí)別大于或等于配置文件的級(jí)別時(shí)，就對(duì)這條日志進(jìn)行記錄。

常見(jiàn)的日志級(jí)別如下（優(yōu)先級(jí)依次升高）。

輸出格式

我們可以通過(guò)以下常用日志參數(shù)對(duì)日志的輸出格式進(jìn)行修改，如下表。

示例 1

下面我們通過(guò)一個(gè)實(shí)例，來(lái)查看 Spring Boot 提供了哪些默認(rèn)日志配置。

1. 在 Spring Boot 中編寫(xiě) Java 測(cè)試類(lèi)，代碼如下。

package net.biancheng.www;
import org.junit.jupiter.api.Test;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
import org.springframework.boot.test.context.SpringBootTest;
@SpringBootTest
class SpringbootLoggingApplicationTests {
    Logger logger = LoggerFactory.getLogger(getClass());
    /**
     * 測(cè)試日志輸出
     * SLF4J 日志級(jí)別從小到大trace>debug>info>warn>error
     */
    @Test
    void logTest() {
        //日志級(jí)別 由低到高
        logger.trace("trace 級(jí)別日志");
        logger.debug("debug 級(jí)別日志");
        logger.info("info 級(jí)別日志");
        logger.warn("warn 級(jí)別日志");
        logger.error("error 級(jí)別日志");
    }
}

2. 執(zhí)行該測(cè)試，控制臺(tái)輸出如下圖。

圖1：Spring Boot 日志級(jí)別

通過(guò)控制臺(tái)輸出結(jié)果可知，Spring Boot 日志默認(rèn)級(jí)別為 info，日志輸出內(nèi)容默認(rèn)包含以下元素：

• 時(shí)間日期

• 日志級(jí)別

• 進(jìn)程 ID

• 分隔符：---

• 線程名：方括號(hào)括起來(lái)（可能會(huì)截?cái)嗫刂婆_(tái)輸出）

• Logger 名稱

• 日志內(nèi)容

修改默認(rèn)日志配置

我們可以根據(jù)自身的需求，通過(guò)全局配置文件（application.properties/yml）修改 Spring Boot 日志級(jí)別和顯示格式等默認(rèn)配置。

 在 application.properties 中，修改 Spring Boot 日志的默認(rèn)配置，代碼如下。

#日志級(jí)別
logging.level.net.biancheng.www=trace
#使用相對(duì)路徑的方式設(shè)置日志輸出的位置（項(xiàng)目根目錄目錄\my-log\mylog\spring.log）
#logging.file.path=my-log/myLog
#絕對(duì)路徑方式將日志文件輸出到 【項(xiàng)目所在磁盤(pán)根目錄\springboot\logging\my\spring.log】
logging.file.path=/spring-boot/logging
#控制臺(tái)日志輸出格式
logging.pattern.console=%d{yyyy-MM-dd hh:mm:ss} [%thread] %-5level %logger{50} - %msg%n
#日志文件輸出格式
logging.pattern.file=%d{yyyy-MM-dd} === [%thread] === %-5level === %logger{50} === - %msg%n

執(zhí)行測(cè)試代碼，執(zhí)行結(jié)果如下。

圖2：Spring Boot 日志修改默認(rèn)配置

從圖 2 可以看到，控制臺(tái)中日志的輸出格式與 application.properties 中的 logging.pattern.console 配置一致。

查看本地日志文件 spring.log，該文件日志輸出內(nèi)容如下圖。

圖3：本地日志文件 spring.log

從圖 3 可以看到，本地日志文件中的日志輸出格式與 application.properties 中 logging.pattern.file 配置一致。

自定義日志配置

在 Spring Boot 的配置文件 application.porperties/yml 中，可以對(duì)日志的一些默認(rèn)配置進(jìn)行修改，但這種方式只能修改個(gè)別的日志配置，想要修改更多的配置或者使用更高級(jí)的功能，則需要通過(guò)日志實(shí)現(xiàn)框架自己的配置文件進(jìn)行配置。

Spring 官方提供了各個(gè)日志實(shí)現(xiàn)框架所需的配置文件，用戶只要將指定的配置文件放置到項(xiàng)目的類(lèi)路徑下即可。

從上表可以看出，日志框架的配置文件基本上被分為 2 類(lèi)：

• 普通日志配置文件，即不帶 srping 標(biāo)識(shí)的配置文件，例如 logback.xml；

• 帶有 spring 表示的日志配置文件，例如 logback-spring.xml。

這兩種日志配置文件在使用時(shí)大不相同，下面我們就對(duì)它們分別進(jìn)行介紹。

普通日志配置文件

我們將 logback.xml、log4j2.xml 等不帶 spring 標(biāo)識(shí)的普通日志配置文件，放在項(xiàng)目的類(lèi)路徑下后，這些配置文件會(huì)跳過(guò) Spring Boot，直接被日志框架加載。通過(guò)這些配置文件，我們就可以達(dá)到自定義日志配置的目的。

示例

1. 將 logback.xml 加入到 Spring Boot 項(xiàng)目的類(lèi)路徑下（resources 目錄下），該配置文件配置內(nèi)容如下。

<?xml version="1.0" encoding="UTF-8"?>
<!--
scan：當(dāng)此屬性設(shè)置為true時(shí)，配置文件如果發(fā)生改變，將會(huì)被重新加載，默認(rèn)值為true。
scanPeriod：設(shè)置監(jiān)測(cè)配置文件是否有修改的時(shí)間間隔，如果沒(méi)有給出時(shí)間單位，默認(rèn)單位是毫秒當(dāng)scan為true時(shí)，此屬性生效。默認(rèn)的時(shí)間間隔為1分鐘。
debug：當(dāng)此屬性設(shè)置為true時(shí)，將打印出logback內(nèi)部日志信息，實(shí)時(shí)查看logback運(yùn)行狀態(tài)。默認(rèn)值為false。
-->
<configuration scan="false" scanPeriod="60 seconds" debug="false">
    <!-- 定義日志的根目錄 -->
    <property name="LOG_HOME" value="/app/log"/>
    <!-- 定義日志文件名稱 -->
    <property name="appName" value="bianchengbang-spring-boot-logging"></property>
    <!-- ch.qos.logback.core.ConsoleAppender 表示控制臺(tái)輸出 -->
    <appender name="stdout" class="ch.qos.logback.core.ConsoleAppender">
        <!--
        日志輸出格式：
   %d表示日期時(shí)間，
   %thread表示線程名，
   %-5level：級(jí)別從左顯示5個(gè)字符寬度
   %logger{50} 表示logger名字最長(zhǎng)50個(gè)字符，否則按照句點(diǎn)分割。
   %msg：日志消息，
   %n是換行符
        -->
        <layout class="ch.qos.logback.classic.PatternLayout">
            <pattern>%d{yyyy-MM-dd HH:mm:ss} [%thread]**************** %-5level %logger{50} - %msg%n</pattern>
        </layout>
    </appender>
    <!-- 滾動(dòng)記錄文件，先將日志記錄到指定文件，當(dāng)符合某個(gè)條件時(shí)，將日志記錄到其他文件 -->
    <appender name="appLogAppender" class="ch.qos.logback.core.rolling.RollingFileAppender">
        <!-- 指定日志文件的名稱 -->
        <file>${LOG_HOME}/${appName}.log</file>
        <!--
        當(dāng)發(fā)生滾動(dòng)時(shí)，決定 RollingFileAppender 的行為，涉及文件移動(dòng)和重命名
        TimeBasedRollingPolicy： 最常用的滾動(dòng)策略，它根據(jù)時(shí)間來(lái)制定滾動(dòng)策略，既負(fù)責(zé)滾動(dòng)也負(fù)責(zé)出發(fā)滾動(dòng)。
        -->
        <rollingPolicy class="ch.qos.logback.core.rolling.TimeBasedRollingPolicy">
            <!--
            滾動(dòng)時(shí)產(chǎn)生的文件的存放位置及文件名稱 %d{yyyy-MM-dd}：按天進(jìn)行日志滾動(dòng)
            %i：當(dāng)文件大小超過(guò)maxFileSize時(shí)，按照i進(jìn)行文件滾動(dòng)
            -->
            <fileNamePattern>${LOG_HOME}/${appName}-%d{yyyy-MM-dd}-%i.log</fileNamePattern>
            <!--
            可選節(jié)點(diǎn)，控制保留的歸檔文件的最大數(shù)量，超出數(shù)量就刪除舊文件。假設(shè)設(shè)置每天滾動(dòng)，
            且maxHistory是365，則只保存最近365天的文件，刪除之前的舊文件。注意，刪除舊文件是，
            那些為了歸檔而創(chuàng)建的目錄也會(huì)被刪除。
            -->
            <MaxHistory>365</MaxHistory>
            <!--
            當(dāng)日志文件超過(guò)maxFileSize指定的大小是，根據(jù)上面提到的%i進(jìn)行日志文件滾動(dòng) 注意此處配置SizeBasedTriggeringPolicy是無(wú)法實(shí)現(xiàn)按文件大小進(jìn)行滾動(dòng)的，必須配置timeBasedFileNamingAndTriggeringPolicy
            -->
            <timeBasedFileNamingAndTriggeringPolicy class="ch.qos.logback.core.rolling.SizeAndTimeBasedFNATP">
                <maxFileSize>100MB</maxFileSize>
            </timeBasedFileNamingAndTriggeringPolicy>
        </rollingPolicy>
        <!-- 日志輸出格式： -->
        <layout class="ch.qos.logback.classic.PatternLayout">
            <pattern>%d{yyyy-MM-dd HH:mm:ss} [ %thread ] ------------------ [ %-5level ] [ %logger{50} : %line ] -
                %msg%n
            </pattern>
        </layout>
    </appender>
    <!--
  logger主要用于存放日志對(duì)象，也可以定義日志類(lèi)型、級(jí)別
  name：表示匹配的logger類(lèi)型前綴，也就是包的前半部分
  level：要記錄的日志級(jí)別，包括 TRACE < DEBUG < INFO < WARN < ERROR
  additivity：作用在于children-logger是否使用 rootLogger配置的appender進(jìn)行輸出，
  false：表示只用當(dāng)前l(fā)ogger的appender-ref，true：
  表示當(dāng)前l(fā)ogger的appender-ref和rootLogger的appender-ref都有效
    -->
    <!-- hibernate logger -->
    <logger name="net.biancheng.www" level="debug"/>
    <!-- Spring framework logger -->
    <logger name="org.springframework" level="debug" additivity="false"></logger>
    <!--
    root與logger是父子關(guān)系，沒(méi)有特別定義則默認(rèn)為root，任何一個(gè)類(lèi)只會(huì)和一個(gè)logger對(duì)應(yīng)，
    要么是定義的logger，要么是root，判斷的關(guān)鍵在于找到這個(gè)logger，然后判斷這個(gè)logger的appender和level。
    -->
    <root level="info">
        <appender-ref ref="stdout"/>
        <appender-ref ref="appLogAppender"/>
    </root>
</configuration>

2. 啟動(dòng)該項(xiàng)目并啟動(dòng)測(cè)試程序，結(jié)果如下。

.   ____          _            __ _ _

/\\ / ___'_ __ _ _(_)_ __  __ _ \ \ \ \

( ( )\___ | '_ | '_| | '_ \/ _` | \ \ \ \

\\/  ___)| |_)| | | | | || (_| |  ) ) ) )

'  |____| .__|_| |_|_| |_\__, | / / / /

=========|_|==============|___/=/_/_/_/

:: Spring Boot ::                (v2.5.0)

2021-05-24 14:51:11 [main]**************** INFO  n.biancheng.www.SpringBootLoggingApplicationTests - Starting SpringBootLoggingApplicationTests using Java 1.8.0_131 on LAPTOP-C67MRMAG with PID 20080 (started by 79330 in D:\eclipse workSpace4\spring-boot-logging)

2021-05-24 14:51:11 [main]**************** DEBUG n.biancheng.www.SpringBootLoggingApplicationTests - Running with Spring Boot v2.5.0, Spring v5.3.7

2021-05-24 14:51:11 [main]**************** INFO  n.biancheng.www.SpringBootLoggingApplicationTests - The following profiles are active: dev

2021-05-24 14:51:13 [main]**************** INFO  n.biancheng.www.SpringBootLoggingApplicationTests - Started SpringBootLoggingApplicationTests in 2.058 seconds (JVM running for 3.217)

2021-05-24 14:51:13 [main]**************** DEBUG n.biancheng.www.SpringBootLoggingApplicationTests - debug 級(jí)別日志

2021-05-24 14:51:13 [main]**************** INFO  n.biancheng.www.SpringBootLoggingApplicationTests - info 級(jí)別日志

2021-05-24 14:51:13 [main]**************** WARN  n.biancheng.www.SpringBootLoggingApplicationTests - warn 級(jí)別日志

2021-05-24 14:51:13 [main]**************** ERROR n.biancheng.www.SpringBootLoggingApplicationTests - error 級(jí)別日志

帶有 spring 標(biāo)識(shí)的日志配置文件

Spring Boot 推薦用戶使用 logback-spring.xml、log4j2-spring.xml 等這種帶有 spring 標(biāo)識(shí)的配置文件。這種配置文件被放在項(xiàng)目類(lèi)路徑后，不會(huì)直接被日志框架加載，而是由 Spring Boot 對(duì)它們進(jìn)行解析，這樣就可以使用 Spring Boot 的高級(jí)功能 Profile，實(shí)現(xiàn)在不同的環(huán)境中使用不同的日志配置。

示例

1. 將 logback.xml 文件名修改為 logback-spring.xml，并將配置文件中日志輸出格式的配置修改為使用 Profile 功能的配置。

2. 配置內(nèi)容修改前，日志輸出格式配置如下。 

<configuration scan="false" scanPeriod="60 seconds" debug="false">
    ......
    <appender name="stdout" class="ch.qos.logback.core.ConsoleAppender">
        <layout class="ch.qos.logback.classic.PatternLayout">
            <pattern>%d{yyyy-MM-dd HH:mm:ss} [%thread]**************** %-5level %logger{50} - %msg%n</pattern>
        </layout>
    </appender>
    ......
</configuration>

3. 修改 logback-spring.xml 的配置內(nèi)容，通過(guò) Profile 功能實(shí)現(xiàn)在不同的環(huán)境中使用不同的日志輸出格式，配置如下。

<configuration scan="false" scanPeriod="60 seconds" debug="false">
    ......
    <appender name="stdout" class="ch.qos.logback.core.ConsoleAppender">
       <layout class="ch.qos.logback.classic.PatternLayout">
            <!--開(kāi)發(fā)環(huán)境 日志輸出格式-->
            <springProfile name="dev">
                <pattern>%d{yyyy-MM-dd HH:mm:ss.SSS} ----> [%thread] ---> %-5level %logger{50} - %msg%n</pattern>
            </springProfile>
            <!--非開(kāi)發(fā)環(huán)境 日志輸出格式-->
            <springProfile name="!dev">
                <pattern>%d{yyyy-MM-dd HH:mm:ss.SSS} ==== [%thread] ==== %-5level %logger{50} - %msg%n</pattern>
            </springProfile>
        </layout>
    </appender>
    ......
</configuration>

4. 在 Spring Boot 項(xiàng)目的 application.yml 中，激活開(kāi)發(fā)環(huán)境（dev）的 Profile，配置內(nèi)容如下。

#默認(rèn)配置
server:
  port: 8080
#切換配置
spring:
  profiles:
    active: dev
---
#開(kāi)發(fā)環(huán)境
server:
  port: 8081
spring:
  config:
    activate:
      on-profile: dev
---
#測(cè)試環(huán)境
server:
  port: 8082
spring:
  config:
    activate:
      on-profile: test
---
#生產(chǎn)環(huán)境
server:
  port: 8083
spring:
  config:
    activate:
      on-profile: prod

5. 啟動(dòng) Spring Boot 并執(zhí)行測(cè)試代碼，控制臺(tái)輸出如下。

圖4：dev 環(huán)境日志輸出結(jié)果

 6. 修改 appplication.yml 中的配置，激活測(cè)試環(huán)境（test）的 Profile，配置如下。

#默認(rèn)配置
server:
  port: 8080
#切換配置
spring:
  profiles:
    active: test
---
#開(kāi)發(fā)環(huán)境
server:
  port: 8081
spring:
  config:
    activate:
      on-profile: dev
---
#測(cè)試環(huán)境
server:
  port: 8082
spring:
  config:
    activate:
      on-profile: test
---
#生產(chǎn)環(huán)境
server:
  port: 8083
spring:
  config:
    activate:
      on-profile: prod

7. 重啟 Spring Boot 并執(zhí)行測(cè)試代碼，控制臺(tái)輸出如下。

圖5：test 環(huán)境日志輸出結(jié)果 

到此，關(guān)于“SpringBoot日志的配置及輸出的方法是什么”的學(xué)習(xí)就結(jié)束了，希望能夠解決大家的疑惑。理論與實(shí)踐的搭配能更好的幫助大家學(xué)習(xí)，快去試試吧！若想繼續(xù)學(xué)習(xí)更多相關(guān)知識(shí)，請(qǐng)繼續(xù)關(guān)注億速云網(wǎng)站，小編會(huì)繼續(xù)努力為大家?guī)?lái)更多實(shí)用的文章！