轨迹和 span

本文档介绍了轨迹和跨度。 轨迹表示单个端到端操作。轨迹由 span 组成,后者是单个函数或操作的记录。

轨迹数据模型

轨迹具有以下属性:

  • 轨迹 ID:端到端操作的唯一标识符。在端到端操作中,必须将轨迹 ID 作为上下文传播。

  • 一组共享相同轨迹 ID 值的 span。

    Cloud Trace 使用跟踪记录 ID 来确定其代码库中哪些 span 与同一跟踪记录相关联。

Span 数据模型

时段对应于在某个有限(但不为零)时间段内发生的操作。下面列出了每个跨度存储的一些基本属性:

  • 轨迹 ID:发生此特定整体操作的端到端操作的标识符。
  • span ID:span 的唯一标识符。如果在执行单个整体操作时多次调用同一操作,则轨迹中可能会包含多个同名跨度。不过,每个 span 都有一个不同的 span ID。
  • 父级跨度 ID:用于标识调用了此跨度的操作。“根”span 的父 span ID 已设置为 null
  • 名称:执行的操作的名称。
  • 开始时间:操作的开始时间。
  • 结束时间:操作的结束时间。

span 可能还包含属性,这些属性使用键值对存储有关操作的其他信息。Cloud Trace 建议您尽可能使用 OpenTelemetry 语义惯例

资源

OpenTelemetry 资源:

后续步骤