Spring Boot应用监控指标收集-源码库

Spring Boot应用监控指标收集：从零搭建生产级监控体系

作为一名长期奋战在一线的开发者，我深知应用监控的重要性。记得有一次线上事故，由于缺乏有效的监控指标，我们花了整整半天才定位到问题。从那以后，我就把监控体系建设作为每个项目的必备环节。今天，我将分享如何在Spring Boot应用中实现完整的指标收集方案。

1. 基础依赖配置

首先，我们需要引入Spring Boot Actuator依赖。这是Spring Boot官方提供的监控工具包，包含了丰富的端点（Endpoint）来暴露应用的各种指标。



    org.springframework.boot
    spring-boot-starter-actuator


    io.micrometer
    micrometer-registry-prometheus

在application.yml中配置暴露的端点：


management:
  endpoints:
    web:
      exposure:
        include: health,info,metrics,prometheus
  endpoint:
    health:
      show-details: always

2. 自定义业务指标收集

除了系统自带的指标，我们还需要收集业务相关的指标。比如订单创建数量、接口调用次数等。这里我踩过一个坑：直接使用静态变量计数会导致指标丢失，正确的做法是通过Micrometer的MeterRegistry。


@Service
public class OrderService {
    
    private final Counter orderCounter;
    private final Timer orderTimer;
    
    public OrderService(MeterRegistry registry) {
        this.orderCounter = Counter.builder("order.created")
            .description("订单创建数量")
            .register(registry);
            
        this.orderTimer = Timer.builder("order.process.time")
            .description("订单处理时间")
            .register(registry);
    }
    
    public void createOrder(Order order) {
        orderCounter.increment();
        
        Timer.Sample sample = Timer.start();
        try {
            // 业务处理逻辑
            processOrder(order);
        } finally {
            sample.stop(orderTimer);
        }
    }
}

3. JVM和系统指标监控

在实际生产环境中，JVM内存、GC情况、线程状态等都是必须监控的指标。Spring Boot Actuator已经帮我们自动收集了这些数据，我们只需要配置暴露即可。


management:
  metrics:
    enable:
      jvm: true
      system: true
      logback: true

4. 集成Prometheus和Grafana

收集指标只是第一步，如何展示和告警才是关键。我推荐使用Prometheus + Grafana的组合。这里分享一个docker-compose配置，可以快速搭建监控平台：


version: '3'
services:
  prometheus:
    image: prom/prometheus
    ports:
      - "9090:9090"
    volumes:
      - ./prometheus.yml:/etc/prometheus/prometheus.yml
      
  grafana:
    image: grafana/grafana
    ports:
      - "3000:3000"
    environment:
      - GF_SECURITY_ADMIN_PASSWORD=admin

Prometheus配置文件中需要添加对Spring Boot应用的抓取：


scrape_configs:
  - job_name: 'spring-boot-app'
    metrics_path: '/actuator/prometheus'
    static_configs:
      - targets: ['host.docker.internal:8080']