

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

# 使用 X-Ray 追蹤映射
<a name="xray-console-servicemap"></a>

檢視 X-Ray 追蹤映射，以識別發生錯誤的服務、具有高延遲的連線，或失敗請求的追蹤。

**注意**  
 CloudWatch 現在包含 [Application Signals](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Application-Monitoring-Sections.html)，可探索和監控您的應用程式服務、用戶端、合成 Canary 和服務相依性。使用 Application Signals 查看服務清單或視覺化地圖，根據您的服務等級目標 (SLO) 檢視運作狀態指標，並深入了解相關的 X-Ray 追蹤以取得更詳細的疑難排解。  
X-Ray 服務映射和 CloudWatch ServiceLens 映射會合併到 Amazon CloudWatch 主控台內的 X-Ray 追蹤映射中。開啟 [CloudWatch 主控台](https://console.aws.amazon.com/cloudwatch/)，然後從左側導覽窗格選擇 **X-Ray 追蹤下的追蹤****地圖**。

## 檢視追蹤映射
<a name="xray-console-servicemap-view"></a>

追蹤映射是應用程式所產生追蹤資料的視覺化呈現。地圖會顯示服務節點，其可處理請求、代表請求來源的上游用戶端節點，以及代表應用程式在處理請求時所使用的 Web 服務和資源的下游服務節點。

追蹤映射會顯示使用 Amazon SQS 和 Lambda 之事件驅動應用程式的追蹤連線檢視。如需詳細資訊，請參閱[追蹤事件驅動的應用程式](xray-tracelinking.md)。追蹤映射也支援[跨帳戶追蹤](xray-console-crossaccount.md)，在單一映射中顯示來自多個帳戶的節點。

------
#### [ CloudWatch console ]

**在 CloudWatch 主控台中檢視追蹤映射**

1. 開啟 [CloudWatch 主控台](https://console.aws.amazon.com/cloudwatch/)。在左側導覽窗格中的 **X-Ray 追蹤區段下，選擇****追蹤地圖**。  
![\[CloudWatch 主控台追蹤映射頁面\]](http://docs.aws.amazon.com/zh_tw/xray/latest/devguide/images/console-servicemap-cw.png)

1. 選擇服務節點來檢視該節點的請求，或是兩個節點間的邊緣來檢視在該連線上進行的請求。

1.  其他資訊會顯示在追蹤映射下方，包括指標、提醒和回應時間分佈的標籤。在**指標**索引標籤上，選取每個圖形內的範圍來向下切入以檢視更多詳細資訊，或選擇**錯誤**或**錯誤**選項來篩選追蹤。在**回應時間分佈**索引標籤上，選取圖形內的範圍，以依回應時間篩選追蹤。  
![\[Dashboard showing latency, requests, and faults metrics for an ElasticBeanstalk environment.\]](http://docs.aws.amazon.com/zh_tw/xray/latest/devguide/images/console-cw-servicemap-node-detail.png)

1. 選擇檢視追蹤來**檢視追蹤**，或者如果已套用篩選條件，請選擇**檢視篩選的追蹤**。

1.  選擇**檢視日誌**以查看與所選節點相關聯的 CloudWatch 日誌。並非所有追蹤映射節點都支援檢視日誌。如需詳細資訊，請參閱對 [ CloudWatch 日誌進行故障](xray-troubleshooting.md#xray-troubleshooting-Nologs)診斷。

追蹤映射會以顏色概述每個節點內的問題：
+ **紅色**表示伺服器故障 (500 系列錯誤)
+ **黃色**表示用戶端錯誤 (400 系列錯誤)
+ **紫色**表示調節錯誤 (429 請求數太多)

如果您的追蹤映射很大，請使用螢幕控制項或滑鼠來放大和縮小和移動映射。

------
#### [ X-Ray console ]

**檢視服務映射**

1. 開啟 [X-Ray 主控台](https://console.aws.amazon.com/xray/home#)。預設會顯示服務映射。您也可以從左側導覽窗格中選擇**服務地圖**。  
![\[X-Ray 主控台服務映射頁面\]](http://docs.aws.amazon.com/zh_tw/xray/latest/devguide/images/console-servicemap-xray.png)

1. 選擇服務節點來檢視該節點的請求，或是兩個節點間的邊緣來檢視在該連線上進行的請求。

1. 使用回應分佈[長條圖](xray-console-histograms.md)依持續時間篩選追蹤，然後選取您要檢視追蹤的狀態碼。然後選擇 **View traces (檢視追蹤)** 來使用套用的篩選條件表達式開啟追蹤清單。  
![\[Response distribution graph showing latency peaks and service details for Scorekeep AWS ECS container.\]](http://docs.aws.amazon.com/zh_tw/xray/latest/devguide/images/console-servicemap-nodedetail-xray.png)

服務映射會透過根據成功呼叫與錯誤及故障的比例，將每個節點標上顏色，來指出每個節點的運作狀態。
+ **綠色**表示成功呼叫
+ **紅色**表示伺服器故障 (500 系列錯誤)
+ **黃色**表示用戶端錯誤 (400 系列錯誤)
+ **紫色**表示調節錯誤 (429 請求數太多)

如果您的服務映射很大，請使用螢幕控制項或滑鼠來放大和縮小和移動映射。

------

**注意**  
X-Ray 追蹤映射最多可顯示 10，000 個節點。在服務節點總數超過此限制的罕見情況下，您可能會收到錯誤，無法在主控台中顯示完整的追蹤映射。

## 依群組篩選追蹤映射
<a name="xray-console-servicemap-groups"></a>

使用[篩選條件表達](xray-console-filters.md)式，您可以定義要在群組中包含追蹤的條件。使用下列步驟在追蹤映射中顯示該特定群組。

------
#### [ CloudWatch console ]

從追蹤映射左上角的群組篩選條件中選擇群組名稱。

![\[Search bar for filtering by X-Ray group, with "TestGroup" displayed as an option.\]](http://docs.aws.amazon.com/zh_tw/xray/latest/devguide/images/console-servicemap-groups-cw.png)


------
#### [ X-Ray console ]

從下拉式功能表左側的搜尋列，選擇群組名稱。

![\[Drop-down menu showing Default, TestGroup, Create group, and Learn more options.\]](http://docs.aws.amazon.com/zh_tw/xray/latest/devguide/images/group-select-console.png)


------

現在將篩選服務映射，以顯示符合所選群組篩選條件表達式的追蹤。

## 追蹤地圖圖例和選項
<a name="xray-console-servicemap-options"></a>

追蹤映射包含圖例和數個選項，用於自訂映射顯示。

------
#### [ CloudWatch console ]

選擇地圖右上角的**圖例和選項**下拉式清單。選擇節點中顯示的內容，包括：
+  **指標**會顯示平均回應時間和在所選時間範圍內每分鐘傳送的追蹤數量。
+  **節點**會顯示每個節點內的服務圖示。

 從**偏好設定**窗格選擇其他地圖設定，可透過地圖右上角的齒輪圖示存取。這些設定包括選取用於判斷每個節點大小的指標，以及哪些 Canary 應顯示在地圖上。

------
#### [ X-Ray console ]

選擇地圖右上角的**地圖圖例**連結，以顯示服務地圖圖例。您可以在追蹤映射的右下角選擇服務映射選項，包括：
+  **服務圖示**會切換每個節點內顯示的內容，顯示服務圖示，或在所選時間範圍內每分鐘傳送的平均回應時間和追蹤數量。
+  **節點大小：無**會將所有節點設為相同大小。
+  **節點大小調整：運作**狀態會依受影響的請求數量來調整節點大小，包括錯誤、故障或限流請求。
+  **節點大小：流量**會依請求總數來調整節點大小。

------