追蹤記錄範圍可讓您在「Trace Explorer」頁面中,搜尋及分析多個專案的 Cloud Trace 資料。如果只想查看及分析源自單一 Google Cloud 專案的 Span,則不需要設定任何追蹤範圍。如要瞭解如何查看追蹤記錄和 Span,請參閱「尋找及探索追蹤記錄」。
關於追蹤記錄範圍
追蹤記錄範圍可讓您匯總查看儲存在多項專案中的追蹤記錄資料。這些範圍是永久性的專案層級資源,會列出檢視畫面;每個檢視畫面都會提供專案儲存的追蹤記錄資料存取權。「Trace Explorer」等頁面會使用追蹤記錄範圍,決定要搜尋資料的位置。不過,這些頁面也會使用您在這些資源上的 Identity and Access Management (IAM) 角色,判斷您是否有權查看找到的資料。
建立追蹤記錄範圍時,您必須提供名稱和專案清單。系統會自動納入每個專案的預設追蹤記錄檢視畫面,路徑為 _Trace/Spans/_AllSpans。路徑欄位 _Trace、Spans 和 _AllSpans 分別代表觀測能力 bucket、儲存資料的資料集,以及資料集的檢視畫面。_AllSpans 檢視畫面可讓您存取專案儲存的所有追蹤記錄資料。
「Trace Explorer」頁面提供選取追蹤記錄範圍的選項。選取後,頁面會搜尋追蹤記錄範圍中列出的檢視畫面,並重新整理顯示畫面。
您也可以複製瀏覽器網址,分享設定好的檢視畫面。網址會對您選取的追蹤記錄範圍和其他頁面設定進行編碼,覆寫開啟連結的使用者預設範圍選項。詳情請參閱「共用追蹤記錄和 span」。
您可以將一個追蹤記錄範圍指定為「預設」。指定後,系統會執行下列操作:
系統會更新觀測能力範圍。這個範圍包含預設記錄範圍和預設追蹤記錄範圍的指標,可協助系統在資料儲存於多項專案時,建立記錄和追蹤記錄資料之間的關聯。詳情請參閱「設定多專案查詢的可觀測性範圍」。
系統會更新「Trace Explorer」頁面自動使用的追蹤記錄範圍,以便搜尋追蹤記錄資料。如果頁面無法存取預設追蹤記錄範圍,就會在專案中搜尋追蹤記錄資料。
您可以修改及刪除自己建立的追蹤範圍。
App Hub 應用程式和追蹤範圍
App Hub 應用程式可能會將追蹤記錄資料寫入多個專案。如要取得這項資料的匯總檢視畫面,請建立追蹤記錄範圍,並將其設為列出所有儲存追蹤記錄資料的專案的預設追蹤記錄檢視畫面,然後將其設為預設追蹤記錄範圍。完成這些步驟後,「Trace Explorer」頁面會自動顯示應用程式寫入的資料,即使資料儲存在不同專案中也一樣。
在您查看追蹤記錄資料的專案中,建立自訂追蹤記錄範圍。這項專案是 App Hub 主專案或管理專案。舉例來說,如果資料夾的顯示名稱為 My Folder,則資料夾管理專案的顯示名稱為 My Folder-mp。
事前準備
設定專案和 IAM 角色,並選取要使用的介面。
設定專案和角色
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
Roles required to select or create a project
- Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
-
Create a project: To create a project, you need the Project Creator role
(
roles/resourcemanager.projectCreator), which contains theresourcemanager.projects.createpermission. Learn how to grant roles.
-
Verify that billing is enabled for your Google Cloud project.
Enable the Observability API, if it is not already enabled.
Roles required to enable APIs
To enable APIs, you need the
serviceusage.services.enablepermission. If you created the project, then you likely already have this permission through the Owner role (roles/owner). Otherwise, you can get this permission through the Service Usage Admin role (roles/serviceusage.serviceUsageAdmin). Learn how to grant roles.-
如要取得建立及查看追蹤記錄範圍所需的權限,請要求管理員授予您專案的觀測能力範圍編輯者 (
roles/observability.scopesEditor) IAM 角色。如要進一步瞭解如何授予角色,請參閱「管理專案、資料夾和組織的存取權」。這個預先定義的角色具備建立及查看追蹤記錄範圍所需的權限。如要查看確切的必要權限,請展開「Required permissions」(必要權限) 部分:
所需權限
必須具備下列權限,才能建立及查看追蹤記錄範圍:
-
observability.traceScopes.{create, delete, get, list, update} -
observability.scopes.{get, update}
-
選取要使用的介面
控制台
使用 Google Cloud 控制台存取 Google Cloud 服務和 API 時,不需要設定驗證機制。
gcloud
安裝 Google Cloud CLI,然後使用聯合身分登入 gcloud CLI。 登入後, 執行下列指令來初始化 Google Cloud CLI:
gcloud initTerraform
如要在本機開發環境中使用本頁的 Terraform 範例,請安裝並初始化 gcloud CLI,然後使用使用者憑證設定應用程式預設憑證。
-
安裝 Google Cloud CLI。
-
設定 gcloud CLI,使用您的聯合身分。
詳情請參閱「使用聯合身分登入 gcloud CLI」。
-
為使用者帳戶建立本機驗證憑證:
gcloud auth application-default login
如果傳回驗證錯誤,請確認您已使用聯合身分登入 gcloud CLI。
詳情請參閱 Google Cloud 驗證說明文件中的「為本機開發環境設定 ADC」。
REST
如要在本機開發環境中使用本頁的 REST API 範例,請使用您提供給 gcloud CLI 的憑證。
安裝 Google Cloud CLI,然後使用聯合身分登入 gcloud CLI。
詳情請參閱 Google Cloud 驗證說明文件中的「使用 REST 進行驗證」一節。
列出追蹤記錄範圍
控制台
如要列出追蹤記錄範圍,請按照下列步驟操作:
-
前往 Google Cloud 控制台的 settings「Settings」(設定) 頁面:
如果您是使用搜尋列尋找這個頁面,請選取子標題為「Monitoring」的結果。
- 在 Google Cloud 控制台的工具列中,選取 Google Cloud 專案。如要設定 App Hub,請選取 App Hub 主專案或管理專案。
選取「Trace Scopes」(追蹤範圍) 分頁標籤。
視窗會顯示追蹤範圍清單。包含「Default」圖示
的項目是預設追蹤記錄範圍。如要查看追蹤記錄範圍的詳細資料,請展開該範圍。
展開追蹤記錄範圍後,即可查看該範圍包含的檢視畫面清單。每列都會列出專案 ID 和
_Trace/Spans/_AllSpans等項目,用於識別追蹤記錄資料的預設儲存位置。_Trace、Spans和_AllSpans欄位是指追蹤記錄資料的可觀測性 bucket、資料集和檢視畫面。_AllSpans檢視畫面會對應到值區中的每個項目:名稱 說明 類型 資源 arrow_right _DefaultTrace scope1arrow_drop_down myscopeMy descriptionTrace scope2_Trace/Spans/_AllSpansmyprojectTrace view_Trace/Spans/_AllSpansproject-bTrace view
gcloud
使用下列任何指令資料前,請先替換以下項目:
- LOCATION:追蹤記錄範圍的位置。這個欄位的值必須為
global。 - PROJECT_ID:專案 ID。
執行 gcloud observability trace-scopes list 指令:
Linux、macOS 或 Cloud Shell
gcloud observability trace-scopes list \ --location=LOCATION --project=PROJECT_ID
Windows (PowerShell)
gcloud observability trace-scopes list ` --location=LOCATION --project=PROJECT_ID
Windows (cmd.exe)
gcloud observability trace-scopes list ^ --location=LOCATION --project=PROJECT_ID
回應資料是追蹤記錄範圍清單。每個範圍都會顯示名稱和相關資訊。舉例來說,以下是針對具有兩個追蹤記錄範圍的專案,執行 list 指令的結果:
name: projects/my-project/locations/global/traceScopes/_Default resourceNames: - projects/my-project --- createTime: '2026-03-26T13:43:54.772326947Z' description: a test name: projects/my-project/locations/global/traceScopes/my-test-scope resourceNames: - projects/another-project - projects/my-project updateTime: '2026-03-26T13:43:54.772326947Z'
Terraform
您可以使用 Terraform 建立及修改追蹤記錄範圍。不過,您無法使用 Terraform 列出追蹤記錄範圍。
REST
如要列出 Google Cloud 專案中的所有追蹤範圍,請使用 projects.locations.traceScopes.list 指令。必須指定路徑參數。
這個端點的路徑參數語法如下:
projects/PROJECT_ID/locations/LOCATION_ID/traceScopes
上述運算式中的欄位含義如下:
- PROJECT_ID:專案 ID。如要設定 App Hub,請選取 App Hub 主專案或管理專案。
- LOCATION_ID 必須設為
global。
回應是 TraceScope 物件陣列。每個物件都包含名稱和資源清單。
如要取得特定追蹤記錄範圍的相關資訊,請使用 projects.locations.traceScopes.get 指令。
建立追蹤記錄範圍
「Trace Explorer」頁面顯示的 span 取決於搜尋的檢視畫面、您在這些檢視畫面中的 IAM 角色、日期範圍設定,以及套用的篩選器。
每項專案最多可建立 100 個追蹤記錄範圍。追蹤記錄範圍總共可包含 200 個檢視畫面。如果建立的追蹤記錄範圍列出超過 10 個檢視畫面,可能會有效能問題。
控制台
如要建立追蹤記錄範圍,請按照下列步驟操作:
-
前往 Google Cloud 控制台的 settings「Settings」(設定) 頁面:
如果您是使用搜尋列尋找這個頁面,請選取子標題為「Monitoring」的結果。
- 在 Google Cloud 控制台的工具列中,選取 Google Cloud 專案。如要設定 App Hub,請選取 App Hub 主專案或管理專案。
- 選取「Trace Scopes」(追蹤記錄範圍) 分頁標籤,然後按一下「Create trace scope」(建立追蹤記錄範圍)。
按一下「Add projects」(新增專案),然後完成對話方塊。
在「Name trace scope」(追蹤記錄範圍名稱) 部分,輸入要在「Trace Scopes」(追蹤記錄範圍) 分頁中顯示的名稱和說明。
追蹤記錄範圍的名稱不得修改,且在專案中不得重複。
按一下「Create trace scope」(建立追蹤記錄範圍)。
根據預設,「Trace scopes」(追蹤範圍) 表格會以收合形式列出追蹤範圍。表格會列出每個範圍的名稱、說明、類型和資源數量。
展開追蹤記錄範圍後,即可查看該範圍包含的檢視畫面清單。每列都會列出專案 ID 和
_Trace/Spans/_AllSpans等項目,用於識別追蹤記錄資料的預設儲存位置。_Trace、Spans和_AllSpans欄位是指追蹤記錄資料的可觀測性 bucket、資料集和檢視畫面。_AllSpans檢視畫面會對應到值區中的每個項目:名稱 說明 類型 資源 arrow_right _DefaultTrace scope1arrow_drop_down myscopeMy descriptionTrace scope2_Trace/Spans/_AllSpansmyprojectTrace view_Trace/Spans/_AllSpansproject-bTrace view
gcloud
使用下列任何指令資料前,請先替換以下項目:
- TRACE_SCOPE_NAME:追蹤記錄範圍的名稱。例如:
my-trace-scope。 - DESCRIPTION:選用。追蹤記錄範圍的說明。 將說明格式設為字串。
- RESOURCE_NAMES:以半形逗號分隔的專案完整名稱清單。例如:
projects/my-project。 - LOCATION:追蹤記錄範圍的位置。這個欄位的值必須為
global。 - PROJECT_ID:專案 ID。
執行 gcloud observability trace-scopes create 指令:
Linux、macOS 或 Cloud Shell
gcloud observability trace-scopes create TRACE_SCOPE_NAME \ --description=DESCRIPTION \ --resource-names=RESOURCE_NAMES \ --location=LOCATION --project=PROJECT_ID
Windows (PowerShell)
gcloud observability trace-scopes create TRACE_SCOPE_NAME ` --description=DESCRIPTION ` --resource-names=RESOURCE_NAMES ` --location=LOCATION --project=PROJECT_ID
Windows (cmd.exe)
gcloud observability trace-scopes create TRACE_SCOPE_NAME ^ --description=DESCRIPTION ^ --resource-names=RESOURCE_NAMES ^ --location=LOCATION --project=PROJECT_ID
如果成功,create 指令的回應會包含新追蹤記錄範圍的名稱:
Created traceScope [my-test-scope].
Terraform
如要瞭解如何套用或移除 Terraform 設定,請參閱「基本 Terraform 指令」。詳情請參閱 Terraform 供應商參考文件。
如要使用 Terraform 在專案中建立追蹤記錄範圍,請使用 Terraform 資源 google_observability_trace_scope。
在指令中設定下列欄位:
project:專案、資料夾或組織的名稱。例如,my-project。如要設定 App Hub,請選取 App Hub 主專案或管理專案。trace_scope_id:設為範圍 ID。例如:my-trace-scope。location:設為"global"。resource_names:專案陣列,每個專案都以完整名稱指定。description:簡短說明。例如「正式環境資源的範圍」。
REST
如要建立追蹤記錄範圍,請使用 projects.locations.traceScopes.create 指令。您必須指定路徑參數,並提供 TraceScope 物件。回應為 TraceScope 物件。
這個端點的路徑參數語法如下:
projects/PROJECT_ID/locations/LOCATION_ID/traceScopes
上述運算式中的欄位含義如下:
- PROJECT_ID:專案 ID。如要設定 App Hub,請選取 App Hub 主專案或管理專案。
- LOCATION_ID 必須設為
global。
修改追蹤記錄範圍
您無法修改名為 _Default 的追蹤記錄範圍。您可以修改所有其他追蹤範圍。
控制台
如要修改追蹤範圍,請按照下列步驟操作:
gcloud
使用下列任何指令資料前,請先替換以下項目:
- TRACE_SCOPE_NAME:追蹤記錄範圍的名稱。例如:
my-trace-scope。 - DESCRIPTION:選用。追蹤記錄範圍的說明。 將說明格式設為字串。
- RESOURCE_NAMES:以半形逗號分隔的專案完整名稱清單。例如
projects/my-project 。 - LOCATION:追蹤記錄範圍的位置。這個欄位的值必須為
global。 - PROJECT_ID:專案 ID。
執行 gcloud observability trace-scopes update 指令:
Linux、macOS 或 Cloud Shell
gcloud observability trace-scopes update TRACE_SCOPE_NAME \ --description=DESCRIPTION \ --resource-names=RESOURCE_NAMES \ --location=LOCATION --project=PROJECT_ID
Windows (PowerShell)
gcloud observability trace-scopes update TRACE_SCOPE_NAME ` --description=DESCRIPTION ` --resource-names=RESOURCE_NAMES ` --location=LOCATION --project=PROJECT_ID
Windows (cmd.exe)
gcloud observability trace-scopes update TRACE_SCOPE_NAME ^ --description=DESCRIPTION ^ --resource-names=RESOURCE_NAMES ^ --location=LOCATION --project=PROJECT_ID
如果成功,update 指令的回應資料會顯示更新後的追蹤記錄範圍:
Updated traceScope [my-test-scope]. createTime: '2026-03-26T13:43:54.772326947Z' description: A scope for testing name: projects/my-project/locations/global/traceScopes/my-test-scope resourceNames: - projects/another-project - projects/my-project updateTime: '2026-03-26T13:48:05.262142872Z'
Terraform
如要瞭解如何套用或移除 Terraform 設定,請參閱「基本 Terraform 指令」。詳情請參閱 Terraform 供應商參考文件。
如要使用 Terraform 修改專案中的追蹤記錄範圍,請使用 Terraform 資源 google_observability_trace_scope。
REST
如要修改追蹤記錄範圍,請使用 projects.locations.traceScopes.patch 指令。您必須指定路徑參數、查詢參數,並提供 TraceScope 物件。查詢參數會指出哪些欄位有所變更。回應為 TraceScope 物件。
這個端點的路徑參數語法如下:
projects/PROJECT_ID/locations/LOCATION_ID/traceScopes/TRACE_SCOPE_NAME
上述運算式中的欄位含義如下:
- PROJECT_ID:專案 ID。如要設定 App Hub,請選取 App Hub 主專案或管理專案。
- LOCATION_ID 必須設為
global。 - TRACE_SCOPE_NAME:追蹤記錄範圍的名稱。例如:
my-trace-scope。
刪除追蹤記錄範圍
您無法刪除名為 _Default 的追蹤記錄範圍。您可以刪除所有其他追蹤範圍。
控制台
如要刪除追蹤記錄範圍,請按照下列步驟操作:
gcloud
使用下列任何指令資料前,請先替換以下項目:
- TRACE_SCOPE_NAME:追蹤記錄範圍的名稱。例如:
my-trace-scope。 - LOCATION:追蹤記錄範圍的位置。這個欄位的值必須為
global。 - PROJECT_ID:專案 ID。
執行 gcloud observability trace-scopes delete 指令:
Linux、macOS 或 Cloud Shell
gcloud observability trace-scopes delete TRACE_SCOPE_NAME \ --location=LOCATION --project=PROJECT_ID
Windows (PowerShell)
gcloud observability trace-scopes delete TRACE_SCOPE_NAME ` --location=LOCATION --project=PROJECT_ID
Windows (cmd.exe)
gcloud observability trace-scopes delete TRACE_SCOPE_NAME ^ --location=LOCATION --project=PROJECT_ID
如果您發出 delete 指令,系統會提示您確認操作。以下是執行範例:
You are about to delete traceScope [my-test-scope] Do you want to continue (Y/n)? Y Deleted traceScope [my-test-scope].
Terraform
如要瞭解如何套用或移除 Terraform 設定,請參閱「基本 Terraform 指令」。詳情請參閱 Terraform 供應商參考文件。
如要使用 Terraform 刪除專案中的追蹤記錄範圍,請使用 Terraform 資源 google_observability_trace_scope。
REST
如要刪除追蹤記錄範圍,請使用 projects.locations.traceScopes.delete 指令。必須指定路徑參數。
這個端點的路徑參數語法如下:
projects/PROJECT_ID/locations/LOCATION_ID/traceScopes/TRACE_SCOPE_NAME
上述運算式中的欄位含義如下:
- PROJECT_ID:專案 ID。如要設定 App Hub,請選取 App Hub 主專案或管理專案。
- LOCATION_ID 必須設為
global。 - TRACE_SCOPE_NAME:追蹤記錄範圍的名稱。例如:
my-trace-scope。
設定預設追蹤記錄範圍
「Trace Explorer」頁面開啟時,會搜尋預設追蹤記錄範圍中列出的檢視,找出追蹤記錄資料。如果無法存取預設範圍,頁面就會在專案中搜尋追蹤記錄資料。這項搜尋等同於在預設資料集上查詢專案的 _AllSpans 檢視表。
建立專案時,系統會建立名為 _Default 的追蹤記錄範圍,並指定為預設追蹤記錄範圍。不過,您可以建立自己的追蹤記錄範圍,並將其指定為預設追蹤記錄範圍。
控制台
如要設定預設追蹤記錄範圍,請按照下列步驟操作:
-
前往 Google Cloud 控制台的 settings「Settings」(設定) 頁面:
如果您是使用搜尋列尋找這個頁面,請選取子標題為「Monitoring」的結果。
- 在 Google Cloud 控制台的工具列中,選取 Google Cloud 專案。如要設定 App Hub,請選取 App Hub 主專案或管理專案。
選取「Trace Scopes」(追蹤範圍) 分頁標籤。
這個分頁會顯示追蹤記錄範圍,並提供建立自訂追蹤記錄範圍的按鈕。顯示「Default」(預設) 圖示
的追蹤記錄範圍,就是目前的預設追蹤記錄範圍。如要變更預設追蹤範圍,請找出要指定為預設追蹤範圍的追蹤範圍,按一下其 more_vert「More」(更多),然後選取「Set as default」(設為預設)。
您選取的追蹤記錄範圍會顯示「Default」圖示
。
gcloud
如要查看及更新觀測能力範圍,請按照下列步驟操作:
如要查看觀測能力範圍的設定,請執行
gcloud observability scopes describe指令。使用下列任何指令資料前,請先替換以下項目:
- OBSERVABILITY_SCOPE_ID:
Scope物件的名稱。這個值必須設為_Default。 - LOCATION:位置欄位必須設為
global。 - PROJECT_ID:專案 ID。
執行
gcloud observability scopes describe指令:Linux、macOS 或 Cloud Shell
gcloud observability scopes describe OBSERVABILITY_SCOPE_ID \ --location=LOCATION\ --project=PROJECT_ID
Windows (PowerShell)
gcloud observability scopes describe OBSERVABILITY_SCOPE_ID ` --location=LOCATION` --project=PROJECT_ID
Windows (cmd.exe)
gcloud observability scopes describe OBSERVABILITY_SCOPE_ID ^ --location=LOCATION^ --project=PROJECT_ID
指令的回應類似以下內容:
logScope: logging.googleapis.com/projects/my-project/locations/global/logScopes/_Default traceScope: projects/my-project/locations/global/traceScopes/_Default name: projects/my-project/locations/global/scopes/_Default
- OBSERVABILITY_SCOPE_ID:
如要更新觀測能力範圍,請執行
gcloud observability scopes update指令。在update指令中,您可以加入--log-scope旗標、--trace-scope旗標,或同時加入這兩個旗標。使用下列任何指令資料前,請先替換以下項目:
- OBSERVABILITY_SCOPE_ID:
Scope物件的名稱。這個值必須設為_Default。 - LOG_SCOPE_FQN_ID:記錄範圍的完整資源名稱。這個欄位的格式如下:
logging.googleapis.com/projects/PROJECT_ID/locations/LOCATION/logScopes/LOG_SCOPE_ID
在上述運算式中,LOG_SCOPE_ID 是記錄範圍的 ID。例如:
my-scope。 - TRACE_SCOPE_FQN_ID:追蹤記錄範圍的完整資源名稱。這個欄位的格式如下:
projects/PROJECT_ID/locations/LOCATION/traceScopes/TRACE_SCOPE_NAME
在上述運算式中,TRACE_SCOPE_NAME 是追蹤記錄範圍的名稱。例如:
my-trace-scope。 - LOCATION:位置欄位必須設為
global。 - PROJECT_ID:專案 ID。
執行
gcloud observability scopes update指令:Linux、macOS 或 Cloud Shell
gcloud observability scopes update OBSERVABILITY_SCOPE_ID \ --log-scope=LOG_SCOPE_FQN_ID\ --trace-scope=TRACE_SCOPE_FQN_ID\ --location=LOCATION\ --project=PROJECT_ID
Windows (PowerShell)
gcloud observability scopes update OBSERVABILITY_SCOPE_ID ` --log-scope=LOG_SCOPE_FQN_ID` --trace-scope=TRACE_SCOPE_FQN_ID` --location=LOCATION` --project=PROJECT_ID
Windows (cmd.exe)
gcloud observability scopes update OBSERVABILITY_SCOPE_ID ^ --log-scope=LOG_SCOPE_FQN_ID^ --trace-scope=TRACE_SCOPE_FQN_ID^ --location=LOCATION^ --project=PROJECT_ID
舉例來說,如果 LOG_SCOPE_ID 的值為
my-log-scope,TRACE_SCOPE_NAME 的值為my-trace-scope,則回應會類似下列內容:Updated scope [_Default]. logScope: logging.googleapis.com/projects/my-project/locations/global/logScopes/my-log-scope traceScope: projects/my-project/locations/global/traceScopes/my-trace-scope name: projects/my-project/locations/global/scopes/_Default
- OBSERVABILITY_SCOPE_ID:
Terraform
您可以使用 Terraform 建立及修改追蹤記錄範圍。不過,您無法使用 Terraform 設定預設追蹤記錄範圍。
REST
如要透過 API 呼叫取得及設定預設記錄範圍或預設追蹤記錄範圍,請設定觀測能力範圍。觀測能力範圍會列出預設記錄範圍和預設追蹤記錄範圍:
- 如要取得專案的預設觀測能力範圍,請向
projects.locations.scopes.get端點傳送要求。您必須指定路徑參數。回應是Scope物件,會列出預設記錄範圍和預設追蹤記錄範圍。 - 如要更新專案的預設觀測能力範圍,請向
projects.locations.scopes.patch端點傳送要求。您必須指定路徑參數、查詢參數,並提供Scope物件。查詢參數會指出哪些欄位有所變更。回應為Scope物件。
這兩個端點的路徑參數格式如下:
projects/PROJECT_ID/locations/LOCATION/scopes/OBSERVABILITY_SCOPE_ID
上述運算式中的欄位含義如下:
- PROJECT_ID:專案 ID。如要設定 App Hub,請選取 App Hub 主專案或管理專案。
- LOCATION:位置欄位必須設為
global。 - OBSERVABILITY_SCOPE_ID:
Scope物件的名稱。這個欄位必須設為_Default。系統會自動建立名為_Default的Scope物件,用於儲存預設記錄範圍和預設追蹤記錄範圍的相關資訊。
如要將指令傳送至 API 端點,您可以使用 APIs Explorer,從參考頁面發出指令。舉例來說,如要取得目前的預設範圍,可以執行下列操作:
- 按一下 [
projects.locations.scopes.get]。 - 在「Try this method」(試用這個方法) 小工具的「name」欄位中,輸入下列內容:
projects/PROJECT_ID/locations/global/scopes/_Default複製前一個欄位前,請將 PROJECT_ID 替換為專案名稱。
- 選取「執行」。
- 在授權對話方塊中,完成必要步驟。
回應大致如下:
{ "name": "projects/my-project/locations/global/scopes/_Default", "logScope": "logging.googleapis.com/projects/my-project/locations/global/logScopes/_Default" "traceScope": "projects/my-project/locations/global/traceScopes/_Default" }
追蹤記錄範圍限制
| 追蹤記錄範圍限制 | 值 |
|---|---|
| 每項專案的追蹤記錄範圍數量上限 | 100 |
| 每個追蹤記錄範圍的檢視畫面數量上限 | 200 |
為達到最佳效能,請將追蹤記錄範圍內的檢視表數量限制為 10 個。