如要查看追蹤記錄資料的匯總表示方式，或找出並探索個別追蹤記錄或包含特定標籤的追蹤記錄，請使用「Trace 探索工具」頁面。
這項功能僅支援 Google Cloud 專案。如要設定 App Hub，請選取 App Hub 主機專案或已啟用應用程式的資料夾管理專案。
關於「Trace Explorer」頁面
為協助您找出追蹤記錄資料中的趨勢和模式，系統會匯總延遲資料並顯示在圖表中。熱圖是預設的視覺化效果，會使用顏色代表單元格中的跨距數量。顯示多個跨度的儲存格會比顯示少個跨度的儲存格使用較深的顏色。您可以選取儲存格或啟用儲存格的工具提示，以取得更多資訊。其他圖表可讓您以百分比和跨距率資訊查看延遲時間。對於所有圖表，您可以使用指標展開 x 軸。對於折線圖，您可以展開 X 軸和 Y 軸。
在調查問題時，您可能會想查看特定追蹤記錄，或只查看具有特定屬性的時距：
知道追蹤記錄 ID 後，請在工具列中依序點選「pageview」「Search for trace」，然後在對話方塊中輸入追蹤記錄 ID。接著，您可以在追蹤記錄中搜尋關鍵字的跨距和屬性 。
查看匯總資料時，您可以套用篩選器來搜尋特定區間。舉例來說，您可以篩選資料，只顯示特定服務的跨度。接著，您可以新增第二個篩選器，將顯示範圍限制為回報錯誤的特定服務。
表格資料可讓您查看個別跨度的詳細資料，並協助找出異常值。舉例來說，如要找出延遲值最高的跨距，請選取「跨距」分頁，然後依延遲值排序資料。如要找出產生錯誤的服務，請依據時距狀態篩選資料，然後選取「分組」分頁，這會顯示依時距和服務名稱匯總的資料。表格中的每個資料列都包含詳細資訊的連結。
「Trace Explorer」頁面顯示的追蹤記錄資料取決於下列因素：
- 搜尋追蹤記錄資料的專案。根據預設，系統只會搜尋由專案挑選工具選取的專案追蹤資料。不過，您可以將頁面設為搜尋追蹤記錄範圍中的專案清單。
- 您在搜尋的專案中擁有的身分與存取權管理 (IAM) 權限。如果您沒有查看專案追蹤記錄資料的權限， Google Cloud 控制台會顯示警告訊息，且不會顯示該專案的資料。
- 時間範圍設定。
- 您套用的篩選器。
本頁的其餘部分會進一步說明如何尋找及探索追蹤記錄資料。
事前準備
如要取得使用 Google Cloud 主控台查看追蹤記錄資料，以及選取或設定追蹤範圍所需的權限，請要求管理員為您授予專案的 Cloud Trace 使用者 (roles/cloudtrace.user) 身分與存取權管理角色。如要進一步瞭解如何授予角色，請參閱「管理專案、資料夾和機構的存取權」。
這個預先定義的角色包含使用 Google Cloud 控制台查看追蹤記錄資料，以及選取或設定追蹤記錄範圍所需的權限。如要查看確切的必要權限，請展開「必要權限」部分：
所需權限
您必須具備下列權限，才能使用 Google Cloud 主控台查看或選取追蹤範圍：
-
如要選取追蹤記錄範圍，請按照下列步驟操作：
cloudtrace.traceScopes.[get, list] -
如要讀取預設追蹤記錄範圍，請按照下列步驟操作：
observability.scopes.get
如要進一步瞭解角色，請參閱「使用身分與存取權管理功能控管存取權」。
查看匯總的追蹤記錄資料
如要查看追蹤記錄資料的匯總資訊，請按照下列步驟操作：
-
前往 Google Cloud 控制台的「Trace Explorer」頁面：
您也可以透過搜尋列找到這個頁面。
將第一個追蹤資料寫入 Google Cloud 專案後，可能需要幾分鐘的時間，才能查看該資料。如果等待幾分鐘後，仍沒有看到任何追蹤記錄資料，則您的專案可能沒有任何可顯示的資料，或是可能有設定問題。如要瞭解如何解決這些問題，請參閱「排解問題：追蹤記錄介面中沒有資料」一文。
在 Google Cloud 控制台的工具列中，選取您的 Google Cloud 專案。如要設定 App Hub，請選取 App Hub 主機專案或已啟用應用程式的資料夾管理專案。
選用步驟：使用「範圍」元素設定要搜尋哪些專案的追蹤記錄資料：
如要顯示儲存在專案中的追蹤記錄資料，請將「範圍」元素的第一個選單設為
「專案」或 
「_Default」。這兩個設定是等價的。如要顯示儲存在多個專案中的追蹤記錄資料，請展開「Scope」元素的第一個選單，選取「Trace scope」，然後選取列出這些專案的追蹤記錄範圍。選取後，「範圍」選單會顯示追蹤記錄範圍圖示
，以及所選追蹤記錄範圍的名稱。
傳回的資料取決於您在搜尋專案中的 IAM 角色。舉例來說，搜尋的專案包含您沒有存取權的 Google Cloud 專案，則系統不會傳回該專案的追蹤記錄資料。
詳情請參閱「建立及管理追蹤範圍」。
選用步驟：使用時間範圍選取器或使用游標在 x 軸上醒目顯示範圍，更新時間範圍。
舉例來說，如果您想查看延遲資料是否有任何趨勢，可以將這個選擇器設為「最近 2 週」。
前往工具列，將時間範圍選取器設為至少兩週。跨區資料會儲存 30 天。
探索圖表，瞭解追蹤記錄資料中的模式和趨勢：
如要取得時距延遲資料的相關資訊，請將「圖表檢視」選單設為「時距長度 (熱圖)」。顏色濃度與時距數成正比。如要取得單元格的相關資訊，請使用指標。工具提示會顯示跨度的數量、日期和時間，以及儲存格時間間隔。
如要查看延遲時間趨勢，請將「圖表檢視」選單設為「Span 時間長度 (百分位數)」。時間長度圖表會顯示第 50、90、95 和 99 個百分位數。
如要以時間為函數查看回應狀態，請將「圖表檢視」選單設為「間隔率」。這張圖表會顯示傳送至專案的時距速率。
在「Spans」分頁中，您可以探索列出個別時距的表格資料，以及在「Grouped」分頁中，按照服務和名稱分組的時距。
表格中的每個資料列都會顯示時距或分組，以及連結至詳細資訊和部分指標。舉例來說，在「Grouped」分頁中，指標包括錯誤率和群組中的跨度數量。
如要找出異常值，請選取資料欄標題來排序表格。
新增篩選器來限制要顯示哪些時距。如要進一步瞭解如何篩選追蹤記錄資料，請參閱下一節。
篩選追蹤記錄資料
如要只顯示您感興趣的資訊，請套用篩選器。篩選器可限制顯示的資料。例如，您可以依服務名稱和狀態篩選。
新增或移除篩選器時，Trace Explorer 頁面會重新整理顯示的資料，並只顯示符合所有套用篩選器的區間。
如要變更篩選器設定，您可以使用「Span 篩選器」面板或「篩選器」列。
套用跨度篩選器
「Span filters」窗格會列出最常用的篩選器。您可以從任何子類別中選取多個項目。新增或移除篩選器時，篩選器列也會隨之更新。
- 服務名稱：此篩選器會套用至 span 的
service.name屬性 (如果有的話)。如未設定該屬性，且時距來自 App Engine，則篩選器會套用至 App Engine 服務名稱。 - Span kind：說明 span 之間的關係。如要瞭解這些值，請參閱 OpenTelemetry SpanKind 說明文件。
- 時距狀態：要求狀態。如需這些值的相關資訊，請參閱 OpenTelemetry SpanStatus 說明文件。
- Span name：時距名稱。
如果您想依「Span filters」窗格中未列出的屬性篩選，請使用「Filter」列。
使用篩選列
您可以使用「篩選」列，套用預先定義的篩選鍵和所選值，也可以同時輸入鍵和值。
如要新增篩選器，請選取「新增篩選器」，然後執行下列其中一項操作：
- 選取已定義的鍵 (例如「Span name」)，然後從次要選單中選取值。
- 選取「新增屬性篩選器」，然後新增自訂鍵和值。舉例來說，如果您將鍵設為
/http/status_code，而值設為200，則篩選器為/http/status_code: 200。如要讓篩選器比對任何值，請選取「任意值」。
依 ID 尋找追蹤記錄
排解事件或失敗問題時，您可能會知道追蹤 ID。如要探索該追蹤記錄，請按照下列步驟操作：
-
前往 Google Cloud 控制台的「Trace Explorer」頁面：
您也可以透過搜尋列找到這個頁面。
- 在 Google Cloud 控制台的工具列中，選取您的 Google Cloud 專案。如要設定 App Hub，請選取 App Hub 主機專案或已啟用應用程式的資料夾管理專案。
前往工具列，依序點選「pageview」「Search for trace」，然後輸入追蹤 ID。
輸入有效的 ID 後，畫面上會彈出「Details」彈出式視窗，顯示追蹤記錄及其時距的相關資訊。您可以使用該窗格中的選項探索追蹤記錄。舉例來說，您可以搜尋關鍵字的區間。
探索追蹤記錄
如要查看追蹤記錄或跨距，請按照下列步驟操作：
-
前往 Google Cloud 控制台的「Trace Explorer」頁面：
您也可以透過搜尋列找到這個頁面。
將第一個追蹤資料寫入 Google Cloud 專案後，可能需要幾分鐘的時間，才能查看該資料。如果等待幾分鐘後，仍沒有看到任何追蹤記錄資料，則您的專案可能沒有任何可顯示的資料，或是可能有設定問題。如要進一步瞭解如何解決這些問題，請參閱「排解問題：追蹤記錄介面中沒有資料」一文。
在 Google Cloud 控制台的工具列中，選取您的 Google Cloud 專案。如要設定 App Hub，請選取 App Hub 主機專案或已啟用應用程式的資料夾管理專案。
執行下列其中一個步驟：
前往「Trace Explorer」頁面的表格區段，然後從列出跨度的表格中選取項目，或在依服務和跨度名稱分組資料後，選取列出摘要資訊的項目。
前往「Trace Explorer」頁面的工具列，依序點選「pageview」「Search for trace」，然後輸入「trace ID」。
「Details」彈出式視窗隨即開啟，並顯示追蹤記錄及其時距：
- 「名稱」欄會顯示呼叫階層，而第一個項目會包含追蹤 ID。
- 在設定 OpenTelemetry 屬性
service.name時，系統會從該屬性中擷取「Service」欄。如未設定該項屬性，而且服務是在 App Engine 運作，則會顯示 App Engine 服務名稱。否則，系統不會指定任何服務。 - 延遲列的長度代表延遲值。
- 延遲時間列的顏色代表狀態。藍色延遲列表示完成作業，紅色延遲列則表示發生錯誤。
- 延遲時間長條上的圓圈表示記錄項目或事件與跨度相關聯。如要變更這項行為，請使用「記錄檔和事件」選單。
選用步驟：使用「Find in Trace」欄位搜尋追蹤記錄中的跨度名稱、服務名稱和屬性。
舉例來說，如果您輸入
GET，系統會醒目顯示 span 名稱、服務名稱或「Attributes」窗格中顯示GET的文字，並忽略大小寫。您無法使用規則運算式進行搜尋，也無法搜尋記錄、事件或中繼資料。
如要查看特定跨度的詳細資料，請選取跨度，然後查看其屬性和事件。詳情請參閱下一節。
查看屬性和事件
本節說明如何查看標籤、記錄和事件。
查看標籤
如要查看附加至時距的標籤，請前往「Attributes」分頁。如要瞭解標籤，請參閱「追蹤標籤」。
查看記錄檔和事件
如要查看與時距相關的記錄和事件，請前往「Logs & Events」分頁。
如要查看記錄項目，請按一下 keyboard_arrow_down「顯示更多」。
您也可以選取「查看記錄」按鈕，開啟「記錄探索器」頁面，並將查詢集設定為篩選特定追蹤、間隔和時間範圍。這項查詢可能不會傳回任何記錄項目。
查看生成式 AI 事件
如要查看與生成式 AI 代理相關的事件，請使用「GenAI」GenAI分頁。當傳送至 Trace 的時距符合 生成式 AI 系統的 OpenTelemetry 語意慣例時，這個分頁就會顯示，這會產生名稱開頭為 gen_ai 的訊息。
下列螢幕截圖顯示「Trace Explorer」頁面如何轉譯生成式 AI 事件：
如要瞭解產生上述螢幕截圖的範例應用程式，請參閱「使用 OpenTelemetry 檢測 LangGraph ReAct Agent」。
屬性是用來描述某些特徵的鍵/值組合。以下是生成式 AI 系統的屬性範例：
gen_ai.system：識別提供生成式 AI 功能的系統。gen_ai.request.model：指出要求要傳送至哪個模型。
名稱開頭為「gen_ai」的事件，通常會描述生成式 AI 系統的個別輸入或輸出內容。這些輸入和輸出內容包括系統和使用者提示、工具輸入和輸出內容，以及模型回應。以下是生成式 AI 系統的事件範例：
gen_ai.system.message：記錄系統向生成式 AI 模型傳送的提示事件。系統提示會向模型提供指示，這些指示通常不會顯示給使用者，而是引導模型解讀使用者提示。gen_ai.user.message：記錄使用者提供的提示，並將其傳送至模型的事件。gen_ai.assistant.message：記錄模型輸出的事件，可包含工具叫用記錄，或可能包含文字回應輸出內容。訊息可能包含應用程式未使用的候選回覆。gen_ai.choice：用於回報應用程式使用的候選輸出內容。
查看堆疊追蹤
如要查看堆疊追蹤記錄，請使用「堆疊追蹤記錄」分頁標籤。
查看一般資訊和其他中繼資料
如要查看跨度的一般資訊，以及其他跨度的連結表格，請查看「中繼資料與連結」分頁標籤。這項資訊包括：
- 跨度 ID：跨度 ID 是 0 以外的 64 位元整數。詳情請參閱
TraceSpan。 - 父項時距 ID
- 專案 ID
- 開始時間和結束時間
- 列出其他區間連結的表格
名為「Links」的資料表中，每列都會列出目前跨度與其他跨度之間的連結。「Attributes」欄位會列出連結的區間的鍵/值組合。「Trace」Trace欄位會連結至已連結區間的追蹤記錄。如果這個欄位包含「Current trace」，則連結的區間會與目前區間位於相同追蹤記錄中。否則，欄位會包含追蹤記錄 ID。如需連結的相關資訊，請參閱 Links API 參考資料頁面。
查看趨勢
在應用程式上部署更新後，您可能會想判斷更新是否影響回應延遲時間。您可以設定時間範圍選取器，這樣就能查看延遲資料的趨勢，並在升級前後顯示延遲資料。
如要查看追蹤記錄資料的趨勢，請按照下列步驟操作：
-
前往 Google Cloud 控制台的「Trace Explorer」頁面：
您也可以透過搜尋列找到這個頁面。
- 在 Google Cloud 控制台的工具列中，選取您的 Google Cloud 專案。如要設定 App Hub，請選取 App Hub 主機專案或已啟用應用程式的資料夾管理專案。
- 選用步驟：新增篩選器來設定要顯示哪些時距。
- 前往工具列，將時間範圍選取器設為至少兩週。Span 資料會保存 30 天。
- 選用：變更「圖表檢視」選單的選項。