快捷導(dǎo)航

SpringBoot的監(jiān)控(Actuator)功能用法詳解

更新時間：2025年03月24日 10:40:55 作者：太自由

這篇文章主要介紹了SpringBoot的監(jiān)控(Actuator)功能用法,具有很好的參考價(jià)值,希望對大家有所幫助,如有錯誤或未考慮完全的地方,望不吝賜教

一、引入依賴

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

二、application.yml文件中開啟監(jiān)控

management:
  endpoints:
    enabled-by-default: true #暴露所有端點(diǎn)信息
    web:
      exposure:
        include: "*"  #以web方式暴露

三、具體使用

1. 查看可以監(jiān)控哪些信息：

localhost:8080/actuator/

2. 根據(jù)1中查出來的結(jié)果，可以監(jiān)控具體的信息，比如：

http://localhost:8080/actuator/health 【查看系統(tǒng)健康狀態(tài)】
localhost:8080/actuator/beans 【查看系統(tǒng)中所有的bean組件】
localhost:8080/actuator/conditions 【查看系統(tǒng)中激活的組件，如下圖】

localhost:8080/actuator/configprops 【查看系統(tǒng)中配置的屬性，如下圖】

localhost:8080/actuator/env 【查看系統(tǒng)環(huán)境變量】

localhost:8080/actuator/metrics/ 【查看系統(tǒng)可以監(jiān)控哪些指標(biāo)信息，即系統(tǒng)運(yùn)行時指標(biāo)】

根據(jù)上面查出來的指標(biāo)，再具體查看每個指標(biāo)的詳細(xì)信息，比如如下圖查看系統(tǒng)CPU利用率指標(biāo)

localhost:8080/actuator/metrics/system.cpu.usage

四、具體細(xì)節(jié)使用

比如我現(xiàn)在直接想查看系統(tǒng)是否健康，可以直接發(fā)送

localhost:8080/actuator/health

這個請求，如下圖是默認(rèn)返回的信息，只顯示一個匯總后的結(jié)果告訴我們當(dāng)前服務(wù)是什么狀態(tài)

但是我想的服務(wù)配置了很多東西，比如數(shù)據(jù)庫，redis, mq等組件，我想知道它們每一個的健康狀態(tài)，可以在配置文件中針對每個監(jiān)控端點(diǎn)進(jìn)行更詳細(xì)的配置，如下：

如上配置好了以后，重新啟動項(xiàng)目，再次查看 /actuator/health 端點(diǎn)，返回如下信息：

五、端點(diǎn)開啟與禁用

1. 直接使用如下方式是默認(rèn)開啟所有監(jiān)控端點(diǎn)，但是某些包含敏感信息的端點(diǎn)我們不想開啟，而只想開啟某些監(jiān)控端點(diǎn)，該怎么辦呢？

management:
  endpoints:
    enabled-by-default: true #暴露所有端點(diǎn)信息
    web:
      exposure:
        include: "*"  #以web方式暴露

把上面的配置改成如下方式，即單獨(dú)針對每一個監(jiān)控端點(diǎn)的開啟與禁用進(jìn)行控制

management:
  endpoints:
    enabled-by-default: false#關(guān)閉所有端點(diǎn)監(jiān)控功能
    web:
      exposure:
        include: "*"  #以web方式暴露
  endpoint:
    health:
      show-details: always
      enabled: true
      
    info:
      enabled: true
    
    metrics:
      enabled: true

重啟項(xiàng)目，再次查看監(jiān)控端點(diǎn)信息，如下(只能看到我們想讓你看到的監(jiān)控信息)：

同樣的，在jconsole里面，也是只能看到這些信息，如下圖：

在DOS命令行輸入 jconsole就可以直接打開jconsole控制臺

六、定制Endpoint

說明：這里的定制端點(diǎn)是在SpringBoot已有的端點(diǎn)中，添加我們自己定制的一些信息，并沒有新增監(jiān)控端點(diǎn)（新增監(jiān)控端點(diǎn)，看第7節(jié)）

1. 定制 /actuator/health

比如在訪問 http://localhost:8080/actuator/health 時，默認(rèn)顯示系統(tǒng)判斷的那些組件的健康狀態(tài)，如果我們自己想添加一個端點(diǎn)(組件)的健康狀態(tài)，按照如下做法：

2. 定制 /actuator/info

直接使用 http://localhost:8080/actuator/info時，輸入的信息為空，那么我們?nèi)绻朐陧撁嬲故疽恍╉?xiàng)目的基本信息，比如項(xiàng)目名稱，項(xiàng)目的版本等信息該如何做呢，有如下三種辦法：

（1）直接在配置文件中寫死

如下圖：

info:
  appName: boot-admin
  appVersion: 1.0.0

（2）從pom文件中讀取信息

采用（1）中的方法的缺點(diǎn)是我不想把項(xiàng)目的名稱或者版本號寫死，我想動態(tài)獲?。ū热鐝膍aven中動態(tài)獲取當(dāng)前項(xiàng)目的項(xiàng)目名稱和版本，因?yàn)轫?xiàng)目名稱或者版本可能會變動）。那么此時頁可以直接在配置文件（application.yml）中動態(tài)獲取maven配置文件（pom.xml）中的一些基本信息，如下：

重啟項(xiàng)目，訪問 http://localhost:8080/actuator/info，結(jié)果如下圖：

（3）代碼實(shí)現(xiàn)

第二種方式可以獲取項(xiàng)目的一些基本信息，并且不是寫死的，而是從pom文件中自動獲取的，但是某些信息只能通過發(fā)送請求時，在代碼里面進(jìn)行邏輯處理完成之后才能獲取，所以就引入了第三種方式，即通過代碼實(shí)現(xiàn)獲取一些項(xiàng)目相關(guān)的信息，代碼實(shí)現(xiàn)如下：

package com.shg.admin.acutuator.info;

import org.springframework.boot.actuate.info.Info;
import org.springframework.boot.actuate.info.InfoContributor;
import org.springframework.stereotype.Component;

import java.util.Collections;

@Component
public class AppInfoInfoContributor implements InfoContributor {


    @Override
    public void contribute(Info.Builder builder) {

        builder.withDetail("msg","你好")
                .withDetail("hello","shg")
                .withDetails(Collections.singletonMap("world","666"));
    }
}

重啟項(xiàng)目，訪問 http://localhost:8080/actuator/info，結(jié)果如下圖：