首页/云/可观测性速查/Span 属性与事件

Span 属性与事件

属性(attributes)是键值元数据,用于过滤与聚合;事件(events)是带时间戳的节点记录,典型用途是记录异常堆栈与关键里程碑。

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

属性与事件用法

属性与事件用法
span.set_attribute("http.request.method", "POST")
span.set_attribute("http.response.status_code", 500)
span.set_attribute("order.id", "SO-2026-1012-001")   # 注意基数与脱敏

span.add_event("cache.miss", {"key": "sku:100"})
# 异常记录为事件(含堆栈),并打 Error 状态
属性会被索引与统计,高基数字段(订单号)适合放事件或日志,放进属性要评估存储成本。

易错点

  • 把大对象序列化成属性值会放大存储,长文本放日志侧
  • 敏感字段(手机号、令牌)进属性属于数据泄露风险,纳入脱敏清单

数据来源与参考

  • OpenTelemetry 官方文档 · Span Attributes / Events
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌