目錄

0、官方文檔

一、引入依賴

二、application.yml文件中開啟監控

三、具體使用

四、具體細節使用

五、端點開啟與禁用

?六、定制Endpoint

1. 定制?/actuator/health?

?2. 定制 /actuator/info

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

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

?（3）代碼實現

3. 定制metrics

七. 新增自己的監控端點?

---

0、官方文檔

Spring Boot Actuator: Production-ready Features

一、引入依賴

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

二、application.yml文件中開啟監控

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

三、具體使用

1. 查看可以監控哪些信息：

localhost:8080/actuator/

2. 根據1中查出來的結果，可以監控具體的信息，比如：?

http://localhost:8080/actuator/health?【查看系統健康狀態】

localhost:8080/actuator/beans?【查看系統中所有的bean組件】

localhost:8080/actuator/conditions?【查看系統中激活的組件，如下圖】

localhost:8080/actuator/configprops?【查看系統中配置的屬性，如下圖】

localhost:8080/actuator/env?【查看系統環境變量】

localhost:8080/actuator/metrics/? 【查看系統可以監控哪些指標信息，即系統運行時指標】

根據上面查出來的指標，再具體查看每個指標的詳細信息，比如如下圖查看系統CPU利用率指標

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

四、具體細節使用

比如我現在直接想查看系統是否健康，可以直接發送

?localhost:8080/actuator/health

這個請求，如下圖是默認返回的信息，只顯示一個匯總后的結果告訴我們當前服務是什么狀態

?但是我想的服務配置了很多東西，比如數據庫，redis, mq等組件，我想知道它們每一個的健康狀態，可以在配置文件中針對每個監控端點進行更詳細的配置，如下：

如上配置好了以后，重新啟動項目，再次查看 /actuator/health 端點，返回如下信息：

?

五、端點開啟與禁用

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

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

把上面的配置改成如下方式，即單獨針對每一個監控端點的開啟與禁用進行控制

management:endpoints:enabled-by-default: false#關閉所有端點監控功能web:exposure:include: "*"  #以web方式暴露endpoint:health:show-details: alwaysenabled: trueinfo:enabled: truemetrics:enabled: true

重啟項目，再次查看監控端點信息，如下(只能看到我們想讓你看到的監控信息)：

?

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

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

?六、定制Endpoint

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

1. 定制?/actuator/health?

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

?2. 定制 /actuator/info

直接使用?http://localhost:8080/actuator/info時，輸入的信息為空，那么我們如果想在頁面展示一些項目的基本信息，比如項目名稱，項目的版本等信息該如何做呢，有如下三種辦法：

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

? ? ? ? 如下圖：

info:appName: boot-adminappVersion: 1.0.0

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

????????采用（1）中的方法的缺點是我不想把項目的名稱或者版本號寫死，我想動態獲取（比如從maven中動態獲取當前項目的項目名稱和版本，因為項目名稱或者版本可能會變動）。那么此時頁可以直接在配置文件（application.yml）中動態獲取maven配置文件（pom.xml）中的一些基本信息，如下：

重啟項目，訪問?http://localhost:8080/actuator/info，結果如下圖：

?（3）代碼實現

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

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 {@Overridepublic void contribute(Info.Builder builder) {builder.withDetail("msg","你好").withDetail("hello","shg").withDetails(Collections.singletonMap("world","666"));}
}

重啟項目，訪問?http://localhost:8080/actuator/info，結果如下圖：

3. 定制metrics

? ? ? ? SpringBoot默認給我們的定制信息如下圖：

?上述這些默認的指標信息不一定能滿足我們的需求，比如我就想單獨監控某個 Controller對應的URL被請求的次數，此時就需要自定義一個mertics，添加到現有的metrics中：

需求：比如我想統計 CityService類里面的 selectListCity這個方法被調用多少次。代碼如下：

?

請求Controller的?????localhost:8080/city/list 方法后，查詢具體的指標如下，可以看到? CityService類里面的 selectListCity這個方法已經被調用了6次。

七. 新增自己的監控端點?

SpringBoot給我們提供的監控端點就是在其官方文檔里面的那些：

Spring Boot Actuator: Production-ready Features

如果我們自己想新增一些監控端點，該怎么做呢？代碼如下：

重啟項目，直接訪問：localhost:8080/actuator/?結果如下：

?訪問我們自定的端點，結果如下：

新增自己的監控端點后，通過jconsole里面也可以看到新增的監控端點，如下圖;