SpringBoot项目集成Prometheus和Grafana

下面是一个完整的 Spring Boot 项目示例，集成 Prometheus 和 Grafana 进行性能监控，包括：

Prometheus 作为监控数据收集工具Micrometer 作为指标采集库Grafana 作为可视化展示工具 步骤概览 引入依赖：在 pom.xml 中添加 Prometheus 和 Actuator 相关依赖。配置 Spring Boot：启用 Actuator 并暴露 Prometheus 端点。编写示例代码：使用 Micrometer 记录应用性能数据。配置 Prometheus：拉取 Spring Boot 端点的数据。配置 Grafana：可视化 Prometheus 数据。 1. 添加 Maven 依赖

在 pom.xml 文件中加入：

<dependencies> <!-- Spring Boot Actuator 监控 --> <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-actuator</artifactId> </dependency> <!-- Micrometer Prometheus 监控支持 --> <dependency> <groupId>io.micrometer</groupId> <artifactId>micrometer-registry-prometheus</artifactId> </dependency> </dependencies> 2. 配置 application.yml server: port: 8080 management: endpoints: web: exposure: include: "prometheus, health, info, metrics" metrics: export: prometheus: enabled: true

此配置：

允许 Actuator 通过 http://localhost:8080/actuator/prometheus 公开 Prometheus 监控数据。允许 /actuator/health、/actuator/info 等端点。 3. 编写 Spring Boot 监控代码

创建 MonitorController.java，提供测试接口并记录自定义监控指标：

package com.example.monitoring.controller; import io.micrometer.core.instrument.Counter; import io.micrometer.core.instrument.MeterRegistry; import io.micrometer.core.instrument.Timer; import org.springframework.web.bind.annotation.GetMapping; import org.springframework.web.bind.annotation.RequestParam; import org.springframework.web.bind.annotation.RestController; import java.time.Duration; import java.util.Random; @RestController public class MonitorController { private final Counter requestCounter; private final Timer responseTimer; private final Random random = new Random(); public MonitorController(MeterRegistry registry) { this.requestCounter = Counter.builder("api_requests_total") .description("Total API Requests") .register(registry); this.responseTimer = Timer.builder("api_response_time") .description("API Response Time") .register(registry); } @GetMapping("/hello") public String hello(@RequestParam(defaultValue = "World") String name) { requestCounter.increment(); // 记录请求数 return responseTimer.record(() -> { // 记录执行时间 try { Thread.sleep(random.nextInt(500)); // 模拟延迟 } catch (InterruptedException ignored) {} return "Hello, " + name; }); } } api_requests_total：记录 /hello 接口的总访问量。api_response_time：记录 /hello 的执行时间。 4. 启动 Prometheus 配置 prometheus.yml

在 prometheus.yml 添加：

global: scrape_interval: 5s # 每 5 秒抓取数据 scrape_configs: - job_name: 'spring-boot-app' metrics_path: '/actuator/prometheus' static_configs: - targets: ['host.docker.internal:8080'] # 或者改成 'localhost:8080' 取决于你的运行环境

然后运行 Prometheus：

./prometheus --config.file=prometheus.yml

访问 http://localhost:9090，进入 Prometheus 界面，查询 api_requests_total 指标。

5. 启动 Grafana 配置数据源 访问 http://localhost:3000/（默认账号 admin/admin）。添加数据源，选择 Prometheus。设置 http://localhost:9090 作为数据源地址。保存后，在 Explore 面板查询 api_requests_total 和 api_response_time。 总结 Spring Boot 通过 Actuator 和 Micrometer 采集监控数据。Prometheus 从 /actuator/prometheus 端点拉取数据。Grafana 通过 Prometheus 进行数据可视化。

这样，你就成功在 Spring Boot 项目中集成了 Prometheus 和 Grafana 进行性能监控！ 🚀