本文档介绍了轨迹和跨度。 轨迹表示单个端到端操作。轨迹由 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 资源: