本文档介绍了跟踪记录和 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 资源: