追蹤記錄和時距

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

追蹤記錄資料模型

追蹤記錄具有下列屬性:

  • 追蹤 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 資源:

後續步驟