Spring Boot Actuator升级后jvm.gc.pause指标缺失原因咨询

核心原因 #

Spring Boot 3.0.x依赖的Micrometer版本升级至1.10.x，该版本对GC相关指标进行了重构：原统一的jvm.gc.pause指标被拆分为两个更细粒度的指标，分别对应不同GC代的暂停时间：

• jvm.gc.young.generation.pause：年轻代GC暂停指标
• jvm.gc.old.generation.pause：老年代GC暂停指标

Micrometer团队做出此调整的目的是让GC指标的语义更清晰，便于区分不同代的GC行为，避免原指标因包含多维度数据导致的混淆。

验证与替代方案 #

1. 查看新指标：调用/actuator/metrics接口，现在可以看到上述两个新指标；若需查看具体数据，可直接访问/actuator/metrics/jvm.gc.young.generation.pause或/actuator/metrics/jvm.gc.old.generation.pause。
2. 兼容旧指标名称：如果需要保留原jvm.gc.pause指标以兼容现有监控系统，可以通过自定义MeterFilter添加别名或重映射指标名称：

import io.micrometer.core.instrument.Meter;
import io.micrometer.core.instrument.config.MeterFilter;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;

@Configuration
public class MetricsCompatibilityConfig {

    @Bean
    public MeterFilter gcPauseLegacyAliasFilter() {
        return MeterFilter.rename(
            id -> id.getName().startsWith("jvm.gc.") && id.getName().endsWith(".pause"),
            name -> name.replace("jvm.gc.young.generation.pause", "jvm.gc.pause")
                        .replace("jvm.gc.old.generation.pause", "jvm.gc.pause"),
            (id, newName) -> id.withName(newName)
                               .withTag("generation", id.getName().contains("young") ? "young" : "old")
        );
    }
}

配置完成后，重启应用即可在/actuator/metrics中看到带generation标签的jvm.gc.pause指标，行为与旧版本一致。

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