追蹤儲存空間總覽

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

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

可觀測性儲存模型

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

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

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

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

追蹤資料的儲存空間設定

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

如果 bucket 不存在，且符合下列任一條件，系統就會嘗試建立名為 _Trace 的可觀測性 bucket：

  • 應用程式會使用 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 探索工具」頁面查看追蹤記錄資料，表示您有名為 _Trace 的觀測能力 bucket。如果沒有看到任何資料，或是看到指出儲存空間未初始化的橫幅，請嘗試下列任一方法：

觀測儲存空間的資料落地機制

如果您有法規遵循或監管規定，必須將資料儲存在特定位置，或使用客戶自行管理的加密金鑰 (CMEK)，建議您同時設定機構政策和可觀測性 bucket 的預設設定。

對於機構、資料夾和專案，可觀測性 bucket 的預設設定可讓您設定下列項目：

  • 預設儲存位置。
  • 每個位置的預設 Cloud Key Management Service 金鑰。

為專案設定後，這些設定只會套用至該專案中建立的新可觀測性 bucket。如果為資料夾或機構設定這些選項，這些設定會套用至在資料夾或機構後代專案中建立的新可觀測性儲存空間，但您已設定預設設定的專案除外。

您也可以使用機構政策，限制新可觀測性值區的位置、要求使用 CMEK，或限制可用於加密的 Cloud KMS 金鑰。如果您設定的機構政策要求使用 CMEK，則必須為可觀測性值區設定預設設定。否則，系統建立的觀測儲存空間將無法完成佈建。

詳情請參閱「設定可觀測性儲存區的預設值」。

限制

你無法執行下列操作：

  • 修改或刪除可觀測性值區。
  • 建立、刪除或修改資料集。
  • 建立、刪除或修改檢視畫面。
  • 使用 Google Cloud 控制台列出 bucket、資料集、檢視區塊或連結。

後續步驟