快捷導(dǎo)航

SpringBoot通過(guò)注解監(jiān)測(cè)Controller接口的代碼示例

更新時(shí)間：2024年07月29日 10:39:00 作者：奮斗的狍子007

在Spring Boot中,度量指標(biāo)（Metrics）是監(jiān)控和診斷應(yīng)用性能與行為的重要工具,Spring Boot通過(guò)集成Micrometer和Spring Boot Actuator,提供了強(qiáng)大的度量指標(biāo)收集與暴露功能,本文介紹了SpringBoot通過(guò)注解監(jiān)測(cè)Controller接口,需要的朋友可以參考下

一、前言

在Spring Boot中，度量指標(biāo)（Metrics）是監(jiān)控和診斷應(yīng)用性能與行為的重要工具。Spring Boot通過(guò)集成Micrometer和Spring Boot Actuator，提供了強(qiáng)大的度量指標(biāo)收集與暴露功能。

二、度量指標(biāo)

1. Micrometer

Micrometer是一個(gè)應(yīng)用監(jiān)控門面（Facade），它提供了對(duì)多種監(jiān)控系統(tǒng)的支持，使得開發(fā)者可以在不修改代碼的情況下切換監(jiān)控后端，如Prometheus、Graphite、InfluxDB等。

Micrometer的核心功能

豐富的指標(biāo)收集：

系統(tǒng)指標(biāo)：如CPU使用率、內(nèi)存占用、磁盤I/O、網(wǎng)絡(luò)I/O等，這些基礎(chǔ)資源的使用情況對(duì)于理解系統(tǒng)性能至關(guān)重要。

應(yīng)用指標(biāo)：包括請(qǐng)求響應(yīng)時(shí)間、吞吐量、錯(cuò)誤率等，這些指標(biāo)直接反映了應(yīng)用的行為和性能。

自定義指標(biāo)：開發(fā)者可以根據(jù)需要?jiǎng)?chuàng)建自定義指標(biāo)，以監(jiān)控特定的業(yè)務(wù)流程或組件。

請(qǐng)求跟蹤：

雖然Micrometer本身主要關(guān)注于指標(biāo)收集，但它可以與Spring Cloud Sleuth等跟蹤系統(tǒng)結(jié)合使用，實(shí)現(xiàn)請(qǐng)求的分布式跟蹤。Sleuth通過(guò)添加跟蹤信息（如Trace ID、Span ID）到日志和指標(biāo)中，幫助開發(fā)者追蹤請(qǐng)求在整個(gè)微服務(wù)架構(gòu)中的路徑，從而更容易地診斷問(wèn)題。

集成日志記錄：

雖然Micrometer不直接處理日志記錄，但將Micrometer的監(jiān)控?cái)?shù)據(jù)與日志系統(tǒng)集成，可以形成更全面的可觀測(cè)性體系。例如，可以將Micrometer收集的指標(biāo)與日志文件中的Trace ID關(guān)聯(lián)起來(lái)，從而更容易地將性能問(wèn)題與具體的請(qǐng)求或事務(wù)聯(lián)系起來(lái)。

2. Spring Boot Actuator

Spring Boot Actuator是Spring Boot的一個(gè)子項(xiàng)目，它提供了對(duì)應(yīng)用系統(tǒng)的自省和監(jiān)控的集成功能。通過(guò)引入Spring Boot Actuator，應(yīng)用可以暴露多個(gè)端點(diǎn)（Endpoints），這些端點(diǎn)提供了對(duì)應(yīng)用內(nèi)部信息的訪問(wèn)，包括度量指標(biāo)、健康檢查、環(huán)境變量等。

三、使用@Timed, @Counted注解來(lái)完成接口的監(jiān)測(cè)功能

@Timed注解

該注解會(huì)統(tǒng)計(jì)方法調(diào)用的執(zhí)行耗時(shí)情況，包括什么類，哪個(gè)方法等信息。

@Counted注解

統(tǒng)計(jì)方法調(diào)用成功與失敗情況。

四、代碼示例

1. 引入依賴

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

<dependency>
	<groupId>io.micrometer</groupId>
	<artifactId>micrometer-registry-prometheus</artifactId>
</dependency>

2. 開啟配置

management.endpoints.web.base-path=/v/ac
management.endpoints.web.exposure.include=*

3. 測(cè)試代碼

@Timed(value = "test_actuator", description = "test_actuator", histogram = true)
@RequestMapping("/test/actuator")
public void testActuator(String name){
	// 相關(guān)業(yè)務(wù)
	System.out.println("success: " + name);
}