jaeger.clientconfig.sampler 不能热更新，因 tracer 初始化后 sampler 实例被固化且不可替换；需改用 jaeger.remotesampler，通过 agent 的 sampling 端口（如 5778）动态拉取策略实现运行时重载。
为什么 jaeger.ClientConfig.Sampler 不能热更新
Go 的 Jaeger 客户端初始化后，Sampler 实例被绑定在 Tracer 内部，且不提供替换接口。直接改配置结构体字段（比如 cfg.Sampler.Param）完全无效——因为采样决策发生在 span 创建时，走的是已初始化的 sampler 实例方法，不是每次读配置。
- 常见错误现象：
Tracer启动后修改jaeger.SamplerConfig.Param，但日志/指标里采样率毫无变化 - 根本原因：Jaeger Go client 的
Tracer是不可变设计，sampler 在cfg.NewTracer()时就被固化 - 正确思路：必须用支持运行时重载的 sampler 类型，而非静态配置
用 jaeger.RemoteSampler 接收后端动态下发
Jaeger 支持通过 HTTP 从 agent 或 collector 拉取采样策略，这才是官方推荐的动态调整路径。它会定期轮询（默认 60s），拿到 JSON 策略后自动切换内部 sampler 实例。
- 使用场景：你有 Jaeger agent 部署，且开启了 sampling server（agent 默认开启
--sampling.server-host-port） - 初始化关键参数：
jaeger.NewRemoteSampler("127.0.0.1:5778", "your-service-name")，注意 host:port 是 agent 的 sampling 端口（非 thrift/http 端口） - 兼容性注意：老版本 Jaeger agent（jaeger.SamplingServerURL 显式指定或降级 client 版本
- 调试技巧：直接
curl http://127.0.0.1:5778/sampling?service=your-service-name看返回是否含"samplingRate"
自定义 jaeger.Sampler 实现运行时切换
如果不用 Jaeger agent、或需要更细粒度控制（比如按 endpoint、error rate 动态调参），就得自己实现一个可更新的 sampler。核心是把采样逻辑委托给一个原子变量指向的函数。
- 关键结构：
type DynamicSampler struct { sampler atomic.Value }，sampler.Store(func(ctx context.Context, op string) bool { ... }) - 性能影响：atomic.Load 几乎无开销，但避免在采样函数里做网络/锁操作——否则高并发下 tracer 创建会卡住
- 安全更新方式：用 goroutine + channel 控制更新节奏，防止高频 reload 导致 sampler 频繁切换（例如每 5 秒最多更新一次）
- 示例片段：
ds := &DynamicSampler{} ds.sampler.Store(jaeger.NewProbabilisticSampler(0.1)) // 后续可安全调用 ds.sampler.Store(jaeger.NewProbabilisticSampler(0.01))
采样率突变对 trace 数据链路的影响
动态调低采样率不会中断已有 trace，但会导致 span 丢失，下游无法拼出完整链路。这点容易被忽略，尤其在 error 场景下。
立即学习“go语言免费学习笔记（深入）”；
- 典型问题：把采样率从 1.0 降到 0.01 后，发现某些失败请求的 trace 只剩 client 端 span，server 端没了
- 原因：traceID 是 client 生成并透传的，但每个服务独立决定是否采样该 span；client 采了，server 没采 → 链路断裂
- 缓解办法：强制 error 请求 100% 采样（用
jaeger.Tag{Key: "error", Value: true}触发OnError回调重采样），或统一用jaeger.ConstSampler(true)临时兜底 - 监控建议：单独埋点统计「span 被丢弃但 parent 存在」的比例，这是链路断裂的直接信号
真正难的不是换采样器，而是让所有服务节点同步感知策略变更，并处理好跨服务 traceID 的一致性。哪怕只漏掉一个中间件的采样开关，整条链就断了。
