首页/云/可观测性速查/Span Kind:调用方向标注

Span Kind:调用方向标注

Kind 描述 span 在调用中的角色:server/client 成对接跨进程调用,producer/consumer 对接消息流,internal 表示进程内逻辑。

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

五类 Kind

Kind含义典型场景
server接收并处理请求HTTP/RPC 服务端处理
client发起对外调用RPC 客户端、数据库调用
producer发送消息向 Kafka 生产消息
consumer消费消息Kafka 消费处理
internal进程内操作本地计算、缓存读写

消息链路要点

消息链路要点
producer span 在发送时结束记录;
consumer span 在消费时新建,二者通过 span link 关联(见 span links 条目)。
Kind 与命名配合能让链路图直接看出“谁调谁”,排障时先按 kind 过滤客户端 span 看被调服务耗时。

易错点

  • 所有 span 都用 internal 会让链路图无法区分调用边界
  • 异步消息场景 producer/consumer 不在同一 trace 树内,需要用链接或关联字段串起来

数据来源与参考

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