首页/云/可观测性速查/统一资源属性:让数据可关联、可下钻
监控体系与方法40 条

统一资源属性:让数据可关联、可下钻

跨信号关联的前提是统一标识:service.name、host、env、version 等资源属性在三类遥测数据中保持一致,看板与检索才能按同一维度切换。

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

建议统一的属性

属性示例值用途
service.nameorder-api按服务聚合与下钻
deployment.environmentprod / staging环境隔离
host.name / instanceip-10-0-1-12定位到主机
service.versionv2.7.3关联发布与回归

注入统一资源属性(示例)

注入统一资源属性(示例)
export OTEL_RESOURCE_ATTRIBUTES="service.name=order-api,deployment.environment=prod,service.version=v2.7.3"
# 日志采集侧同步打标(Filebeat 字段示例)
# fields: {service: order-api, env: prod}
版本属性是变更关联的钥匙:把发布事件与错误率曲线对齐,回归问题几分钟内可定位。

易错点

  • 不同系统用不同命名(service 与 app 与 application)会导致无法联动查询
  • 环境标识缺失时,测试流量混入生产看板会干扰判断

数据来源与参考

  • OpenTelemetry 文档 · Resource Semantic Conventions
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌