AWS X-Ray 控制台 - AWS X-Ray
AWS 文档中描述的 AWS 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅中国的 AWS 服务入门

AWS X-Ray 控制台

您可以使用 AWS X-Ray 控制台查看您的应用程序所服务的请求的服务地图和跟踪。

控制台的服务地图是 JSON 服务图的可视化形式,由 X-Ray 从您的应用程序生成的跟踪数据生成。

地图包含您账户中为请求提供服务的每个应用程序的服务节点,表示请求来源的上游客户端节点以及表示应用程序在处理请求时使用的 Web 服务和资源的下游服务节点。


      X-Ray 服务地图是 X-Ray 根据应用程序的跟踪数据生成的 JSON 服务图的可视化表示形式

您可以使用筛选器查看针对特定请求、服务、两个服务之间的连接(边缘)或满足某个条件的请求的服务地图或跟踪。X-Ray 提供了筛选条件表达式语言,用于根据原始分段上的请求标头、响应状态和索引字段中的数据筛选请求、服务和边缘。

查看服务地图

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

查看服务地图

  1. 打开 X-Ray 控制台的服务地图页面

    
            X-Ray 控制台服务地图页面
  2. 选择一个服务节点来查看该节点的请求,或选择两个节点之间的边缘来查看经过该连接的请求。

  3. 使用直方图按持续时间筛选跟踪,并选择要查看其跟踪的状态代码。然后选择 View traces 打开应用筛选条件表达式后的跟踪列表。

服务地图根据成功调用与错误和故障的比率为每个节点显示颜色,从而指示节点的运行状况:

  • 绿色表示成功调用

  • 红色表示服务器故障 (500 系列错误)

  • 黄色表示客户端错误 (400 系列错误)

  • 紫色表示限制错误 (429 请求过多)


        显示成功调用(绿色)和客户端错误(黄色)的服务地图

在每个节点的中心,控制台会显示选定时间范围内的平均响应时间和每分钟发送的跟踪数。

如果您的服务地图较大,控制台将默认为缩小视图。使用屏幕上的控件或鼠标可放大、缩小和移动该图像。


        缩放和移动服务地图

控件

  • – 放大或缩小。您还可以使用鼠标滚轮进行放大或缩小。

  • – 滚动服务地图。使用鼠标单击并拖动以滚动。

  • – 调整地图中心的选定节点或边缘。

按组查看服务地图

通过使用筛选条件表达式,您可以定义接受跟踪进入组的标准。然后,使用以下步骤在服务地图中显示该特定组。

查看组服务地图

  1. 打开 X-Ray 控制台的服务地图页面

  2. 从搜索栏左侧的下拉菜单中选择一个组名称。

更改节点表示形式

使用以下选项更改服务地图的表示形式。您可以切换服务图标以更好地跟踪服务流,还可以更改节点的权重以更好地表示流量或运行状况。

更改节点表现形式

  1. 打开 X-Ray 控制台的服务地图页面或单个跟踪映射。

    节点选项位于地图的右下角。

  2. 为节点选择表示形式。

    Service Icons enabled

    Service Icons (服务图标) – 启用后,会显示节点所代表的 AWS 服务的图标,而不是默认的活动摘要。

    Node weight by None

    None (无) – 不会调整节点大小,所有节点的权重相同。

    Node weight by Health

    Health (运行状况) – 节点大小根据受影响请求的总数计算。受影响的请求包括 faulterrorthrottle。例如,有两个节点,第一个在 1000 个采样中共有 10% 的请求受影响(即 100 个请求受影响),第二个在 100 个采样中共有 50% 的请求受影响(即 50 个请求受影响),则第一个节点的大小将大于第二个节点的大小。

    Node weight by Traffic

    Traffic (流量) – 节点大小根据采样请求的总数计算。例如,具有 1000 个采样请求的节点与具有 100 个采样请求的节点相比,前者的大小将大于后者。

查看跟踪

使用 X-Ray 控制台中的跟踪列表根据 URL、响应代码或跟踪摘要中的其他数据查找跟踪。

使用跟踪列表

  1. 在 X-Ray 控制台中打开 Trace overview (跟踪概述)

    
            X-Ray 控制台中的跟踪列表,用于按跟踪摘要中的 URL、响应代码或其他数据查找跟踪
  2. 选择 URL 来筛选跟踪列表。

  3. 选择跟踪 ID 以查看跟踪的时间线。

    
            选择跟踪 ID 以查看跟踪的时间线

Timeline (时间线) 视图显示分段和子分段的层次结构。列表中的第一个条目为分段,表示服务为单个请求记录的所有数据。


        显示分段和子分段层次结构的时间线视图,其中分段作为列表中的第一项

分段的下一级是子分段。此示例显示了分析的 Amazon DynamoDB 客户端记录的子分段,和一个自定义子分段。


        由分析过的 Amazon DynamoDB 客户端记录的分段和一个自定义子分段的时间线视图

当您使用分析的 AWS 开发工具包、HTTP 或 SQL 客户端调用外部资源时,X-Ray 开发工具包会自动记录子分段。您也可以要求开发工具包记录任何函数或代码块的自定义子分段。自定义子分段在打开状态下记录的其他子分段将成为自定义子分段的子级。

Timeline (时间线) 视图中,您还可以访问控制台用来生成时间线的原始跟踪数据。选择 Raw data 以查看包含构成跟踪的所有分段和子分段的 JSON 文档。


        包含构成跟踪的所有分段和子分段的原始数据 JSON 文档

查看跟踪映射

使用跟踪映射可以直观地映射单个请求的端到端路径。

查看跟踪映射

  1. 在 X-Ray 控制台中打开 Trace overview (跟踪概述)

  2. 选择 URL 来筛选跟踪列表。

  3. 选择跟踪 ID 以查看跟踪的时间线。跟踪映射显示在跟踪时间轴上方。


        显示在跟踪时间轴上方的跟踪映射。

查看分段详细信息

在跟踪时间线中选择某分段的名称,可以查看其详细信息。Overview (概述) 选项卡显示有关请求和响应的信息。


        显示有关请求和响应信息的跟踪时间线中的分段概览

分段的 Resources (资源) 选项卡显示有关运行您的应用程序和 X-Ray 开发工具包的 AWS 资源的信息。使用开发工具包的 Amazon EC2、AWS Elastic Beanstalk 或 Amazon ECS 插件记录特定于服务的资源信息。


        显示有关运行您的应用程序和 X-Ray 开发工具包的 AWS 资源信息的分段的“Resources (资源)”选项卡

其余的选项卡显示分段上记录的 AnnotationsMetadataExceptions。当所分析的请求引发异常时,会自动捕获这些异常。注释和元数据包含您使用开发工具包提供的方法记录的附加信息。


        显示有关分段其他信息的“Annotations (注释)”选项卡

查看子分段详细信息

在跟踪时间线中选择某分段的名称,可以查看其详细信息。对于使用已分析客户端生成的子分段,Overview (概述) 选项卡包含从您的应用程序角度看的请求和响应信息。此示例显示了对 DynamoDB 的所分析调用的子分段。


        来自对 DynamoDB 的分析调用的子分段信息

子分段的 Resources (资源) 选项卡,显示有关 DynamoDB 表、调用的操作和请求 ID 的详细信息。


        此子分段的资源信息显示有关 DynamoDB 表、调用的操作和请求 ID 的详细信息

对于自定义子分段,Overview (概述) 选项卡显示子分段的名称,您可以设置该名称来指定它所记录的代码或函数区域。


        自定义子分段的概览信息

使用自定义子分段将来自已分析客户端的子分段分组。您还可以在子分段上记录元数据和注释,这有助于调试函数。


        记录自定义子分段上的元数据以帮助调试函数

在此示例中,应用程序记录其保存到 DynamoDB 的每个 Game 对象的状态。它通过将对象传递到子分段上的 putMetadata 方法来实现这一点。X-Ray 开发工具包将对象序列化到 JSON 中,并添加到分段文档。