Springboot日志配置的實現(xiàn)示例
前言
Spring Boot 底層默認(rèn)使用 slf4j 和 logback 的方式記錄日志。工程中依賴了 spring-boot-starter-web，它又依賴了 spring-boot-starter-logging，所以不需要再手動添加該依賴。在 Spring Boot 中，application.yml 支持部分 logback 的日志配置，但一些高級配置只能通過獨立的 xml 配置文件實現(xiàn)，經(jīng)過 Spring Boot 的整合后，可支持多環(huán)境配置，但 logback 配置文件需要命名為 logback-spring.xml。如果使用了自定義日志配置文件，application.yml中 logging 有關(guān)配置就會失效。
springboot 默認(rèn)的 logback 配置
SpringBoot 默認(rèn)提供了一套 logback 的配置文件，位于 spring-boot依賴中的 org/springframework/boot/logging/logback/base.xml。
<included>
<include resource="org/springframework/boot/logging/logback/defaults.xml" />
<property name="LOG_FILE" value="${LOG_FILE:-${LOG_PATH:-${LOG_TEMP:-${java.io.tmpdir:-/tmp}}}/spring.log}"/>
<include resource="org/springframework/boot/logging/logback/console-appender.xml" />
<include resource="org/springframework/boot/logging/logback/file-appender.xml" />
<root level="INFO">
<appender-ref ref="CONSOLE" />
<appender-ref ref="FILE" />
</root>
</included>該文件引入了三個 xml 文件，并設(shè)置了root的日志級別為 info。console-appender.xml 和 file-appender.xml 中定義了日志的追加器，分別是名為 CONSOLE 的控制臺追加器 和 名為 FILE 的文件追加器。org/springframework/boot/logging/logback/defaults.xml 定義了 logback 的轉(zhuǎn)換器、一些包的日志級別、日志顯示格式。
<included>
<conversionRule conversionWord="clr" converterClass="org.springframework.boot.logging.logback.ColorConverter" />
<conversionRule conversionWord="wex" converterClass="org.springframework.boot.logging.logback.WhitespaceThrowableProxyConverter" />
<conversionRule conversionWord="wEx" converterClass="org.springframework.boot.logging.logback.ExtendedWhitespaceThrowableProxyConverter" />
<property name="CONSOLE_LOG_PATTERN" value="${CONSOLE_LOG_PATTERN:-%clr(%d{yyyy-MM-dd HH:mm:ss.SSS}){faint} %clr(${LOG_LEVEL_PATTERN:-%5p}) %clr(${PID:- }){magenta} %clr(---){faint} %clr([%15.15t]){faint} %clr(%-40.40logger{39}){cyan} %clr(:){faint} %m%n${LOG_EXCEPTION_CONVERSION_WORD:-%wEx}}"/>
<property name="FILE_LOG_PATTERN" value="${FILE_LOG_PATTERN:-%d{yyyy-MM-dd HH:mm:ss.SSS} ${LOG_LEVEL_PATTERN:-%5p} ${PID:- } --- [%t] %-40.40logger{39} : %m%n${LOG_EXCEPTION_CONVERSION_WORD:-%wEx}}"/>
<appender name="DEBUG_LEVEL_REMAPPER" class="org.springframework.boot.logging.logback.LevelRemappingAppender">
<destinationLogger>org.springframework.boot</destinationLogger>
</appender>
<logger name="org.apache.catalina.startup.DigesterFactory" level="ERROR"/>
<logger name="org.apache.catalina.util.LifecycleBase" level="ERROR"/>
<logger name="org.apache.coyote.http11.Http11NioProtocol" level="WARN"/>
<logger name="org.apache.sshd.common.util.SecurityUtils" level="WARN"/>
<logger name="org.apache.tomcat.util.net.NioSelectorPool" level="WARN"/>
<logger name="org.crsh.plugin" level="WARN"/>
<logger name="org.crsh.ssh" level="WARN"/>
<logger name="org.eclipse.jetty.util.component.AbstractLifeCycle" level="ERROR"/>
<logger name="org.hibernate.validator.internal.util.Version" level="WARN"/>
<logger name="org.springframework.boot.actuate.autoconfigure.CrshAutoConfiguration" level="WARN"/>
<logger name="org.springframework.boot.actuate.endpoint.jmx" additivity="false">
<appender-ref ref="DEBUG_LEVEL_REMAPPER"/>
</logger>
<logger name="org.thymeleaf" additivity="false">
<appender-ref ref="DEBUG_LEVEL_REMAPPER"/>
</logger>
</included>默認(rèn)在控制臺中顯示彩色日志，就是因為使用了轉(zhuǎn)換器 ColorConverter，顯示的格式為 CONSOLE_LOG_PATTERN 中使用了該轉(zhuǎn)換器。在我們的自定義配置中可以復(fù)用這個 default.xml 和 console-appender.xml。
自定義配置
在 src/main/resources/下創(chuàng)建配置文件 logback-spring.xml。
<?xml version="1.0" encoding="UTF-8"?>
<configuration>
<include resource="org/springframework/boot/logging/logback/defaults.xml" />
<include resource="org/springframework/boot/logging/logback/console-appender.xml" />
<root level="INFO">
<appender-ref ref="CONSOLE" />
</root>
</configuration>上面的配置引入了 spring boot 中 logback 的默認(rèn)配置和 CONSOLE 追加器，并定義了 root 的日志級別為 info。
日志級別
日志有五個級別：trace、debug、info、warn、error，級別依次較高，配置了某個級別，就會輸出該級別及其以上的級別。如，配置日志級別為 warn，則日志會輸出 warn、error；如果配置日志級別為 debug，則會輸出 debug、info、warn、error。
@RequestMapping(value = "/testLogLevel", method = RequestMethod.GET)
public String testLogLevel() {
LOGGER.trace("hello,愛琴孩!");
LOGGER.debug("hello,愛琴孩!");
LOGGER.info("hello,愛琴孩!");
LOGGER.warn("hello,愛琴孩!");
LOGGER.error("hello,愛琴孩!");
return "Success";
}注意，引入的 Logger 和 LoggerFactory 兩個類都是 slf4j 包下面的。上面的代碼分別輸出五個級別的日志。啟動服務(wù)，訪問 testLogLevel接口，控制臺輸出:
控制臺值輸出 info、warn、error，可以看出 SpringBoot 默認(rèn)輸出級別為 info?？赏ㄟ^配置細(xì)粒度調(diào)整日志的級別：
<?xml version="1.0" encoding="UTF-8"?>
<configuration>
...
<logger name="com.example.study.controller" level="trace" additivity="false">
<appender-ref ref="CONSOLE"/>
</logger>
...
</configuration>上面按照包名更改了日志的顯示級別，com.example.study.controller 包下面的日志都是 trace 級別。上面配置選項"additivity"，用于控制日志消息在日志層級之間的傳播方式。在Logback中，每個日志記錄器（logger）都有一個與之關(guān)聯(lián)的層級（level）。當(dāng)日志消息到達(dá)一個日志記錄器時，Logback會將其傳播到所有具有相同或更高層級的日志記錄器。默認(rèn)情況下，Logback將日志消息傳播到所有父級日志記錄器。"additivity"的值可以是true或false。當(dāng)"additivity"設(shè)置為true時，日志消息將被傳播到所有父級日志記錄器；當(dāng)"additivity"設(shè)置為false時，日志消息將僅停留在當(dāng)前日志記錄器中，不會傳播到父級日志記錄器。通過配置"additivity"，可以更細(xì)粒度地控制日志消息在應(yīng)用程序中的流動，避免在特定的日志記錄器中重復(fù)記錄日志消息，也可以提高日志記錄的性能。
重新訪問 testLogLevel接口，error、warn、info、debug、trace 都會全部打印出來。
文件追加器
上面復(fù)用了 SpringBoot 自帶的控制臺追加器 CONSOLE，這里自定義文件追加器：
<appender name="ServiceLogRollingFileAppender"
class="ch.qos.logback.core.rolling.RollingFileAppender">
<file>${LOG_FILE}</file>
<encoder>
<pattern>${FILE_LOG_PATTERN}</pattern>
</encoder>
<rollingPolicy class="ch.qos.logback.core.rolling.TimeBasedRollingPolicy">
<fileNamePattern>${LOG_FILE}.%d{yyyy-MM-dd}.log
</fileNamePattern>
</rollingPolicy>
</appender>并在 root 中添加這個自定義 ServiceLogRollingFileAppender追加器:
<root level="INFO">
<appender-ref ref="CONSOLE" />
<appender-ref ref="ServiceLogRollingFileAppender" />
</root>多環(huán)境日志
假設(shè)希望在 local 時，只輸出控制臺日志；在其他環(huán)境（dev、test等）輸出控制臺日志和文件日志。SpringBoot 提供了 springProfile 標(biāo)簽，通過該元素 name 屬性指定環(huán)境。修改 root 元素：
<root level="INFO">
<springProfile name="local">
<appender-ref ref="CONSOLE" />
</springProfile>
<springProfile name="!local">
<appender-ref ref="CONSOLE" />
<appender-ref ref="ServiceLogRollingFileAppender" />
</springProfile>
</root>分別使用 local 和 dev 啟動服務(wù)，測試多環(huán)境是否生效。我們自定義的 logback-spring.xml 充分利用了 Spring Boot 官方提供的配置，最終完整配置如下：
<?xml version="1.0" encoding="UTF-8"?>
<configuration>
<include resource="org/springframework/boot/logging/logback/defaults.xml" />
<springProperty scop="context" name="LOG_SERVICE_NAME" source="logging.service.name" />
<property name="CONSOLE_LOG_PATTERN"
value="%clr(%d{yyyy-MM-dd HH:mm:ss.SSS}){faint} %clr(${LOG_SERVICE_NAME}){faint} %clr(${PID:- }){magenta} %clr([%15.15t]){faint} %clr(${LOG_LEVEL_PATTERN:-%5p}) %clr(%-40.40class{39} %5.5L){cyan}%clr(:){faint} %m%n${LOG_EXCEPTION_CONVERSION_WORD:-%wEx}" />
<property name="FILE_LOG_PATTERN"
value="%d{yyyy-MM-dd HH:mm:ss.SSS} ${LOG_SERVICE_NAME:-%5p} ${PID:- } [%t] ${LOG_LEVEL_PATTERN:-%5p} %-40.40class{39} %5.5L: %m%n${LOG_EXCEPTION_CONVERSION_WORD:-%wEx}" />
<property name="LOG_FILE"
value="${LOG_FILE:-${LOG_PATH:-${LOG_TEMP:-${java.io.tmpdir:-/tmp}}/}spring.log}" />
<include
resource="org/springframework/boot/logging/logback/console-appender.xml" />
<appender name="ServiceLogRollingFileAppender"
class="ch.qos.logback.core.rolling.RollingFileAppender">
<file>${LOG_FILE}</file>
<encoder>
<pattern>${FILE_LOG_PATTERN}</pattern>
</encoder>
<rollingPolicy class="ch.qos.logback.core.rolling.TimeBasedRollingPolicy">
<fileNamePattern>${LOG_FILE}.%d{yyyy-MM-dd}.log
</fileNamePattern>
</rollingPolicy>
</appender>
<root level="INFO">
<springProfile name="local">
<appender-ref ref="CONSOLE" />
</springProfile>
<springProfile name="!local">
<appender-ref ref="CONSOLE" />
<appender-ref ref="ServiceLogRollingFileAppender" />
</springProfile>
</root>
<logger name="com.example.study.controller" level="trace" additivity="false">
<appender-ref ref="CONSOLE"/>
</logger>
</configuration>到此這篇關(guān)于Springboot日志配置的實現(xiàn)示例的文章就介紹到這了,更多相關(guān)Springboot日志配置內(nèi)容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家！
相關(guān)文章
Java是一種廣泛使用的編程語言,具有跨平臺性和面向?qū)ο蟮奶匦?下面這篇文章主要給大家介紹了關(guān)于使用Java原生指令編譯并運行一個程序的相關(guān)資料,需要的朋友可以參考下2024-07-07
與二分搜索一樣,跳轉(zhuǎn)搜索是一種針對排序數(shù)組的搜索算法,本文主要介紹了java 跳轉(zhuǎn)搜索的實現(xiàn)示例,文中通過示例代碼介紹的非常詳細(xì),需要的朋友們下面隨著小編來一起學(xué)習(xí)學(xué)習(xí)吧2024-04-04
快速解決springboot在yml配置了啟動端口但啟動還是8080問題
這篇文章主要介紹了快速解決springboot在yml配置了啟動端口但啟動還是8080問題,具有很好的參考價值,希望對大家有所幫助,如有錯誤或未考慮完全的地方,望不吝賜教2025-03-03
這篇文章主要介紹了Spring @Profile注解詳解，文中通過示例代碼介紹的非常詳細(xì)，對大家的學(xué)習(xí)或者工作具有一定的參考學(xué)習(xí)價值，需要的朋友們下面隨著小編來一起學(xué)習(xí)學(xué)習(xí)吧2019-08-08
一般來講SpringBoot項目是不需要指定版本，而SSM項目是需要指定版本，SpringBoot的核心依賴就是spring-boot-starter-parent和spring-boot-starter-web兩個依賴，關(guān)于這兩個依賴的相關(guān)介紹具體今天小編給大家介紹下2022-06-06
Spring?Boot?配置文件之類型、加載順序與最佳實踐記錄
Spring?Boot?的配置文件是靈活且強(qiáng)大的工具,通過合理的配置管理,可以讓應(yīng)用開發(fā)和部署更加高效,無論是簡單的屬性配置,還是復(fù)雜的多環(huán)境管理,Spring?Boot都提供了便捷的解決方案,本文介紹Spring?Boot?配置文件：類型、加載順序與最佳實踐,感興趣的朋友一起看看吧2025-04-04
這篇文章主要為大家詳細(xì)介紹了java多線程模擬實現(xiàn)售票功能，文中示例代碼介紹的非常詳細(xì)，具有一定的參考價值，感興趣的小伙伴們可以參考一下2021-08-08
這篇文章主要介紹了Java創(chuàng)建打包命令、創(chuàng)建啟動文件等功能實現(xiàn)Java一鍵部署 jar 包和 war 包，感興趣的下伙伴可以參考下文2021-09-09
Spring Security 構(gòu)建rest服務(wù)實現(xiàn)rememberme 記住我功能
這篇文章主要介紹了Spring Security 構(gòu)建rest服務(wù)實現(xiàn)rememberme 記住我功能,需要的朋友可以參考下2018-03-03
在項目開發(fā)過程中，過濾器或者攔截器幾乎是必用的，他可以很方便的完成類似日志處理、token驗證等一系列操作，區(qū)別于業(yè)務(wù)接口，獨立進(jìn)行處理，感覺就是一種Aop思想。下面模擬請求接口前的token驗證，進(jìn)行過濾器的實戰(zhàn)2022-04-04