基于SpringBoot Actuator與Prometheus自定義指標監(jiān)控與性能優(yōu)化實戰(zhàn)指南

更新時間：2025年08月06日 08:50:02 作者：淺沫云歸

為了精細化監(jiān)控業(yè)務指標,需要在Spring Boot應用中自定義指標,并推送到Prometheus進行存儲和告警,下面我們來看看如何基于Actuator與Prometheus自定義指標監(jiān)控并進行優(yōu)化

業(yè)務場景描述

在電商平臺的訂單服務中，隨著流量不斷攀升，系統(tǒng)性能瓶頸逐漸暴露，常見問題包括接口響應時長波動大、服務并發(fā)壓測不達預期以及關鍵業(yè)務調(diào)用鏈路缺少可觀測性。為了精細化監(jiān)控業(yè)務指標，如訂單處理時長、并發(fā)提交量、下單失敗率等，需要在Spring Boot應用中自定義指標，并推送到Prometheus進行存儲和告警。

技術選型過程

Spring Boot Actuator：提供了一套可擴展的監(jiān)控指標接口，內(nèi)置常見JVM、HTTP等指標。
Micrometer：Actuator底層度量庫，支持多種監(jiān)控后端。
Prometheus：流行的時序數(shù)據(jù)庫，易于抓取指標、支持多維度查詢和告警規(guī)則。
Grafana：可視化展示和告警管理，支持PromQL語法。

選擇Micrometer + Spring Boot Actuator作為指標采集層，由Prometheus周期性拉取指標并存儲，Grafana用于展示與告警。

實現(xiàn)方案詳解

項目依賴與配置

在pom.xml中加入依賴：

<dependency>
  <groupId>io.micrometer</groupId>
  <artifactId>micrometer-registry-prometheus</artifactId>
</dependency>
<dependency>
  <groupId>org.springframework.boot</groupId>
  <artifactId>spring-boot-starter-actuator</artifactId>
</dependency>

在application.yml中開啟Actuator暴露端點：

management:
  endpoints:
    web:
      exposure:
        include: prometheus,health,metrics
  metrics:
    export:
      prometheus:
        enabled: true

Prometheus抓取配置

在Prometheus的scrape_configs中添加：

scrape_configs:
  - job_name: 'order-service'
    metrics_path: /actuator/prometheus
    static_configs:
      - targets: ['order-service-host:8080']

自定義業(yè)務指標

在代碼中通過Micrometer的MeterRegistry注冊自定義指標：

import io.micrometer.core.instrument.Counter;
import io.micrometer.core.instrument.Timer;
import io.micrometer.core.instrument.MeterRegistry;
import org.springframework.stereotype.Component;

@Component
public class OrderMetrics {
    private final Counter orderSuccessCounter;
    private final Counter orderFailureCounter;
    private final Timer orderProcessTimer;

    public OrderMetrics(MeterRegistry registry) {
        this.orderSuccessCounter = Counter.builder("order_success_total")
            .description("成功下單總次數(shù)")
            .register(registry);
        this.orderFailureCounter = Counter.builder("order_failure_total")
            .description("下單失敗總次數(shù)")
            .register(registry);
        this.orderProcessTimer = Timer.builder("order_process_duration")
            .description("訂單處理時長")
            .publishPercentileHistogram()
            .register(registry);
    }

    public void recordSuccess() {
        orderSuccessCounter.increment();
    }

    public void recordFailure() {
        orderFailureCounter.increment();
    }

    public Timer.Sample startTimer() {
        return Timer.start(orderProcessTimer.getId().getRegistry());
    }
}

在Service層使用：

@Service
public class OrderService {

    private final OrderMetrics metrics;

    public OrderService(OrderMetrics metrics) {
        this.metrics = metrics;
    }

    public void createOrder(OrderRequest req) {
        Timer.Sample sample = metrics.startTimer();
        try {
            // 業(yè)務邏輯：保存訂單、調(diào)用支付等
            // ...
            metrics.recordSuccess();
        } catch (Exception e) {
            metrics.recordFailure();
            throw e;
        } finally {
            sample.stop(metrics.orderProcessTimer);
        }
    }
}

Grafana展示與告警

在Grafana中新建數(shù)據(jù)源，類型選擇Prometheus，指向Prometheus地址。

創(chuàng)建Dashboard，使用如下PromQL：

rate(order_success_total[1m]) 實時下單成功速率
histogram_quantile(0.95, sum(rate(order_process_duration_bucket[5m])) by (le)) P95訂單處理時長

告警示例：當P95時長超過500ms或失敗率高于1%時發(fā)送通知。

踩過的坑與解決方案

指標沖突：自定義指標名稱與Actuator內(nèi)置指標重名，導致注冊失敗。解決：為業(yè)務指標統(tǒng)一添加前綴，如order_。

直方圖數(shù)據(jù)量大：Histogram默認bucket較多，Prometheus存儲壓力大。解決：合理配置bucket或使用摘要（Summary）類型。

HTTP拉取超時：Prometheus拉取時觸發(fā)高并發(fā)，導致服務響應變慢。解決：調(diào)整Prometheus抓取并發(fā)量，或使用中間網(wǎng)關限流。

總結(jié)與最佳實踐

合理設計業(yè)務指標名稱與標簽，避免沖突與cardinality爆炸。
按需開啟Percentile Histogram，僅對關鍵接口使用。
Grafana Dashboard與告警策略結(jié)合SLO（服務等級目標）定義閾值。
在高并發(fā)環(huán)境中，組件拉取和注冊指標操作需輕量，避免影響業(yè)務。
可擴展至Tracing與日志服務，構建完整的可觀測性平臺。

以上方案已在真實電商平臺中驗證，通過自定義監(jiān)控指標定位性能瓶頸，P95時長從800ms降至350ms，系統(tǒng)穩(wěn)定性顯著提升。

到此這篇關于基于SpringBoot Actuator與Prometheus自定義指標監(jiān)控與性能優(yōu)化實戰(zhàn)指南的文章就介紹到這了,更多相關SpringBoot Actuator與Prometheus監(jiān)控內(nèi)容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關文章希望大家以后多多支持腳本之家！

您可能感興趣的文章: