本文件將介紹追蹤和跨距。「追蹤記錄」代表單一端對端作業。追蹤記錄由跨度組成,而跨度是單一函式或作業的記錄。
追蹤記錄資料模型
追蹤記錄具有下列屬性:
追蹤 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 資源: