---

title: OpenTelemetry Exemplars：Trace到Metrics关联实践

keywords:

• Exemplars
• Trace
• Metrics
• Prometheus
• 关联

description: 通过 Exemplars 将关键 Trace ID 附着到 Metrics 样本，实现从指标到具体请求的快速跳转与根因定位。

categories:

• 文章资讯
• 技术教程

---

OpenTelemetry Exemplars：Trace到Metrics关联实践

概览

Exemplars 允许在指标样本中携带少量标签（如 trace_id），实现指标与链路的双向关联，提升定位效率。

技术参数（已验证）

• 采集：在直方图与计数器样本上附着 trace_id 等标识；采样率需控制。
• Prometheus：支持 Exemplars 存储与查询；Grafana 可在图上展示跳转入口。
• 安全与成本：仅附着必要标识，避免高基数与隐私泄露。

实战清单

• 为关键接口与错误率指标开启 Exemplars；关联到 Trace 后端（Jaeger等）。
• 统一采样与标签策略，避免高基数导致成本上升。