首页/云/可观测性速查/手动埋点:业务关键路径补 span
本包目录(282 条)

手动埋点:业务关键路径补 span

自动埋点覆盖框架层,业务语义(下单、扣库存、对账)要手动补:显式命名、设属性、标记状态,才能让链路对业务可读。

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

Python 手动埋点

Python 手动埋点
tracer = trace.get_tracer("orders")

with tracer.start_as_current_span("order.create") as span:
    span.set_attribute("order.type", "flash_sale")
    try:
        order_id = create_order(req)
        span.set_attribute("order.result", "created")
    except StockOut as e:
        span.set_status(Status(StatusCode.ERROR, "stock out"))
        span.record_exception(e)
        raise
手动 span 命名用“动作 + 对象”(order.create、stock.hold),保持低基数便于聚合。

易错点

  • 把整个大循环包在一个 span 里粒度太粗,定位不到具体阶段
  • 手动 span 忘记挂到当前上下文(未用 start_as_current)会形成平行树,父子关系断裂

数据来源与参考

  • OpenTelemetry 官方文档 · Manual instrumentation
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌