首页/云/可观测性速查/标签设计:低基数、稳定、可聚合
监控体系与方法40 条

标签设计:低基数、稳定、可聚合

标签是查询与聚合的维度;设计原则是取值有限且稳定(instance、job、env、route),避免把高动态数据(ID、时间戳)放进标签。

可观测性速查云更新于 2026-10-12
推荐标签job、instance、env、service、route、status(取值可控)
应避免user_id、order_id、trace_id、完整 URL、错误堆栈
技巧错误细节放日志或 exemplar,指标只保留粗粒度分类

用 relabel 把路径归一化为可控维度

用 relabel 把路径归一化为可控维度
metric_relabel_configs:
  - source_labels: [path]
    regex: "/order/[0-9]+"
    target_label: route
    replacement: "/order/:id"
    action: replace
  - regex: "(user_id|cookie|session)"
    action: labeldrop
查询体验取决于标签设计:label_values(metric, route) 能直接生成下拉框的前提是 route 基数可控。

易错点

  • 标签值大小写与拼写不统一(prod/Prod/PROD)会把同一维度拆成多份
  • 事后随意改标签语义会让新旧数据口径不一致,语义变更应通过新指标名发布

数据来源与参考

  • Prometheus 文档 · Label best practices
  • Grafana 文档 · 模板变量与标签过滤
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌