Spring Boot Actuator 与 Micrometer：性能指标体系搭建

没有指标体系时，性能优化只能依靠偶发日志和临时排查。Spring Boot 服务至少要暴露 HTTP、JVM、线程池、数据库连接池和业务吞吐指标，才能持续发现退化。

解决方案思路

启用 Actuator 的 health、metrics、prometheus 端点，结合 Micrometer 注册 Timer、Counter、Gauge。指标命名保持稳定，标签控制基数，避免 userId、orderId 等高基数标签。

自定义接口耗时指标

Timer.Sample sample = Timer.start(registry);
try {
    return service.query(request);
} finally {
    sample.stop(registry.timer("order.query.latency", "result", "success"));
}

运行逻辑

指标体系的运行逻辑是“端点暴露 -> Prometheus 拉取 -> Dashboard 聚合 -> 告警触发 -> JFR/火焰图深入”。先看趋势，再进样本，排查效率会高很多。

重点观察指标

• http.server.requests 的 P95/P99
• jvm.memory.used、jvm.gc.pause、jvm.threads.live
• hikaricp.connections.active、业务 Timer 指标

常见误区

• 标签基数过高导致指标系统压力大
• 只看平均耗时不看分位数
• 健康检查与性能指标混在一起

参考方案

• Spring Boot Actuator Reference
• Micrometer Reference

上线检查

• 优化前后保留同一口径的指标截图或报告。
• 先灰度单实例或小流量，观察 P95/P99、错误率和资源指标。
• 准备回滚开关，避免性能改动影响核心业务。