檢視追蹤和追蹤詳細資訊 - AWS X-Ray

本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。

檢視追蹤和追蹤詳細資訊

您可以使用 X-Ray 主控台中的「追」頁面,尋找追蹤依據URL、回應代碼或追蹤摘要中的其他資料。從追蹤清單選取追蹤之後,「追蹤詳細資訊」頁面會顯示與所選追蹤相關聯的服務節點對應,以及追蹤區段的時間表。

檢視追蹤

CloudWatch console
若要在 CloudWatch 主控台中檢視追蹤
  1. 登入 AWS Management Console 並開啟 CloudWatch 主控台,位於https://console.aws.amazon.com/cloudwatch/

  2. 在左側導覽窗格中,選擇「X-Ray 繪線」,然後選擇「圖」。您可以依群組篩選或輸入篩選運算式。這會篩選頁面底部「追蹤」區段中顯示的追蹤。

    或者,您可以使用服務對應導覽至特定的服務節點,然後檢視追蹤。這會開啟已套用查詢的 [追蹤] 頁面。

  3. 在「查詢細化器」區段中精簡您的查詢。若要依共用屬性篩選追蹤,請從「精簡查詢依據」旁的向下箭頭選擇選項。選項包括下列項目:

    • 節點 — 依服務節點篩選追蹤。

    • 資源 ARN — 依與追蹤相關聯的資源篩選追蹤。這些資源的範例包括 Amazon 彈性運算雲端 (AmazonEC2) 執行個體、 AWS Lambda 函數或 Amazon DynamoDB 表格。

    • 使用者 — 使用使用者 ID 篩選追蹤。

    • 錯誤根本原因訊息 — 依錯誤根本原因篩選追蹤。

    • URL— 依應用程式使用的URL路徑篩選追蹤。

    • HTTP狀態碼 — 依應用程式傳回的HTTP狀態碼篩選追蹤。您可以指定自訂回應碼,或從下列選項中選取:

      • 200— 請求成功。

      • 401-請求缺少有效的身份驗證憑據。

      • 403-請求缺少有效的權限。

      • 404— 伺服器找不到要求的資源。

      • 500— 伺服器遇到非預期的情況並產生內部錯誤。

    選擇一或多個項目,然後選擇 [新增至查詢] 以新增至頁面頂端的篩選器運算式。

  4. 若要尋找單一追蹤,請直接在查詢欄位中輸入追蹤 ID。您可以使用 X-Ray 格式或萬維網聯盟(W3C)格式。例如,使用發行AWS 版所建立的追蹤 OpenTelemetry是 W3C 格式。

    注意

    當您查詢使用 W3C 格式追蹤識別碼建立的追蹤時,主控台會以 X-Ray 格式顯示相符的追蹤。例如,如果您以 W3C 格式進4efaaf4d1e8720b39541901950019ee5行查詢,則主控台會顯示 X-Ray 對等項目:1-4efaaf4d-1e8720b39541901950019ee5

  5. 選擇「隨時執行查詢」,即可在頁面底端的「追」段落中顯示相符追蹤的清單。

  6. 若要顯示單一追蹤的「追蹤詳細資訊」頁面,請從清單中選取追蹤 ID。

    下圖顯示了一個跟踪映射,其中包含與跟踪相關聯的服務節點和節點之間的邊緣,這些節點表示構成跟踪的段所採取的路徑。追蹤摘要會在追蹤對映之後。摘要包含範例GET作業、其回應碼、追蹤執行所花費的持續時間,以及要求存期間的相關資訊。「區段時間表」遵循「追蹤摘要」,顯示追蹤區段和子區段的持續時間。

    跟踪映射,摘要和段時間表詳細信息有關服務節點和跟踪中的段的信息。

    如果您有使用 Amazon SQS 和 Lambda 的事件導向應用程式,則可以在追蹤對應中查看每個請求的連線追蹤檢視。在地圖中,來自訊息產生者的追蹤會連結至來自 AWS Lambda 消費者的追蹤,並顯示為虛線邊緣。如需事件導向應用程式的詳細資訊,請參閱。追蹤事件導向的應用程式

    和追蹤詳細資料頁面也支援跨帳戶追蹤,可列出來自追蹤清單和單一追蹤對應中多個帳戶的追蹤。

X-Ray console
在 X-Ray 主控台中檢視軌跡
  1. 在 X-Ray 主控台中開啟「追蹤」頁面。追蹤概觀面板會顯示依常見功能 (包括錯誤根本原因資源ARN和) 分組的追蹤清單InstanceId

  2. 若要選取共用特徵來檢視已群組的繪線集合,請展開「群組依據」(Group By) 旁邊的向下箭頭。下圖顯示依據URL分組的繪線的追蹤概觀AWS X-Ray 範例應用,以及關聯軌跡的清單。

    範例追蹤概觀依分組URL,後面接著追蹤清單,其中包含 ID、方法和回應等詳細資料。
  3. 選擇追蹤的 ID,以便在「追蹤」清單下進行檢視。您也可以在導覽窗格中選擇 [服務對應],以檢視特定服務節點的追蹤。然後,您可以檢視與該節點相關聯的追蹤。

    時間軸」索引標籤會顯示追蹤的要求流程,並包含下列項目:

    • 軌跡中每個區段的路徑對映。

    • 區段到達追蹤對應中的節點所花費的時間。

    • 追蹤對應中的節點發出了多少要求。

    圖顯示了與對範例應用程式發出的GET請求相關聯的「追蹤對應」範例。箭頭會顯示每個區段完成要求所採用的路徑。服務節點會顯示GET要求期間發出的要求數目。

    跟踪映射後跟一個帶有段的時間線,它們的持續時間,原點和結束相對於彼此。

    如需有關「時間軸」標籤的詳細資訊,請參閱下面的「探索追蹤時間表」一節。

    原始資料」索引標籤會以JSON格式顯示追蹤的相關資訊,以及構成追蹤的區段和子區段。這些信息可能包括以下內容:

    • 時間戳記

    • 獨特 IDs

    • 與區段或子區段相關聯的資源

    • 段或子段的來源或原點

    • 有關您的應用程序請求的其他信息,例如HTTP請求的響應

探索追蹤時間軸

「時間」區段會在水平列旁顯示區段和子區段的階層,該階層與其完成工作所用的時間相對應。清單中的第一個項目是區段,代表服務為單一請求記錄的所有資料。子區段會縮排並列在區段之後。欄包含每個區段的相關資訊。

CloudWatch console

在 CloudWatch 主控台中,「區段時間軸」提供下列資訊:

  • 第一個資料欄:列出所選追蹤中的區段和子區段。

  • 區段狀態欄:列出每個區段與子區段的狀態結果。

  • 回應代碼」欄:列出區段或子區段所發出之瀏覽器要求的HTTP回應狀態碼 (如果有的話)。

  • 持續時間」欄:列出區段或子區段執行的時間長度。

  • 託管於」欄:列出執行區段或子區段的命名空間或環境 (如果適用)。如需詳細資訊,請參閱收集的維度和維度組合

  • 最後一欄:顯示與區段或子區段執行的持續時間相對應的水平列,相對於時間表中的其他區段或子區段。

若要依服務節點將區段和子區段清單分組,請開啟「依節點分組」。

X-Ray console

在追蹤詳細資訊頁面中,選擇「時間軸」標籤,以查看組成追蹤之每個區段和子區段的時間表。

在 X-Ray 主控台中,時間軸提供下列資訊:

  • 資料欄:列出追蹤中區段和子區段的名稱。

  • Res. 欄:列出區段或子區段所發出之瀏覽器要求的HTTP回應狀態碼 (如果有的話)。

  • 持續時間」欄:列出區段或子區段執行的時間長度。

  • 狀態」欄位:列出區段或子區段狀態的結果。

  • 最後一欄:顯示與區段或子區段執行的持續時間相對應的水平列,相對於時間表中的其他區段或子區段。

若要查看主控台用來產生時間表的原始追蹤資料,請選擇「原始資料」索引標籤。原始資料會顯示追蹤的相關資訊,以及以JSON格式組成追蹤的區段和子區段。這些信息可能包括以下內容:

  • 時間戳記

  • 獨特 IDs

  • 與區段或子區段相關聯的資源

  • 段或子段的來源或原點

  • 關於您的應用程式要求的其他資訊,例如HTTP要求的回應。

當您使用已檢測的 AWS SDKHTTP、或用SQL戶端來呼叫外部資源時,X-Ray 會自動SDK記錄子區段。您也可以使用 X-Ray SDK 來記錄任何函數或程式碼區塊的自訂子區段。開啟自訂子區段時所記錄的其他子區段會成為自訂子區段的子區段。

檢視區段詳細資訊

從追蹤時間軸中,選擇要檢視其詳細資訊的區段名稱。

區段詳細資料」面板會顯示概觀資源註釋中繼資料例外狀況SQL標籤。以下情況適用:

  • Overview (概觀) 標籤會顯示請求及回應的相關資訊。資訊包括名稱、開始時間、結束時間、持續時間、要求URL、要求作業、要求回應碼,以及任何錯誤和錯誤。

  • 區段的「資源」標籤會顯示 X-Ray 的資訊,以SDK及執行應用程式的 AWS 資源相關資訊。使用 Amazon EC2 AWS Elastic Beanstalk、或 Amazon ECS 外掛程式進行 X-Ray SDK 記錄服務特定的資源資訊。如需外掛程式的詳細資訊,請參閱中的服務外掛程式一節設定 Java 的 X-Ray SDK

  • 其餘標籤會顯示為區段記錄的「註釋」、「中繼資料」和「例外」。從已檢測的請求產生例外狀況時,會自動擷取例外狀況。註釋和中繼資料包含您使用 X-Ray SDK 提供的操作所記錄的其他資訊。若要將註解或中繼資料新增至區段,請使用 X-Ray SDK。如需詳細資訊,請參閱使用中檢測您的應用程式下所列的特定語言連結。 AWS X-Ray SDKs 檢測您的應用程式 AWS X-Ray

檢視子區段詳細資訊

在追蹤時間表中,選擇子區段的名稱以檢視其詳細資訊:

  • [概觀] 索引標籤包含要求和回應的相關資訊。這包括名稱、開始時間、結束時間、持續時間、要求URL、要求作業、要求回應碼,以及任何錯誤和錯誤。針對使用受檢測用戶端產生的子區段,Overview (概觀) 標籤包含從您應用程式觀點的請求和回應相關資訊。

  • 子區段的「資源」標籤會顯示用來執行子區段之 AWS 資源的詳細資訊。例如,資源索引標籤可能包含 AWS Lambda 函數ARN、DynamoDB 表的相關資訊、任何呼叫的作業以及請求 ID。

  • 其餘標籤會顯示記錄在子區段上的「註釋」、「中繼資料」和「例外」。從已檢測的請求產生例外狀況時,會自動擷取例外狀況。註釋和中繼資料包含您使用 X-Ray SDK 提供的操作所記錄的其他資訊。使用 X-Ray SDK 將註釋或中繼資料新增至您的區段。如需詳細資訊,請參閱使用中檢測您的應用程式下所列的特定語言連結。 AWS X-Ray SDKs 檢測您的應用程式 AWS X-Ray

針對自訂子區段,Overview (概觀) 標籤會顯示子區段的名稱,您可以設定該名稱來指定其記錄的程式碼或函數區域。如需詳細資訊,請參閱使用中檢測您的應用程式下所列的特定語言連結。 AWS X-Ray SDKs 使用適用於 Java 的 X-Ray 的開發套件

下圖展示了自訂子區段的「概觀」頁籤。概觀包含子區段 ID、父項 ID、名稱、開始和結束時間、持續時間、狀態以及錯誤或錯誤。

有關子區段的概觀資訊,包括 ID、父項 ID、名稱、時間、錯誤和錯誤。

自訂子區段的「中繼資料」標籤包含有關該子區段所使用資源的JSON格式資訊。