首页/云/可观测性速查/Exemplars:把指标关联到链路
本包目录(282 条)
监控体系与方法40 条
Prometheus 与采集64 条
Grafana 与看板53 条日志平台52 条链路追踪23 条告警与响应50 条

Exemplars:把指标关联到链路

Exemplar 是附加在样本上的标注元数据,典型做法是携带 trace_id:看到延迟毛刺时从指标直接跳到对应链路,把指标与追踪两支柱串起来。

可观测性速查云更新于 2026-10-12

启用与使用

启用与使用
# 服务端开启 exemplar 存储(默认关闭)
prometheus --enable-feature=exemplar-storage

# 抓取侧:协商到 OpenMetrics 格式才会收到 exemplar
# 应用侧:观测直方图时附带当前 trace_id(OpenTelemetry 客户端可自动携带)
# 展示侧:Grafana 面板开启 Exemplars 开关,毛刺点可跳转 Jaeger/Tempo
通常只给关键延迟直方图附带 exemplar,控制存储开销并保持信噪比。

易错点

  • exemplar 存储容量独立且有限,海量直方图都附带 exemplar 会互相挤占、可查数量下降
  • exemplar 不进入普通 PromQL 查询结果,只能在支持它的界面(如 Grafana)里查看

数据来源与参考

  • Prometheus 文档 · exemplar storage
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌