Spring Micrometer @Observed注解如何传递动态方法参数作为高基数标签？

• @Observed注解本身不支持直接传入动态方法参数作为标签，因为注解属性只能是编译时常量，无法引用运行时的方法参数值。

• 要实现将userId这类动态参数作为高基数标签加入指标和追踪链路，有两种可行方案：

  1. 方法内手动添加标签
     这种方式简单直接，适合单个方法的自定义需求。在方法中注入ObservationRegistry，获取当前的观测实例后添加高基数键值对：

     @Observed(name = "user.name",
              contextualName = "getting-user-name",
              lowCardinalityKeyValues = {"userType", "userType2"})
     String userName(String userId, ObservationRegistry observationRegistry) {
         // 获取当前观测实例并添加高基数标签
         Observation.getCurrent(observationRegistry)
             .ifPresent(observation -> observation.highCardinalityKeyValue("userId", userId));
         // 业务逻辑实现
         return "目标用户名";
     }
     

  2. 全局自定义ObservationHandler
     如果需要批量处理多个方法的参数埋点，可以自定义ObservationHandler，通过方法调用上下文获取参数并添加标签：

     @Component
     public class HighCardinalityParamHandler implements ObservationHandler<Observation.Context> {
     
         @Override
         public boolean supportsContext(Observation.Context context) {
             // 仅处理方法调用观测上下文
             return context instanceof MethodObservationContext;
         }
     
         @Override
         public void onStart(Observation.Context context) {
             MethodObservationContext methodContext = (MethodObservationContext) context;
             Object[] args = methodContext.getArguments();
             // 根据实际参数位置获取userId，此处假设第一个参数是userId
             if (args != null && args.length > 0 && args[0] instanceof String) {
                 String userId = (String) args[0];
                 context.highCardinalityKeyValue("userId", userId);
             }
         }
     }
     

     注意：高基数标签（如userId）会显著增加指标基数，可能导致存储和性能问题，建议仅在必要时使用；如果仅需在追踪链路中展示参数，可优先将其添加为Trace属性而非指标标签。

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