在 Spring Boot 应用中使用 Micrometer 将指标上报给 Prometheus 是一个非常标准且常见的做法。整个过程主要分为添加依赖、配置端点和**（可选）自定义指标**三个步骤。

步骤 1：添加必要的依赖

需要在 pom.xml（Maven）或 build.gradle（Gradle）中添加以下依赖：

Maven (pom.xml)

<dependencies>
<!-- Spring Boot Actuator (核心，提供健康检查、指标等端点) -->
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-actuator</artifactId>
</dependency>
<!-- Micrometer Registry for Prometheus (将指标转换为 Prometheus 格式) -->
<dependency>
<groupId>io.micrometer</groupId>
<artifactId>micrometer-registry-prometheus</artifactId>
</dependency>
<!-- (可选) 如果你使用 Spring Web (MVC), 会自动收集 HTTP 请求指标 -->
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-web</artifactId>
</dependency>
</dependencies>

注意：micrometer-registry-prometheus 依赖会自动引入 Micrometer 的核心库，所以你不需要单独引入 micrometer-core。

步骤 2：配置 application.yml 或 application.properties

为了让 Prometheus 能够抓取指标，需要暴露 /actuator/prometheus 端点。

application.yml

management:
  endpoints:
    web:
      exposure:
        # 暴露 prometheus 端点，让 Prometheus 可以访问
        include: health,info,prometheus
  endpoint:
    prometheus:
      enabled: true
    health:
      show-details: always # 可选：显示健康详情

application.properties

# 暴露 prometheus 端点
management.endpoints.web.exposure.include=health,info,prometheus
# 启用 prometheus 端点
management.endpoint.prometheus.enabled=true
# (可选) 显示健康详情
management.endpoint.health.show-details=always

重要：/actuator/prometheus 是 Prometheus 抓取数据的标准端点。

步骤 3：启动应用并验证

1. 启动Spring Boot 应用。
2. 访问 http://localhost:8080/actuator，应该能看到 prometheus 端点。
3. 访问 http://localhost:8080/actuator/prometheus，应该能看到类似如下的 Prometheus 格式指标：

# HELP http_server_requests_seconds 
# TYPE http_server_requests_seconds summary
http_server_requests_seconds_count{method="GET",uri="/actuator/prometheus",...} 1.0
http_server_requests_seconds_sum{method="GET",uri="/actuator/prometheus",...} 0.055231211
# HELP jvm_memory_used_bytes 
# TYPE jvm_memory_used_bytes gauge
jvm_memory_used_bytes{area="heap",id="G1 Young Generation",} 12345678.0
...

这些就是 Micrometer 收集并格式化后供 Prometheus 抓取的数据。

步骤 4：（可选）自定义业务指标

可以轻松地创建自己的指标。Spring Boot 会自动注入 MeterRegistry。

import io.micrometer.core.instrument.Counter;
import io.micrometer.core.instrument.MeterRegistry;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;

@RestController
public class MyController {

    private final Counter myCustomCounter;

    @Autowired
    public MyController(MeterRegistry registry) {
        // 创建一个自定义计数器
        this.myCustomCounter = Counter.builder("my.custom.requests")
                .description("A custom counter for demo")
                .tag("type", "demo") // 可以添加标签（tags）
                .register(registry);
    }

    @GetMapping("/demo")
    public String demo() {
        // 每次调用此方法，计数器 +1
        myCustomCounter.increment();
        return "Hello from custom metric!";
    }
}

访问 /demo 接口几次后，再访问 /actuator/prometheus，就能看到类似：

my_custom_requests_total{type="demo",} 3.0

步骤 5：配置 Prometheus 抓取

最后，在prometheus.yml 配置文件中，添加一个 job 来抓取这个应用的指标：

scrape_configs:
- job_name: 'spring-boot-app'
metrics_path: '/actuator/prometheus'
static_configs:
- targets: ['localhost:8080'] # 替换为你的应用实际地址

启动 Prometheus 后，它就会定时从Spring Boot 应用拉取指标。

总结

1. 加依赖：spring-boot-starter-actuator + micrometer-registry-prometheus
2. 配端点：在 application.yml 中暴露 /actuator/prometheus
3. （可选）写代码：通过 MeterRegistry 创建自定义指标
4. 配 Prometheus：在 prometheus.yml 中添加抓取任务

完成以上步骤，Spring Boot 应用就能通过 Micrometer 将丰富的指标数据上报给 Prometheus 了，为后续的监控、告警和可视化（如 Grafana）打下基础。