在Istio服务网格中为Jaeger Span添加自定义标签不生效如何解决

你当前配置的自定义标签key是my_tag_header，而非你预期的test，test是你设置的请求头提取来源和默认值，是最常见的配置误解。你可以按照以下步骤逐一排查解决：

• 第一步：修正配置结构（核心问题）
  将你的tracing.yaml中配置项调整为如下结构，直接把custom_tags下的键名设为你想要的标签keytest，同时注意部分Istio版本默认值字段需要使用下划线格式default_value：

  apiVersion: install.istio.io/v1alpha1
  kind: IstioOperator
  spec:
    meshConfig:
      accessLogFile: /dev/stdout
      outboundTrafficPolicy:
        mode: REGISTRY_ONLY
      enableTracing: true
      defaultConfig:
        tracing:
          sampling: 100.0
          custom_tags:
            test: # 此处即为最终Span生成的标签key
              header:
                name: test # 提取值的请求头名称
                default_value: "test" # 无对应请求头时的默认填充值
  

  同时建议你把所有--set参数都写入YAML配置中，避免多来源配置合并时出现覆盖冲突，安装命令可简化为istioctl install --set profile=demo -f .\tracing.yaml -y。
• 第二步：验证全局配置下发
  安装更新配置完成后，执行命令kubectl get configmap istio -n istio-system -o yaml，检查meshConfig下是否存在你配置的tracing相关条目，确认配置已成功写入Istio全局配置。
• 第三步：重启工作负载Sidecar代理
  配置更新后，已运行的工作负载的Sidecar代理不会自动加载新配置，需要重启对应工作负载触发Sidecar重新注入：
  kubectl rollout restart deployment <你的工作负载名称> -n <工作负载所在命名空间>
• 第四步：验证代理侧配置加载
  待Pod重启完成后，执行命令确认Sidecar代理已经加载了自定义标签配置：
  istioctl proxy-config bootstrap <工作负载Pod名称>.<命名空间> | grep -A 10 custom_tags
  确认输出中存在你配置的test标签规则后，再发起业务请求，即可在Jaeger的对应Span中看到自定义标签。

内容的提问来源于stack exchange，提问作者Amir Soleimani Borujerdi