本文說明如何建立及管理追蹤範圍，讓「追蹤記錄探索器」頁面找出您想查看或分析的追蹤記錄時距。如果您只想查看及分析源自 Google Cloud 專案的範圍，則不需要設定任何追蹤範圍。不過，如果您的追蹤資料儲存在多個專案中 (使用微服務架構時可能會發生這種情況)，您需要執行一些設定活動，才能從單一 Google Cloud 專案查看所有範圍。
本文不會說明如何查看追蹤記錄和範圍。 如要瞭解該主題，請參閱「尋找及探索追蹤記錄」。
這項功能僅支援 Google Cloud 專案。 如要進行 App Hub 設定，請選取 App Hub 主專案或已啟用應用程式的資料夾管理專案。
關於追蹤記錄範圍
追蹤記錄範圍是專案層級的永久資源，會列出一組 Google Cloud 專案。您可以將「Trace 探索工具」頁面設為依追蹤記錄範圍搜尋，也就是說，該頁面會搜尋所選範圍中列出的專案。系統會根據您在搜尋專案中的 Identity and Access Management (IAM) 角色和時間範圍設定，從儲存空間擷取並顯示資料。
建立 Google Cloud 專案時，系統會建立名為 _Default的追蹤記錄範圍。這個範圍只包含 Google Cloud 專案。您無法在這個範圍中新增專案，也無法刪除這個範圍。
您可以建立追蹤範圍，也可以修改及刪除您建立的任何追蹤範圍。如果服務會將範圍資料寫入多個 Google Cloud 專案，您就會想建立追蹤記錄範圍。
除非您使用包含追蹤記錄範圍或追蹤記錄和範圍 ID 的網址開啟「追蹤記錄探索工具」頁面，否則「追蹤記錄探索工具」頁面會搜尋預設追蹤記錄範圍中列出的Google Cloud 專案，找出追蹤記錄資料。建立專案時，系統會將名為 _Default 的追蹤記錄範圍設為預設追蹤記錄範圍。不過，您可以選取其他追蹤記錄範圍，做為預設追蹤記錄範圍。
App Hub 應用程式和追蹤範圍
您的 App Hub 應用程式可能會將追蹤資料寫入多個專案。如要取得這類資料的匯總檢視畫面，請建立追蹤記錄範圍，將其設為列出所有儲存追蹤記錄資料的專案，然後將其設為預設追蹤記錄範圍。完成這些步驟後，「追蹤記錄探索工具」頁面就會自動顯示應用程式寫入的資料，即使這些資料儲存在不同專案中也沒問題。
在您要查看記錄資料的專案中，建立自訂追蹤範圍。這個專案是您的 App Hub 主專案，或是已啟用應用程式的資料夾的管理專案。舉例來說，如果資料夾的顯示名稱是 My Folder，管理專案的顯示名稱就是 My Folder-mp。
事前準備
如要取得建立及查看追蹤範圍，以及設定預設追蹤範圍所需的權限，請管理員授予下列 IAM 角色：
-
如要建立及查看追蹤範圍，並取得預設追蹤範圍，請在專案中指派 Cloud Trace 使用者 (
roles/cloudtrace.user) 角色。 -
如要設定預設追蹤範圍，請按照下列步驟操作：
在專案中開啟可觀測性編輯器 (
roles/observability.editor)
如要進一步瞭解如何授予角色，請參閱「管理專案、資料夾和機構的存取權」。
這些預先定義的角色具備建立及查看追蹤範圍，以及設定預設追蹤範圍所需的權限。如要查看確切的必要權限，請展開「必要權限」部分：
所需權限
如要建立及查看追蹤範圍，並設定預設追蹤範圍，必須具備下列權限：
-
如何建立及管理追蹤記錄範圍：
cloudtrace.traceScopes.[create, delete, get, list, update] -
如要設定預設追蹤記錄範圍，請按照下列步驟操作：
observability.scopes.[get, update]
列出追蹤記錄範圍
如要列出追蹤範圍，請執行下列操作：
-
前往 Google Cloud 控制台的 settings「Settings」(設定) 頁面：
如果您是使用搜尋列尋找這個頁面，請選取子標題為「Monitoring」的結果。
- 在 Google Cloud 控制台的工具列中，選取您的 Google Cloud 專案。如要進行 App Hub 設定，請選取 App Hub 主專案或已啟用應用程式的資料夾管理專案。
選取「追蹤範圍」分頁標籤。
表格會列出追蹤範圍。 選取專案後，系統會顯示一個含有「預設」圖示 Google Cloud 的項目，
表示這是預設追蹤記錄範圍。開啟「追蹤記錄探索工具」頁面時，系統會搜尋預設追蹤記錄範圍中列出的專案，找出追蹤記錄資料。
建立追蹤記錄範圍
追蹤記錄探索工具頁面顯示的時距取決於搜尋的專案、您在這些專案中的 IAM 角色、時間範圍設定，以及您套用的篩選條件。
每個專案最多可建立 100 個追蹤範圍。追蹤記錄範圍最多可包含 20 個專案。
如要建立追蹤範圍，請按照下列步驟操作：
-
前往 Google Cloud 控制台的 settings「Settings」(設定) 頁面：
如果您是使用搜尋列尋找這個頁面，請選取子標題為「Monitoring」的結果。
- 在 Google Cloud 控制台的工具列中，選取您的 Google Cloud 專案。如要進行 App Hub 設定，請選取 App Hub 主專案或已啟用應用程式的資料夾管理專案。
- 選取「追蹤範圍」分頁標籤，然後按一下「建立追蹤範圍」。
按一下「新增專案」並完成對話方塊。
新增專案後，該專案中儲存的範圍就會納入追蹤範圍。如果您不知道要在範圍中納入哪些專案，可以使用舊版 Trace 探索工具頁面找出這些專案。詳情請參閱本文的「遷移至追蹤範圍」一節。
在「Name trace scope」(命名追蹤範圍) 部分中，輸入要在「Trace Scopes」(追蹤範圍) 分頁中顯示的名稱和說明。
追蹤記錄範圍名稱無法修改，且在專案中不得重複。
按一下「建立追蹤範圍」。
遷移至追蹤記錄範圍
「Trace 探索工具」頁面需要您指定要搜尋追蹤記錄資料的Google Cloud 專案，這是與舊版「Trace 探索工具」頁面不同的行為。 舊版「Trace 探索工具」頁面會搜尋機構中的所有專案。由於這些差異，追蹤記錄探索工具頁面可能不會顯示舊版追蹤記錄探索工具頁面顯示的範圍。
您可以使用舊版「Trace 探索工具」頁面的「追蹤記錄詳細資料」窗格專區，編譯儲存追蹤記錄資料的Google Cloud 專案清單：
前往舊版「Trace Explorer」頁面：
在 Google Cloud 控制台的工具列中，選取您的 Google Cloud 專案。如要進行 App Hub 設定，請選取 App Hub 主專案或已啟用應用程式的資料夾管理專案。
選取追蹤記錄。
你可以嘗試下列做法：
- 在「追蹤記錄 ID」欄位中輸入 ID，即可查看追蹤記錄。
- 新增篩選條件。
在「Trace details」(追蹤記錄詳細資料) 窗格中選取追蹤記錄，然後前往「Projects」(專案) 分頁。
這個分頁會列出儲存追蹤記錄範圍的專案。
如要建立包含所列專案的追蹤記錄範圍，請前往「Projects」分頁的工具列，選取「Create scope with these projects」，然後完成對話方塊。
重複上述步驟，直到編譯專案清單為止。
編譯專案清單後，請建立追蹤記錄範圍。 您也可以將其設為預設追蹤記錄範圍。
設定預設追蹤記錄範圍
「Trace 探索工具」頁面開啟後，會搜尋預設追蹤記錄範圍中列出的專案，找出追蹤記錄資料。如果無法存取該追蹤範圍，系統就會在專案中搜尋追蹤資料。
建立專案時，系統會建立名為 _Default 的追蹤記錄範圍，並將其指定為預設追蹤記錄範圍。不過，您可以建立自己的追蹤範圍，並指定為預設追蹤範圍。
如要設定預設追蹤記錄範圍，請執行下列操作：
-
前往 Google Cloud 控制台的 settings「Settings」(設定) 頁面：
如果您是使用搜尋列尋找這個頁面，請選取子標題為「Monitoring」的結果。
- 在 Google Cloud 控制台的工具列中，選取您的 Google Cloud 專案。如要進行 App Hub 設定，請選取 App Hub 主專案或已啟用應用程式的資料夾管理專案。
- 選取「追蹤範圍」分頁標籤。
找出要設為預設追蹤範圍的追蹤範圍，按一下「更多」more_vert，然後選取「設為預設」。
您選取的追蹤範圍會顯示「預設」圖示
。
修改或刪除追蹤範圍
您無法刪除或修改名為 _Default 的追蹤記錄範圍。您可以修改或刪除所有其他追蹤範圍。
如要修改或刪除追蹤範圍，請按照下列步驟操作：
-
前往 Google Cloud 控制台的 settings「Settings」(設定) 頁面：
如果您是使用搜尋列尋找這個頁面，請選取子標題為「Monitoring」的結果。
- 在 Google Cloud 控制台的工具列中，選取您的 Google Cloud 專案。如要進行 App Hub 設定，請選取 App Hub 主專案或已啟用應用程式的資料夾管理專案。
- 選取「追蹤範圍」分頁標籤。
找出要修改或刪除的追蹤範圍， 按一下「更多」圖示 more_vert，然後執行下列其中一項操作：
- 如要修改，請選取「編輯範圍」，然後完成對話方塊。
- 如要刪除範圍，請選取「刪除範圍」，然後完成對話方塊。
限制
Cloud Trace API 或 Google Cloud CLI 不支援建立或管理追蹤範圍。
後續步驟
Cloud Logging 和 Cloud Monitoring 包含類似的建構函式，可讓您控管可查看或監控的記錄檔資料或指標資料。如要瞭解這些範圍，請參閱下列文件：