SDK 侧采样配置（环境变量）
SDK 侧采样配置（环境变量）
# 基于父级决定，根流量按 10% 采样
OTEL_TRACES_SAMPLER=parentbased_traceidratio
OTEL_TRACES_SAMPLER_ARG=0.1
# 其他常用：always_on / always_off / traceidratio / parentbased_always_on比例采样对 trace_id 做确定性哈希：同一 trace 在任意服务算出同样结果，不会出现截断的树。
本包目录（282 条）
监控体系与方法40 条Prometheus 与采集64 条Grafana 与看板53 条日志平台52 条
链路追踪23 条
- 链路追踪基础：Trace 与 Span
- OpenTelemetry：项目结构与定位
- W3C Trace Context：跨服务传播标准
- 头部采样：在起点决定是否记录
- 自动埋点：零代码接入
- Trace ID 与 Span ID 的格式
- 上下文传播：让跨进程调用不断链
- 尾部采样：先收全再决定
- 手动埋点：业务关键路径补 span
- Collector：遥测数据的中转站
- Span 属性与事件
- 按比例采样的配置实践
- Resource：描述数据来源的身份
- Python SDK 初始化示例
- Collector 配置文件示例
- OTLP 端口与端点约定
- Span 状态与错误标记
- Go SDK 初始化示例
- 语义约定：字段名统一口径
- Span Kind：调用方向标注
- 常用 Processor：批处理与属性加工
- Collector 部署形态：agent 与 gateway
- Baggage：随链路传播的业务上下文
头部采样：在起点决定是否记录
头部采样在 trace 开始时决定：parent-based 尊重上游决定，ratio 采样按 trace_id 哈希确定且全链路一致；成本可控但采不到“事后才重要”的链路。
易错点
- 多服务各自随机采样会互相矛盾，统一由入口决定并向下传播才是正确姿势
- 低流量服务按 1% 抽样可能几天采不到错误样本，比例按流量分层
数据来源与参考
- OpenTelemetry 官方文档 · Sampling