使用@Timed注解时Micrometer Timer指标未在CloudWatch中展示

以下是针对该问题的具体排查步骤和解决方案：

1. 排查@Timed注解的层级与属性冲突 #

你在类和方法上都标注了@Timed，可能存在层级覆盖问题，建议调整配置：

• 移除类上的@Timed("test")，避免方法级注解被覆盖；
• 给方法级注解补充必要属性，确保指标被正确标识：

  @GetMapping(value="/path")
  @Timed(value = "ping", description = "Ping endpoint latency", histogram = true)
  public ResponseEntity ping(@RequestHeader Map<String,String> headers){
      return applyHeaders(Response.status(200).entity("ok"));
  }
  

2. 验证Spring AOP代理与TimedAspect生效情况 #

TimedAspect基于Spring AOP实现，需确保代理逻辑正常执行：

• 给TimedAspect Bean添加日志输出，确认实例已初始化：

  @Configuration
  public class TimedConfiguration {
     @Bean
     public TimedAspect timedAspect(MeterRegistry registry) {
         TimedAspect aspect = new TimedAspect(registry);
         System.out.println("TimedAspect initialized successfully");
         return aspect;
     }
  }
  

• 确认Controller方法非final（AOP无法代理final方法），你的ping方法符合要求；
• 若使用自定义Spring配置，需添加@EnableAspectJAutoProxy注解开启AOP支持；
• 调整TimedAspect的优先级，避免被其他切面拦截：

  @Bean
  @Order(Ordered.HIGHEST_PRECEDENCE)
  public TimedAspect timedAspect(MeterRegistry registry) {
     return new TimedAspect(registry);
  }
  

3. 确认Micrometer指标采集状态 #

通过Spring Boot Actuator验证指标是否被成功采集：

• 引入Actuator依赖并开启metrics端点：

  dependencies {
      implementation 'org.springframework.boot:spring-boot-starter-actuator'
  }
  

  management:
    endpoints:
      web:
        exposure:
          include: metrics
  

• 访问/actuator/metrics/ping，若返回指标数据，说明Micrometer已采集，问题出在CloudWatch导出环节；若无数据，回到AOP配置排查。

4. 检查CloudWatch导出配置 #

手动指标上报成功，说明CloudWatch基础配置正常，需确认@Timed生成的指标是否符合导出规则：

• 配置Micrometer指标前缀与CloudWatch命名空间，确保指标能被正确识别：

  management:
    metrics:
      tags:
        application: your-app-name
      export:
        cloudwatch:
          namespace: your-custom-namespace
          enabled: true
  

• 在CloudWatch控制台搜索带前缀的指标（如application.ping），而非直接搜索ping，避免因默认前缀过滤导致无法找到。

5. 版本兼容性检查 #

确保Spring Boot、Micrometer与CloudWatch Registry版本兼容：

• Spring Boot 3.x需搭配Micrometer 1.10+，Spring Boot 2.x对应Micrometer 1.9及以下版本；
• 检查build.gradle中的依赖版本，避免版本冲突：

  dependencies {
      implementation 'io.micrometer:micrometer-registry-cloudwatch:1.12.0'
      implementation 'org.springframework.boot:spring-boot-starter-aop'
  }
  

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