一、Spring Boot Actuator簡介

什么是Spring Boot Actuator？Spring Boot Actuator 是 Spring Boot 提供的生產(chǎn)級監(jiān)控和管理模塊，旨在幫助開發(fā)者實時監(jiān)控應(yīng)用狀態(tài)、收集運行時指標(biāo)，并提供一系列管理端點（Endpoints），它的關(guān)鍵特性是提供了一系列的Web接口，通過它們能夠快速診斷問題、優(yōu)化性能，并確保應(yīng)用健康運行。

Actuator 的核心功能

• 1.1 應(yīng)用健康檢查
  /health 端點：檢查應(yīng)用關(guān)鍵組件（如數(shù)據(jù)庫、磁盤、消息隊列）是否正常。
• 1.2 性能指標(biāo)監(jiān)控
  /metrics 端點：提供 JVM 內(nèi)存、CPU 使用率、HTTP 請求統(tǒng)計等指標(biāo)。
• 1.3 動態(tài)日志調(diào)整
  /loggers 端點：運行時修改日志級別（如臨時開啟 DEBUG 日志排查問題）。
• 1.4 請求追蹤（HTTP Trace）
  /httptrace 端點（Spring Boot 2.x）：記錄最近請求的 URL、方法、響應(yīng)時間等。
• 1.5 線程與堆棧分析
  /threaddump 端點：導(dǎo)出當(dāng)前所有線程狀態(tài)，用于診斷死鎖或性能瓶頸。
  /heapdump 端點：生成 JVM 堆內(nèi)存快照。

二、開啟Http接口監(jiān)控

在一般的分布式架構(gòu)中，我們一般有查看API接口的請求/響應(yīng)的需求，而Spring Boot Actuator通過其httptrace端點即能夠返回基本的HTTP跟蹤信息，本文介紹該功能的使用

環(huán)境：SpringBoot 2.7.6

1.為SpringBoot項目添加依賴

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

2.添加yml配置

management:
    endpoint:
        health:
            show-details: always
    trace:
        http:
            enabled: true # 啟用HTTP追蹤
            include:
    endpoints:
        jmx:
            exposure:
                include: '*'
        web:
            exposure:
                include: '*'# 暴露端點，這里開啟所有默認Web端點
    server:
        port: 8081 # 這里訪問/actuator 端點的端口

此時，我們本地訪問/actuator端點的地址為：http://127.0.0.1/actuator，返回結(jié)果如下

我們可以看到返回了很多Actuator的端點接口路徑，但并沒有發(fā)現(xiàn)httptrace模塊，要開啟接口監(jiān)控功能我們還要注冊一個HttpTraceRepository類型的Bean

3.聲明存儲Bean

Spring Boot Actuator 默認會把最近100次的HTTP請求記錄到內(nèi)存中，對應(yīng)的實現(xiàn)類是InMemoryHttpTraceRepository

package com.example.springhttptrace.config;

import org.springframework.boot.actuate.trace.http.InMemoryHttpTraceRepository;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;

@Configuration
public class HttpActuatorConfig {
    @Bean
    InMemoryHttpTraceRepository inMemoryHttpTraceRepository() {
        return new InMemoryHttpTraceRepository() ;
    }
}

完成上面類配置，啟動項目并訪問：訪問http://localhost:8081/actuator，可以看到：

注意：Spirngboot2.x版本可以通過注入 InMemoryHttpTraceRepository來開啟httptrace，但Spirngboot3.x版本中是不能直接注入InMemoryHttpTraceRepository 開啟，需要使用httpExchanges開啟http trace，官方解釋生產(chǎn)環(huán)境可能存在一些性能問題，官方建議使用 zipKin或OpenTelemetry等開源框架

4.寫測試API接口

@Controller
public class BasicController {

    // http://127.0.0.1:8080/hello?name=lisi
    @RequestMapping("/hello")
    @ResponseBody
    public String hello(@RequestParam(name = "name", defaultValue = "unknown user") String name) {
        return "Hello " + name;
    }

    // http://127.0.0.1:8080/user
    @RequestMapping("/user")
    @ResponseBody
    public User user() {
        User user = new User();
        user.setName("theonefx");
        user.setAge(666);
        return user;
    }

    // http://127.0.0.1:8080/save_user?name=newName&age=11
    @RequestMapping("/save_user")
    @ResponseBody
    public String saveUser(User u) {
        return "user will save: name=" + u.getName() + ", age=" + u.getAge();
    }

    @ModelAttribute
    public void parseUser(@RequestParam(name = "name", defaultValue = "unknown user") String name
            , @RequestParam(name = "age", defaultValue = "12") Integer age, User user) {
        user.setName("zhangsan");
        user.setAge(18);
    }
}

訪問：http://127.0.0.1:8080/hello?name=lisi
返回結(jié)果后，再訪問：http://localhost:8081/actuator/httptrace，結(jié)果如下：

其中：

• timestamp，請求發(fā)生的時間戳（UTC 格式）
• principal，認證用戶信息（未認證時為 null）
• session，會話 ID（未啟用會話時為 null）
• request，請求對象信息
• response，響應(yīng)對象信息
• timeTaken，請求處理耗時（毫秒），未記錄時為 null 值為 150 表示處理耗時 150ms

總結(jié)

Spring Boot Actuator的HTTP Trace功能為監(jiān)控HTTP接口提供了便捷的解決方案，它開箱即用地記錄請求方法、URL、狀態(tài)碼和耗時等基礎(chǔ)信息，適合快速定位問題。然而，該功能默認不記錄請求體/響應(yīng)體等關(guān)鍵數(shù)據(jù)，內(nèi)存存儲僅保留100條記錄，且高頻請求下可能產(chǎn)生性能開銷，生產(chǎn)環(huán)境建議優(yōu)先考慮更專業(yè)的APM工具。

以上就是SpringBoot Actuator跟蹤HTTP請求和響應(yīng)的方法的詳細內(nèi)容，更多關(guān)于SpringBoot Actuator跟蹤HTTP的資料請關(guān)注腳本之家其它相關(guān)文章！

最新評論