轨迹和 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 资源：

• OpenTelemetry
• OpenTelemetry 轨迹概览
• OpenTelemetry 轨迹
• OpenTelemetry trace.proto

后续步骤

• 了解情境和情境传播。
• 了解抽样。