追蹤儲存空間總覽

本文說明 Cloud Trace 資料的儲存模型。這項功能引進了可觀測性 bucket、可觀測性檢視畫面和連結。建立連結後，您就能從 BigQuery 查詢追蹤資料。

本文不會說明結構定義，也就是指定個別 span 的儲存方式。詳情請參閱「追蹤結構定義」。

可觀測性儲存模型

Observability API 儲存空間模型採用下列架構：

可觀測性 bucket
可觀測性 bucket 是資料集的管理實體，用於儲存資料。可觀測性值區位於特定位置，並設有資料保留政策。當 Google Cloud 服務使用 Observability API 儲存資料時，系統會根據服務名稱建立可觀測性儲存空間。舉例來說，如果是 Cloud Trace 服務，系統建立的 bucket 名稱為 _Trace。如要瞭解觀測值區的結構，請參閱Bucket。
資料集
資料集是儲存空間實體。每個資料集都是可觀測性 bucket 的子項。系統為 Google Cloud 服務建立可觀測性儲存空間時，也會建立一個資料集。舉例來說，系統建立 _Trace 值區後，會建立名為 Spans 的資料集。該資料集會儲存追蹤資料。如要瞭解資料集的結構，請參閱 Dataset。
資料集檢視畫面
每個資料集會代管一或多個檢視區塊。檢視表可提供資料集中部分項目的讀取權限。建立資料集時，系統會自動建立一個檢視畫面。該檢視區塊包含資料集中的所有資料。 檢視畫面名稱會因服務而異。舉例來說，如果是 Cloud Trace 服務，系統會在 Spans 資料集上建立名為 _AllSpans 的檢視區塊。如要瞭解檢視區塊的結構，請參閱View。
資料集連結

每個資料集最多只能包含一個連結。建立資料集的連結時，系統會建立連結的 BigQuery 資料集。接著，您可以使用 BigQuery 或其他使用 BigQuery API 的服務，查詢資料集中的資料。如要瞭解連結的結構，請參閱 Link。

系統不會自動建立資料集的連結。

追蹤資料的儲存空間設定

追蹤資料會儲存在名為 _Trace 的可觀測性 bucket 中。系統會在該值區中建立名為 Spans 的資料集。系統會在該資料集上建立名為 _AllSpans 的檢視區塊。這個檢視畫面包含資料集中的所有資料。

如果值區不存在，且符合下列任一條件，系統會嘗試建立名為 _Trace 的值區：

  • 應用程式會使用 Cloud Trace API 或 Telemetry API，將追蹤資料傳送至您的專案。 Google Cloud

  • 您可以為 Google Cloud 服務啟用 Cloud Trace，然後該服務會將追蹤記錄資料傳送至 Google Cloud 專案。舉例來說，Cloud Service Mesh 支援收集追蹤記錄，但預設會停用追蹤記錄收集功能。如果啟用 Cloud Service Mesh 的追蹤功能，系統就會根據該服務傳送的資料建立 bucket。

    系統不會因為 Cloud Run functions、Cloud Run 和 App Engine 產生的追蹤資料，建立可觀測性 bucket。只有在可觀測性儲存區存在時，系統才會儲存這些服務的範圍。

如要判斷名為 _Trace 的觀測能力 bucket 是否存在，或觸發建立這個 bucket 的流程，請執行下列操作：

  1. 前往 Google Cloud 控制台的 「Trace Explorer」頁面：

    前往「Trace explorer」(Trace 探索工具)

    您也可以透過搜尋列找到這個頁面。

  2. 執行下列其中一個步驟：

    • 如果頁面顯示追蹤資料，就不必採取任何行動。您的Google Cloud 專案包含名為 _Trace 的可觀測性 bucket。

    • 如果頁面顯示下列橫幅，表示您的專案沒有任何追蹤資料，或只有來自 Cloud Run functions、Cloud Run 和 App Engine 的資料。

      Trace storage is not initialized for this project. Enable trace storage to begin collecting trace data.

      如要觸發流程，建立名為 _Trace 的可觀測性 bucket，請前往橫幅並點選「啟用」。

    • 如果頁面顯示下列橫幅，表示名為 _Trace 的可觀測性 bucket 初始化失敗。如果看到這則訊息，請前往橫幅並點選「提交支援單」。

      Initializing trace storage has failed for an unexpected reason. Please file a support ticket for assistance.

限制

你無法執行下列操作：

  • 修改或刪除可觀測性值區。
  • 建立、刪除或修改資料集。
  • 建立、刪除或修改檢視畫面。
  • 使用 Google Cloud 控制台列出 bucket、資料集、檢視區塊或連結。
  • 在 us 以外的位置建立可觀測性值區；可觀測性值區必須位於 us 位置。

後續步驟