追蹤記錄和時距

本文件將介紹追蹤和跨距。「追蹤記錄」代表單一端對端作業。追蹤記錄由跨度組成，而跨度是單一函式或作業的記錄。

追蹤記錄資料模型

追蹤記錄具有下列屬性：

• 追蹤 ID：端對端作業的專屬 ID。追蹤 ID 必須以 context 的形式傳播，做為端對端作業的一部分。

• 共用相同追蹤 ID 值的跨度集合。

  Cloud Trace 會使用追蹤 ID 找出儲存庫中與相同追蹤記錄相關的跨度。

時距資料模型

跨度對應於在某個有限但非零的時間間隔內發生的作業。以下列出每個區段儲存的部分必要屬性：

• 追蹤 ID：發生這項特定整體作業的端對端作業 ID。
• Span ID：Span 的專屬 ID。如果在執行單一整體作業時多次叫用相同的作業，則追蹤記錄可能會包含多個名稱相同的跨度。不過，每個區段都有不同的區段 ID。
• 父項區間 ID：識別叫用此區間的作業。「root」區塊的父項區塊 ID 設為 null。
• 名稱：已執行的作業名稱。
• 開始時間：作業的開始時間。
• End time：作業的結束時間。

Span 也可能包含屬性，這些屬性會使用鍵/值組合儲存操作的其他資訊。Cloud Trace 建議您盡量使用 OpenTelemetry 語意規則。

資源

OpenTelemetry 資源：

• OpenTelemetry
• OpenTelemetry Trace 總覽
• OpenTelemetry 追蹤記錄
• OpenTelemetry trace.proto

後續步驟

• 瞭解情境和情境傳播。
• 瞭解取樣。