首页/云/可观测性速查/语义约定:字段名统一口径

语义约定:字段名统一口径

Semantic Conventions 规定属性命名:HTTP 用 http.request.method 与 http.response.status_code,数据库用 db.system、db.operation;跨服务分析靠统一字段。

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

常用字段对照

常用字段对照
# HTTP span
http.request.method        = GET
http.response.status_code  = 500
url.path                   = /v1/orders/1024
server.address             = api.internal

# DB span
db.system = mysql / postgresql / redis
db.operation = SELECT
注意版本差异:旧约定使用 http.method/http.status_code,新版本改为后缀命名,升级时统一迁移。

易错点

  • 新旧字段混用会让看板出现双份分组,迁移期先双写再切换
  • 自定义字段命名随意(status1、err_code)会让跨团队查询难以复用

数据来源与参考

  • OpenTelemetry 官方文档 · Semantic Conventions
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌