Spring Boot + Prometheus 实现应用监控（基于 Actuator 和 Micrometer）

Spring Boot + Prometheus 实现应用监控（基于 Actuator 和 Micrometer）

在微服务架构中，监控是保障系统稳定运行的关键组成部分。本文将介绍如何通过 Spring Boot 的 actuator 和 micrometer 组件，将应用的运行指标暴露出来，并使用 Prometheus 定时采集这些指标数据。

环境准备

• JDK：21
• Spring Boot：3.2.5
• 构建工具：Maven
• 监控工具：Prometheus 2.53.4 安装参考
• 面板工具：Grafana v9.1.2 安装参考

示例结构

test/
├── pom.xml                                           # Maven 项目对象模型文件
├── src
│   └── main
│       ├── java
│       │   └── com
│       │       └── example
│       │           └── DemoMonitorApplication.java   # 主类(示例控制器)
│       └── resources
│           └── application.yml                       # 应用配置文件

pom.xml 文件内容如下：

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 
                             http://maven.apache.org/xsd/maven-4.0.0.xsd">
  <modelVersion>4.0.0</modelVersion>

  <!-- ✅ 加入 Spring Boot 官方 parent，自动管理版本号 -->
  <parent>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-parent</artifactId>
    <version>3.2.5</version>
    <relativePath/> <!-- lookup parent from repository -->
  </parent>

  <groupId>com.example</groupId>
  <artifactId>demo-monitor</artifactId>
  <version>1.0.0</version>
  <packaging>jar</packaging>
  <name>demo-monitor</name>

  <properties>
    <java.version>21</java.version>
  </properties>

  <dependencies>
    <!-- Web 服务 -->
    <dependency>
      <groupId>org.springframework.boot</groupId>
      <artifactId>spring-boot-starter-web</artifactId>
    </dependency>

    <!-- Actuator 监控端点 -->
    <dependency>
      <groupId>org.springframework.boot</groupId>
      <artifactId>spring-boot-starter-actuator</artifactId>
    </dependency>

    <!-- Prometheus 指标导出 -->
    <dependency>
      <groupId>io.micrometer</groupId>
      <artifactId>micrometer-registry-prometheus</artifactId>
    </dependency>
  </dependencies>

  <build>
    <plugins>
      <!-- Spring Boot 插件 -->
      <plugin>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-maven-plugin</artifactId>
      </plugin>
    </plugins>
  </build>

</project>

src/main/java/com/example/DemoMonitorApplication.java 内容如下：

package com.example;

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;

@SpringBootApplication
public class DemoMonitorApplication {
    public static void main(String[] args) {
        SpringApplication.run(DemoMonitorApplication.class, args);
    }
}

src/main/resources/application.yml 内容如下：

server:
  port: 8080

management:
  endpoints:
    web:
      exposure:
        include: "*"
  endpoint:
    health:
      show-details: always
  metrics:
    export:
      prometheus:
        enabled: true

说明：

• management.endpoints.web.exposure.include: 暴露的端点，必须包含 prometheus
• management.metrics.export.prometheus.enabled: 启用 Prometheus 导出
• 默认 Prometheus 指标路径为 /actuator/prometheus
• 注意：上述依赖中未显式声明版本号，是因为使用了 Spring Boot 的官方 parent

启动和验证

使用 Maven 启动项目：

./mvnw spring-boot:run

或打包后运行：

mvn clean package
java -jar target/demo-monitor-1.0.0.jar

然后就可以看到有个 8080 端口启动了

验证 Spring Boot 应用

启动应用后，访问指标接口：

http://localhost:8080/actuator/prometheus

你可以看到形如以下格式的指标输出：

Prometheus 抓取配置（静态方式）

Prometheus 配置示例（prometheus.yml）：

scrape_configs:
  - job_name: 'spring-boot-app'
    metrics_path: '/actuator/prometheus'
    static_configs:
      - targets: ['localhost:8080']

启动 Prometheus 后，访问 http://localhost:9090 ，你就可以查询该 Spring Boot 应用的各类指标了，如：

Grafana 面板配置

表盘市场导入仪表盘:访问地址
ID:14370

总结

• 依赖配置简单：通过引入 spring-boot-starter-actuator 和 micrometer-registry-prometheus，即可在 Spring Boot 中集成监控能力。
• 指标暴露统一：所有 JVM、应用及自定义指标统一暴露在 /actuator/prometheus 接口上。
• Prometheus 易于集成：通过 Prometheus 的 scrape_configs 采集配置，即可定时拉取指标数据。
• 适用于单体与微服务架构：无论是本地部署还是容器化，Spring Boot + Prometheus 都是轻量而强大的监控方案。

若后续部署在 Kubernetes 集群中采集多实例指标。欢迎继续探讨 👇