跟踪记录和 span

本文档介绍了跟踪记录和 span。“跟踪记录”表示单个端到端操作。trace跟踪记录由 span 组成,即单个函数或操作的记录。

跟踪数据模型

跟踪记录具有以下属性:

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

  • 具有相同跟踪记录 ID 值的 span 集合。

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

Span 数据模型

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

  • 跟踪记录 ID:执行此特定整体操作的端到端操作的标识符。
  • Span ID:span 的唯一标识符。如果在单个整体操作的执行方式中多次调用同一操作,则跟踪记录可能会包含多个同名的 span。不过,每个 span 都具有不同的 span ID。
  • 父级 span ID:标识调用此 span 的操作。“根”span 的父 span ID 设置为 null
  • 名称:所执行的操作的名称。
  • 开始时间:操作的开始时间。
  • 结束时间:操作的结束时间。

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

资源

OpenTelemetry 资源:

后续步骤