官方文檔：Spring Boot Actuator: Production-ready Features

一、引入依賴

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

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

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

三、具體使用

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

• localhost:8080/actuator/

2. 根據(jù)1中查出來的結果，可以監(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)控哪些指標信息，即系統(tǒng)運行時指標】

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

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

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

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

• localhost:8080/actuator/health

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

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

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

五、端點開啟與禁用

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

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

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

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

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

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

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

六、定制Endpoint

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

1. 定制 /actuator/health

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

2. 定制 /actuator/info

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

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

如下圖：

info:
  appName: boot-admin
  appVersion: 1.0.0

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

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

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

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

第二種方式可以獲取項目的一些基本信息，并且不是寫死的，而是從pom文件中自動獲取的，但是某些信息只能通過發(fā)送請求時，在代碼里面進行邏輯處理完成之后才能獲取，所以就引入了第三種方式，即通過代碼實現(xiàn)獲取一些項目相關的信息，代碼實現(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"));
    }
}

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

3. 定制metrics

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

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

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

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

七. 新增自己的監(jiān)控端點

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

Spring Boot Actuator: Production-ready Features

如果我們自己想新增一些監(jiān)控端點，該怎么做呢？

代碼如下：

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

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

新增自己的監(jiān)控端點后，通過jconsole里面也可以看到新增的監(jiān)控端點，如下圖：

總結

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

最新評論