本文件說明如何建立及管理追蹤記錄範圍，讓「Trace Explorer」頁面找出您要查看或分析的追蹤記錄時距。如果您只想查看及分析來自 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 開啟「Trace 探索工具」頁面，否則「Trace 探索工具」頁面會搜尋預設追蹤記錄範圍中列出的Google Cloud 專案，以取得追蹤記錄資料。建立專案時，系統會將名為 _Default 的追蹤記錄範圍設為預設追蹤記錄範圍。不過，您可以選取其他追蹤記錄範圍，做為預設的追蹤記錄範圍。
App Hub 應用程式和追蹤範圍
App Hub 應用程式可能會將追蹤資料寫入多個專案。如要取得這類資料的匯總檢視畫面，請建立追蹤記錄範圍，並將其設為列出儲存追蹤記錄資料的所有專案，然後將其設為預設追蹤記錄範圍。完成這些步驟後，「Trace Explorer」頁面會自動顯示應用程式寫入的資料，即使這些資料儲存在不同的專案中也一樣。
在您要查看記錄資料的專案中建立自訂追蹤範圍。這項專案可能是您的 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 專案後，系統會顯示一個帶有「Default」圖示 (
) 的項目，表示這是預設追蹤記錄範圍。Trace 探索工具頁面會在開啟時搜尋預設追蹤記錄範圍中列出的專案，以便取得追蹤記錄資料。
建立追蹤記錄範圍
Trace 探索工具頁面顯示的時距取決於搜尋的專案、您在這些專案中的 IAM 角色、時間範圍設定，以及您套用的篩選器。
您可以為每個專案建立 100 個追蹤範圍。追蹤記錄範圍最多可包含 20 個專案。
如要建立追蹤範圍，請按照下列步驟操作：
-
在 Google Cloud 控制台中，前往 settings「Settings」頁面：
如果您是使用搜尋列尋找這個頁面，請選取子標題為「Monitoring」的結果。
- 在 Google Cloud 控制台的工具列中，選取您的 Google Cloud 專案。如要設定 App Hub，請選取 App Hub 主機專案或啟用應用程式的資料夾管理專案。
- 選取「Trace Scopes」分頁標籤，然後按一下「Create trace scope」。
按一下「新增專案」並完成對話方塊。
新增專案時，該專案中儲存的跨度會納入追蹤範圍。如果您不知道要將哪些專案納入範圍，可以使用舊版 Trace 探索工具頁面來找出這些專案。詳情請參閱本文件的「遷移至追蹤範圍」一節。
在「追蹤範圍名稱」部分中，輸入要顯示在「追蹤範圍」分頁中的名稱和說明。
追蹤記錄範圍的名稱無法修改，且在專案中必須是獨一無二的。
按一下「建立追蹤範圍」。
遷移至追蹤記錄範圍
您必須在「Trace 探索工具」頁面中指定要搜尋追蹤記錄資料的Google Cloud 專案，這與舊版「Trace 探索工具」頁面的行為有所不同。舊版「Trace 探索工具」頁面會搜尋機構中的所有專案。由於這些差異，Trace Explorer 頁面可能不會顯示舊版 Trace Explorer 頁面顯示的跨度。
您可以使用舊版「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「更多」，然後執行下列任一操作：
- 如要修改，請選取「Edit scope」，然後完成對話方塊。
- 如要刪除，請選取「Delete scope」(刪除範圍)，然後完成對話方塊。
限制
Cloud Trace API 或 Google Cloud CLI 不支援建立或管理追蹤範圍。
後續步驟
Cloud Logging 和 Cloud Monitoring 包含類似的結構體，可讓您控管可查看或監控的記錄檔資料或指標資料。如要瞭解這些範圍，請參閱下列文件：