前言

為了減少日志頻繁打印帶來的性能影響，線上環(huán)境設(shè)置的日志級別一般都相對較高。而當(dāng)出現(xiàn)生產(chǎn)問題需要排查的時候，可能需要適當(dāng)降低日志級別(例如DEBUG)來打印更多的日志信息幫助定位問題。

傳統(tǒng)的做法一般是：

1、配置里修改日志級別

2、重啟應(yīng)用

3、問題復(fù)現(xiàn)查看報錯日志排查問題

這個過程需要重啟應(yīng)用，比較麻煩，效率較低，而且針對大型在線項目，不可能隨便停機重啟。那么有沒有一種方式在不重啟應(yīng)用的情況下實現(xiàn)動態(tài)修改日志級別呢？

下面，讓老萬教你如何通過SpringBoot的actuator組件來實現(xiàn)動態(tài)修改日志級別。

一、添加依賴

<dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-actuator</artifactId>
</dependency>

二、配置actuator暴露的端口

#啟用actuator端口
management.endpoints.enabled-by-default=fasle
#設(shè)置actuator的訪問根路徑，默認(rèn)是/actuator
management.endpoints.web.base-path=/message
#啟用的端點
management.endpoints.web.exposure.include=loggers

這里我修改了actuator的默認(rèn)訪問路徑/actuator，改為/message，為的是和項目的基礎(chǔ)訪問路徑保存一致。

啟用端口的2中配置方法：

方式一：（推薦）

management.endpoints.web.exposure.include=loggers

方式二：(這種方式測試沒有生效)

management.endpoint.loggers.enabled=true

補充：如何禁用info端口

management.endpoints.enabled-by-default=false
management.endpoint.info.enabled=true

關(guān)于actuator組件被稱為spring boot的4大組件之一，功能強大，大家在網(wǎng)上自己找些資料進一步了解。

actuator的endpoint端口說明：

如果使用web應(yīng)用(Spring MVC, Spring WebFlux, 或者 Jersey)，你還可以使用以下端點：

要更改公開哪些端點，請使用以下技術(shù)特定的include和exclude屬性：

include屬性列出了公開的端點的ID,

exclude屬性列出了不應(yīng)該公開的端點的ID

exclude屬性優(yōu)先于include屬性。包含和排除屬性都可以使用端點ID列表進行配置。

*可以用來選擇所有端點。

例如，要通過HTTP公開除env和beans端點之外的所有內(nèi)容，請使用以下屬性：

management.endpoints.web.exposure.include=*
management.endpoints.web.exposure.exclude=env,beans

三、關(guān)閉鑒權(quán)

一般我們會將actuator和spring security鑒權(quán)組件結(jié)合使用，防止這些功能端口被隨便調(diào)用。由于這里是功能演示，先放開actuator相關(guān)端口的權(quán)限認(rèn)證。

此外，如果存在Spring Security，則需要添加自定義安全配置，以允許對端點進行未經(jīng)身份驗證的訪問，如以下示例所示：放開所有Endpoint端點進行匹配

@Configuration
public class ActuatorSecurity extends WebSecurityConfigurerAdapter {
 
@Override
protected void configure(HttpSecurity http) throws Exception {
    http.requestMatcher(EndpointRequest.toAnyEndpoint()).authorizeRequests()
    .anyRequest().permitAll()
}

}

四 、通過/loggers端口查看日志級別

請求鏈接：http://localhost:8090/message/loggers

注意上面我說過的，我調(diào)整了management.endpoints.web.base-path=/message。如果沒有設(shè)置此參數(shù)，則使用默認(rèn)的/actuator去訪問。

五、發(fā)起http請求修改日志級別

這里演示，修改目錄com.wxswj.provider.message.controller的日志級別為debug

請求類型為POST，參數(shù)格式是JSON

curl -H "Content-Type: application/json" -X POST --data 
'
{
    "configuredLevel": "DEBUG"
}
' 
http://localhost:8090/message/loggers/com.wxswj.provider.message.controller

大家可以在服務(wù)器上通過curl發(fā)起http請求，或者通過Postman發(fā)起請求。

curl -H "Content-Type: application/json" -X POST --data '{"configuredLevel": "DEBUG"}' http://localhost:8090/loggers/com.wxswj.provider.message.controller

六、查詢?nèi)罩炯墑e修改結(jié)果

http://localhost:8090/message/loggers/com.wxswj.provider.message.controller

{
"configuredLevel": "DEBUG",
"effectiveLevel": "DEBUG"
}

說明我們的修改日志級別的請求生效。

總結(jié)

通過整合spring boot的actuator組件，公開對應(yīng)的/loggers端口，我們就可以輕松的實現(xiàn)動態(tài)調(diào)整系統(tǒng)的日志級別，而不用項目重啟。

以上為個人經(jīng)驗，希望能給大家一個參考，也希望大家多多支持腳本之家。

最新評論