跟踪记录和 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 资源：

后续步骤