首页/云/可观测性速查/Span 状态与错误标记
本包目录(282 条)

Span 状态与错误标记

状态取值 Unset / Ok / Error:错误要显式标记,配合属性(错误类型、状态码)让筛选“只看失败链路”可用。

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

标记示例(Python)

标记示例(Python)
from opentelemetry.trace import Status, StatusCode

with tracer.start_as_current_span("charge") as span:
    try:
        do_charge()
    except TimeoutError as e:
        span.set_status(Status(StatusCode.ERROR, "upstream timeout"))
        span.record_exception(e)
Unset默认值:未明确成功或失败
Ok显式成功,一般由自动埋点改写
Error失败:建议同时附加错误类型与错误信息
区分“业务失败”与“技术异常”:HTTP 4xx 是否算 Error 要与团队口径一致再埋。

易错点

  • 异常被 catch 后没有 set_status,链路仍显示绿色容易漏掉故障
  • 用状态码一律标 Error 会把 404 这类预期结果算成故障,先定义口径

数据来源与参考

  • OpenTelemetry 官方文档 · Span Status
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌