如要查看追蹤記錄資料的匯總表示法，或找出及探索個別追蹤記錄或含有特定標籤的追蹤記錄，請使用「Trace 探索工具」頁面。
下方的螢幕截圖說明如何顯示追蹤資料：
這項功能僅支援 Google Cloud 專案。 如果是 App Hub 設定，請選取 App Hub 主專案或管理專案。
關於「Trace 探索工具」頁面
為協助您找出追蹤資料中的趨勢和模式，系統會彙整延遲時間資料，並以圖表顯示。熱視圖會使用顏色代表儲存格中的跨度數量。如果儲存格包含許多跨度，顏色會比包含少量跨度的儲存格深。每個儲存格的工具提示都會顯示延遲和其他資訊。 您也可以查看延遲百分位數和範圍速率資訊。
調查問題時，您可能想查看特定追蹤記錄或只查看具有特定屬性的時距：
如要限制要顯示哪些時距，請套用篩選器。舉例來說，您可以依服務、應用程式、錯誤狀態和其他屬性進行篩選。
如要顯示特定追蹤記錄，請使用工具列的「網頁瀏覽」搜尋追蹤記錄選項。
如要找出離群值並查看個別範圍的詳細資料，請使用表格部分：
您可以依據「時間範圍」和「已分組」分頁的「時間長度」標題，排序資料列。
如要瞭解不同服務產生的範圍數量，請使用「已分組」分頁標籤。每一列都對應至服務和時距名稱，並顯示每個項目的延遲統計資料。
如要查看時距或分組的詳細資料，請從表格部分的資料列中選取項目。系統會開啟飛出視窗，顯示追蹤記錄中的跨度。在這個檢視畫面中，您可以探索範圍、屬性，以及查看事件和記錄資料。您也可以在追蹤記錄中搜尋時距和屬性的關鍵字。
「追蹤記錄探索工具」頁面使用的追蹤記錄資料取決於下列因素：
- 搜尋追蹤記錄資料的專案。根據預設，系統只會在專案選擇工具選取的專案中搜尋追蹤記錄資料。不過，您可以設定頁面，在追蹤記錄範圍中搜尋專案清單。
- 您在搜尋專案中的身分與存取權管理 (IAM) 權限。 如果您沒有查看專案追蹤記錄資料的權限， Google Cloud 控制台就會顯示警告訊息，且不會顯示該專案的資料。
- 時間範圍設定。
- 套用的篩選器。
本頁其餘內容將詳細說明如何尋找及探索追蹤資料。
事前準備
如要取得權限，以便使用 Google Cloud 控制台查看追蹤記錄資料，以及選取追蹤記錄範圍，請要求管理員授予專案的 Cloud Trace 使用者 (roles/cloudtrace.user) IAM 角色。如要進一步瞭解如何授予角色，請參閱「管理專案、資料夾和機構的存取權」。
這個預先定義的角色具備使用 Google Cloud 控制台查看追蹤資料，以及選取追蹤範圍所需的權限。如要查看確切的必要權限，請展開「Required permissions」(必要權限) 部分：
所需權限
如要使用 Google Cloud 控制台查看追蹤資料，以及選取追蹤範圍，您必須具備下列權限：
-
如要選取追蹤範圍：
cloudtrace.traceScopes.[get, list] -
如要讀取預設追蹤記錄範圍：
observability.scopes.get
如要進一步瞭解角色，請參閱「使用身分與存取權管理功能控管存取權」一文。
查看匯總追蹤記錄資料
如要查看追蹤記錄資料的匯總資訊，請按照下列步驟操作：
-
前往 Google Cloud 控制台的「Trace Explorer」頁面：
您也可以透過搜尋列找到這個頁面。
首次將追蹤資料寫入 Google Cloud 專案後，可能需要幾分鐘的時間，才能查看該資料。如果等待幾分鐘後，仍沒有看到任何追蹤記錄資料，則可能是專案沒有任何資料可供顯示，或是設定有問題。如要瞭解如何解決這些問題，請參閱「疑難排解：追蹤記錄介面中沒有資料」。
設定「Trace 探索工具」頁面：
- 在 Google Cloud 控制台的工具列中，選取 Google Cloud 專案。如要進行 App Hub 設定，請選取 App Hub 主專案或管理專案。
選用：使用「Scope」元素設定要搜尋追蹤資料的專案：
如要顯示專案中儲存的追蹤資料，請將「範圍」元素的第一個選單設為
「專案」或 
「_Default」。
這兩項設定的作用相同。如要顯示儲存在多個專案中的追蹤資料，請展開「範圍」元素的第一個選單，選取「追蹤範圍」，然後選取列出這些專案的追蹤範圍。選取完成後，「範圍」選單會顯示追蹤記錄範圍圖示
，以及所選追蹤記錄範圍的名稱。
傳回的資料取決於您在搜尋專案中的 IAM 角色。舉例來說，如果搜尋的專案包含您無權存取的 Google Cloud 專案，系統就不會傳回該專案的追蹤資料。
詳情請參閱「建立及管理追蹤範圍」。
選用：使用時間範圍選取器更新時間範圍，或使用指標醒目顯示 X 軸上的範圍。
舉例來說，如果想查看延遲資料是否有任何趨勢，可以將這個選取器設為「過去 2 週」。跨度資料會保存 30 天。
探索熱視圖：
使用顏色找出趨勢和離群值。如果儲存格包含許多跨度，顏色會比包含少量跨度的儲存格深。
使用儲存格的工具提示查看儲存格詳細資料。工具提示會列出跨度數量、日期和時間，以及儲存格的時間間隔。
探索延遲百分位數和錯誤率：
如要查看延遲時間趨勢，請將「圖表檢視」選單設為「範圍時間 (百分位數)」。 持續時間圖表會顯示第 50、90、95 和 99 個百分位數。
如要查看回應狀態隨時間變化的情形，請將「圖表檢視」選單設為「跨度率」。圖表會顯示傳送至專案的時距率。
如要找出離群值，請選取「範圍」分頁，然後依時間長度排序表格。
如要進一步瞭解特定時距，請選取該時距。系統會開啟彈出式視窗，顯示追蹤記錄中的跨度。接著即可探索範圍和追蹤記錄。
如要查看各項服務產生的範圍數量，以及統計資訊，請選取「已分組」分頁標籤：
- 每列代表特定服務和時距名稱。
- 你可以依時間長度標題排序資料列。
如要進一步瞭解特定分組，請選取資料列的 span 名稱。系統會開啟飛出視窗，顯示追蹤記錄中的跨度。接著即可探索範圍和追蹤記錄。
新增篩選器來限制要顯示哪些時距。如要進一步瞭解如何篩選追蹤記錄資料，請參閱下一節。
篩選追蹤記錄資料
如要只顯示感興趣的資訊，請套用篩選器。 篩選器會限制顯示的資料。舉例來說，您可以依服務名稱和狀態篩選。或者，如果您已將應用程式部署至 App Hub，可能只想查看應用程式的追蹤資料，或是應用程式中的特定服務或工作負載。
新增或移除篩選器時，「追蹤記錄探索器」頁面會重新整理，只顯示符合所有已套用篩選器的範圍。
依 ID 篩選追蹤記錄
排解事件或失敗問題時，您可能會知道追蹤 ID。如要探索該追蹤記錄，請前往工具列，依序點選「網頁瀏覽」「搜尋追蹤記錄」，然後輸入追蹤記錄 ID。
輸入有效 ID 後，系統會開啟「詳細資料」飛出視窗，顯示追蹤記錄和時距的相關資訊。您可以使用該窗格中的選項探索追蹤記錄。舉例來說，您可能會搜尋跨度中的關鍵字。
套用時間範圍篩選器
「範圍篩選器」窗格會列出最常用的篩選器。你可以從任何子類別選取多個項目。新增或移除篩選器時，「篩選器」列也會隨之更新。
所有選單的值都是從追蹤資料衍生而來。如果選單包含沒有任何文字的選項，該選項是指不含對應屬性的範圍。
一般情況下，下列範圍篩選器可用：
- OpenTelemetry 服務：依
service.name屬性篩選。 - 時距名稱：時距名稱。
- 時距狀態：要求狀態。如要瞭解這些值，請參閱 OpenTelemetry SpanStatus 說明文件。
- 時間長度：時距長度。
- 範圍種類：說明範圍之間的關係。如要瞭解這些值，請參閱 OpenTelemetry SpanKind 說明文件。
- App Hub 應用程式：依
gcp.apphub.application.id資源屬性篩選。 - App Hub 服務：依
gcp.apphub.service.id資源屬性篩選。 - App Hub 工作負載：依
gcp.apphub.workload.id資源屬性篩選。
如要依「範圍篩選器」窗格中未列出的屬性篩選，請使用「篩選器」列。
使用篩選列
您可以在「篩選」列中套用篩選器，方法是選取預先定義的篩選鍵和值，或是輸入鍵和值。
如要新增篩選器，請選取「新增篩選器」，然後執行下列其中一項操作：
- 選取已定義的鍵，例如「範圍名稱」，然後從次要選單選取值。
選取「新增屬性篩選器」，然後新增自訂鍵和值。 如果輸入自己的篩選器鍵，請使用與範圍屬性鍵相同的語法。
舉例來說，如要依主機 ID 篩選，請將鍵設為
host.id。 同樣地，如要依狀態碼篩選，請將鍵設為/http/status_code。在本情境中，您可以將值設為200，這會產生篩選器/http/status_code: 200。如要讓篩選器比對任何值，請選取「任何值」。
依應用程式篩選
您新增至應用程式的檢測工具所產生的 Trace 時距，可包含下列資源屬性：
gcp.apphub.application.{container,id,location}gcp.apphub.{workload,service}.{criticality_type,environment_type,id}
「追蹤記錄探索工具」頁面包含下列範圍篩選器，這些篩選器的選單會列出已向 App Hub 註冊的應用程式、服務和工作負載：
- App Hub 應用程式：依
gcp.apphub.application.id資源屬性篩選。 - App Hub 服務：依
gcp.apphub.service.id資源屬性篩選。 - App Hub 工作負載：依
gcp.apphub.workload.id資源屬性篩選。
如要瞭解如何檢測應用程式，讓追蹤範圍包含應用程式專屬屬性，請參閱「檢測應用程式監控功能」。
探索追蹤記錄
本節說明如何在追蹤記錄的脈絡中探索範圍：
開啟並設定「Trace Explorer」頁面。如要瞭解這些步驟，請參閱「查看匯總的追蹤資料」。
如要查看範圍或追蹤記錄的詳細資料，請執行下列其中一項操作：
前往「Trace Explorer」頁面的表格區段，然後從表格區段選取項目。你可以按任一表格標題排序表格列。您可以套用篩選器，限制表格顯示的時距。
前往「Trace Explorer」頁面的工具列，依序點選「pageview」「Search for trace」(搜尋追蹤記錄)，然後輸入追蹤記錄 ID。
「詳細資料」彈出式視窗隨即開啟，並顯示追蹤記錄及其時距。系統會顯示所選時距或追蹤記錄的詳細資料：
- 「名稱」欄會顯示呼叫階層，第一個項目包含追蹤 ID。這個資料欄也可能包含註解，指出是否有生成式 AI 事件或記錄資料。
- 如果設定了 OpenTelemetry 屬性
service.name，系統會從該屬性擷取「服務」資料欄。如未設定該項屬性，而且服務是在 App Engine 運作，則會顯示 App Engine 服務名稱。如果非屬上列情況，系統就不會註明服務。 - 延遲時間長條的長度代表延遲時間值。
- 延遲時間長條的顏色代表狀態。藍色延遲時間長條表示成功完成，紅色延遲時間長條則表示發生錯誤。
- 延遲時間長條上的圓圈表示記錄項目或事件與跨度相關聯。如要變更這項行為，請使用「記錄檔和事件」選單。
如要探索追蹤記錄，請執行下列操作：
使用指標選取不同範圍。選取時距後，頁面上的分頁會重新整理，顯示時距的屬性、記錄檔項目和事件。
如要在追蹤記錄中搜尋特定跨度，請使用「在追蹤記錄中尋找」欄位。
搜尋僅適用於時距名稱、服務名稱和屬性欄位。 您只能搜尋純文字，無法搜尋記錄、事件或中繼資料。
舉例來說，如果您輸入
GET，系統就會醒目顯示時距名稱、服務名稱或「屬性」窗格中顯示的GET(忽略大小寫)。
查看屬性、記錄項目和事件
範圍的「詳細資料」彈出式視窗包含下列各項的索引標籤：
屬性：這個分頁會列出附加至範圍的標籤。 如需標籤相關資訊，請參閱「追蹤記錄標籤」。
記錄和事件：這個分頁會列出與所選時距的
trace_id和span_id欄位相符的事件和記錄項目。系統只會顯示您有權查看的記錄項目。如要查看這個分頁中的項目，請按一下「顯示更多」keyboard_arrow_down。
如要使用「記錄檔探索工具」頁面查看記錄檔資料，請按一下「查看記錄」。查詢已設為篩選特定追蹤記錄、範圍和時間範圍。
堆疊追蹤：列出可用的堆疊追蹤。
中繼資料和連結：列出範圍的一般資訊：
「詳細資料」也可能包含標示為「輸入/輸出」的分頁。這個分頁會顯示生成式 AI 事件。
查看生成式 AI 活動
如要查看與生成式 AI 代理相關的事件，請使用「輸入/輸出」分頁標籤。這個分頁會顯示符合 OpenTelemetry GenAI 語意慣例的事件。
系統支援兩種設定：
以文字為基礎的提示和回覆會以屬性的形式附加至 span，這些屬性是鍵/值組合，用於說明某些特徵或事件。舉例來說，鍵
gen_ai.system的值會識別提供生成式 AI 功能的系統。生成式 AI 屬性的鍵會以gen_ai開頭。儲存在 Cloud Storage 值區中的多模態提示和回覆。Cloud Trace 會關聯追蹤和記錄資料，藉此找出這些事件。如要瞭解支援的設定，請參閱「收集及查看多模態提示和回應」。
下列螢幕截圖說明「追蹤記錄探索器」頁面如何顯示附加至範圍的文字生成式 AI 事件：
如要瞭解產生上一個螢幕截圖的範例應用程式，請參閱「使用 OpenTelemetry 檢測 LangGraph ReAct 代理程式」。