如何在Spring Boot/Micrometer中启用磁盘空间指标上报至AWS CloudWatch

问题背景 #

已启用Spring Metrics的system指标，能获取process.、system.前缀的指标，但disk.free、disk.total未上报到AWS CloudWatch，仅能在Actuator仪表盘中看到这些磁盘指标。

解决步骤 #

1. 手动注册并绑定DiskSpaceMetrics到全局MeterRegistry #

默认情况下，DiskSpaceMetrics仅绑定到Actuator端点的专属MeterRegistry，未关联到CloudWatch使用的全局MeterRegistry，因此需要手动配置绑定：

创建Metrics配置类：

import io.micrometer.core.instrument.MeterRegistry;
import io.micrometer.core.instrument.binder.system.DiskSpaceMetrics;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import java.io.File;

@Configuration
public class MetricsConfig {

    // 指定监控的磁盘根目录，根据部署环境调整（如Windows可改为"C:"）
    @Bean
    public DiskSpaceMetrics diskSpaceMetrics() {
        return new DiskSpaceMetrics(new File("/"));
    }

    // 将磁盘指标绑定到全局MeterRegistry，确保CloudWatch能抓取到
    @Bean
    public DiskSpaceMetrics bindDiskSpaceMetrics(MeterRegistry registry) {
        DiskSpaceMetrics metrics = diskSpaceMetrics();
        metrics.bindTo(registry);
        return metrics;
    }
}

2. 检查并确认application.yml配置 #

确保system指标已启用，且未过滤磁盘相关指标：

management:
  metrics:
    enable:
      system: true
    # 检查是否有指标过滤规则，确保未排除disk前缀的指标
    # 若存在类似以下配置，需删除或调整
    # filters:
    #   exclude: disk.*
    export:
      cloudwatch:
        enabled: true
        namespace: 你的CloudWatch命名空间
    tags:
      application: 你的应用标识

3. 确认CloudWatch导出器依赖 #

确保项目已引入Micrometer CloudWatch导出器依赖：

• Maven：

<dependency>
    <groupId>io.micrometer</groupId>
    <artifactId>micrometer-registry-cloudwatch</artifactId>
</dependency>

• Gradle：

implementation 'io.micrometer:micrometer-registry-cloudwatch'

原理说明 #

Actuator的Metrics端点使用独立的MeterRegistry展示指标，而CloudWatch依赖全局MeterRegistry获取指标数据。通过手动将DiskSpaceMetrics绑定到全局Registry，即可让磁盘指标被CloudWatch定期抓取上报。

内容的提问来源于stack exchange，提问作者CryptoFool