

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 使用 X-Ray 跟踪地图
跟踪地图

查看 X-Ray 跟踪地图来识别出现错误的服务、具有高延迟的连接或针对不成功请求的跟踪。

**注意**  
 CloudWatch 现在包括 [Application Signals](https://docs.amazonaws.cn/AmazonCloudWatch/latest/monitoring/CloudWatch-Application-Monitoring-Sections.html)，可以发现和监控您的应用程序服务、客户端、Synthetics Canary 和服务依赖项。使用 Application Signals 查看您的服务列表或可视地图，根据您的服务级别目标（SLO）查看运行状况指标，并深入查看关联 X-Ray 跟踪以便更详细地进行问题排查。  
X-Ray 服务地图和 CloudWatch ServiceLens 地图合并为 Amazon CloudWatch 控制台中的 X-Ray 跟踪地图。打开 [CloudWatch 控制台](https://console.amazonaws.cn/cloudwatch/)，然后在左侧导航窗格的 **X-Ray 跟踪**下选择**跟踪地图**。

## 查看跟踪映射


跟踪地图是跟踪数据的可视化形式，此类数据由您的应用程序生成。地图显示为请求提供服务的服务节点，表示请求来源的上游客户端节点以及表示应用程序在处理请求时使用的 Web 服务和资源的下游服务节点。

跟踪地图显示使用 Amazon SQS 和 Lambda 的不同事件驱动型应用程序中跟踪的互联视图。有关更多信息，请参阅[跟踪事件驱动型应用程序](xray-tracelinking.md)。跟踪地图还支持[跨账户跟踪](xray-console-crossaccount.md)，在一张地图中显示多个账户中的节点。

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

**如何在 CloudWatch 控制台中查看跟踪地图**

1. [打开 CloudWatch 控制台](https://console.amazonaws.cn/cloudwatch/)。在左侧导航窗格的 **X-Ray 跟踪**部分下选择**跟踪地图**。  
![\[CloudWatch 控制台跟踪地图页面\]](http://docs.amazonaws.cn/xray/latest/devguide/images/console-servicemap-cw.png)

1. 选择一个服务节点来查看该节点的请求，或选择两个节点之间的边缘来查看经过该连接的请求。

1.  其他信息显示在跟踪地图下方，其中包括指标、警报以及响应时间分布的选项卡。在**指标**选项卡上，选择每张图的范围以深入查看更多详情，或选择**故障**或**错误**选项以筛选跟踪。在**呼应时间分布**选项卡上，选择在图内的一个范围以按照呼应时间来筛选跟踪。  
![\[Dashboard showing latency, requests, and faults metrics for an ElasticBeanstalk environment.\]](http://docs.amazonaws.cn/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.amazonaws.cn/xray/home#)。默认情况下，将显示服务地图。也可以从左侧导航窗格中选择**服务地图**。  
![\[X-Ray 控制台服务地图页\]](http://docs.amazonaws.cn/xray/latest/devguide/images/console-servicemap-xray.png)

1. 选择一个服务节点来查看该节点的请求，或选择两个节点之间的边缘来查看经过该连接的请求。

1. 使用呼应分布[直方图](xray-console-histograms.md)按持续时间筛选跟踪，并选择要查看其跟踪的状态代码。然后选择**查看跟踪**打开应用筛选条件表达式后的跟踪列表。  
![\[Response distribution graph showing latency peaks and service details for Scorekeep Amazon ECS container.\]](http://docs.amazonaws.cn/xray/latest/devguide/images/console-servicemap-nodedetail-xray.png)

服务地图根据成功调用与错误和故障的比率为每个节点显示颜色，从而指示节点的运行状况：
+ **绿色**表示成功调用
+ **红色**表示服务器故障（500 系列错误）
+ **黄色**表示客户端错误（400 系列错误）
+ **紫色**表示限制错误（429 请求过多）

如果您的服务地图较大，则使用屏幕上的控件或鼠标可放大、缩小和移动该图像。

------

**注意**  
X-Ray 跟踪地图最多可以显示 10,000 个节点。极少数情况下，当服务节点总数超出此上限时，会收到错误消息并且无法在控制台中显示完整的跟踪地图。

## 按组筛选跟踪地图


通过使用[筛选条件表达式](xray-console-filters.md)，您可以定义某个组中要包含哪些跟踪的标准。然后，使用以下步骤在跟踪地图中显示该特定组。

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

从跟踪地图左上角的组筛选器中选择组名称。

![\[Search bar for filtering by X-Ray group, with "TestGroup" displayed as an option.\]](http://docs.amazonaws.cn/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.amazonaws.cn/xray/latest/devguide/images/group-select-console.png)


------

现在，将会对服务地图进行筛选以显示与所选组的筛选条件表达式匹配的跟踪。

## 跟踪地图图例和选项


跟踪地图包含图例和多个选项用于自定义地图显示。

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

选择地图右上角的**图例和选项**下拉列表。选择节点内显示的内容，其中包括：
+  **指标**显示所选时间范围内的平均响应时间和每分钟发送的跟踪数量。
+  **节点**显示每个节点内的服务图标。

 从**首选项**窗格中选择更多地图设置，可通过点击地图右上角的齿轮图标访问。这些设置包括选择使用哪个指标来确定每个节点的大小，以及应在地图上显示哪些 Canary。

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

在地图右上角选择**地图图例**链接，显示服务地图图例。可以在跟踪地图的右下角选择服务地图选项，包括：
+  每人节点内显示的**服务图标**切换，用于切换是显示服务图标，还是平均呼应时间以及在所选时间范围内每分钟的跟踪数量。
+  **节点大小：None** 将所有节点设置为相同大小。
+  **节点大小：运行状况**按受影响的请求数量确定节点大小，其中包括错误、故障或受限制的请求。
+  **节点大小：流量**按请求总数确定节点大小。

------