查看跟踪和追踪详情 - Amazon X-Ray
查看跟踪深入了解跟踪时间线查看分段详细信息查看子分段详细信息
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

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

查看跟踪和追踪详情

使用 X-Ray 控制台中的跟踪页面根据 URL、响应代码或跟踪摘要中的其他数据查找跟踪。从追踪列表中选择追踪后，追踪详情页面将显示与所选追踪关联的服务节点地图和追踪段的时间表。

查看跟踪

CloudWatch console
在 CloudWatch 控制台中查看跟踪

  1. 登录 Amazon Web Services Management Console 并打开 CloudWatch 控制台，网址为 https://console.aws.amazon.com/cloudwatch/。

  2. 在左侧导航窗格中，选择 X-Ray 跟踪，然后选择跟踪。您可以按组筛选或输入筛选表达式。这将筛选页面底部 “跟踪” 部分中显示的跟踪。

    或者，您可以使用服务地图导航到特定的服务节点，然后查看跟踪。这将打开已应用查询的 “跟踪” 页面。

  3. 在查询优化部分中优化您的查询。要按常用属性筛选轨迹，请从 “优化查询依据” 旁边的向下箭头中选择一个选项。这些选项包含以下内容：

    • 节点-按服务节点筛选跟踪。

    • 资源 ARN-按与跟踪关联的资源筛选跟踪。这些资源的示例包括亚马逊弹性计算云 (Amazon EC2) 实 Amazon Lambda 例、函数或 Amazon DynamoDB 表。

    • 用户-使用用户 ID 筛选跟踪。

    • 错误根本原因消息-按错误根本原因筛选跟踪。

    • URL-按应用程序使用的网址路径筛选跟踪。

    • HTTP 状态码-按应用程序返回的 HTTP 状态码筛选跟踪。您可以指定自定义响应代码或从以下代码中进行选择：

      • 200— 请求成功。

      • 401— 该请求缺少有效的身份验证凭证。

      • 403— 该请求缺少有效权限。

      • 404— 服务器找不到请求的资源。

      • 500— 服务器遇到了意外情况并生成了内部错误。

    选择一个或多个条目，然后选择 “添加到查询” 以添加到页面顶部的筛选表达式中。

  4. 要查找单个跟踪，请直接在查询字段中输入跟踪 ID。您可以使用 X-Ray 格式或万维网联盟 (W3C) 格式。例如，使用 Amazon Distro for 创建的跟踪采用 OpenTelemetry W3C 格式。

    注意

    当您查询使用 W3C 格式的跟踪 ID 创建的跟踪时，控制台会以 X-Ray 格式显示匹配的跟踪。例如，如果您以 W3C 格式查询，则控制台会显示等效的 X-Ray：1-4efaaf4d-1e8720b39541901950019ee5。4efaaf4d1e8720b39541901950019ee5

  5. 随时选择运行查询，可以在页面底部的跟踪部分中匹配的跟踪列表。

  6. 要显示单个跟踪的跟踪详细信息页面，请从列表中选择一个跟踪 ID。

    下图显示了包含与追踪关联的服务节点的追踪地图，以及代表构成追踪的分段所走路径的节点之间的边缘。追踪摘要紧随追踪地图。摘要包含有关示例GET操作、其响应代码、跟踪运行持续时间以及请求时限的信息。区段时间轴遵循跟踪摘要，该摘要显示跟踪区段和子分段的持续时间。

    跟踪地图、摘要和区段时间轴详细介绍有关服务节点和追踪中分段的信息。

    如果您有一个使用 Amazon SQS 和 Lambda 的事件驱动型应用程序，则可以在跟踪映射中看到每个请求的关联跟踪视图。在地图中，来自消息生产者的跟踪链接到来自 Amazon Lambda 消费者的跟踪，并显示为虚线边缘。有关事件驱动应用程序的更多信息，请参阅。跟踪事件驱动型应用程序

    追踪和追踪详情页面还支持跨账户追踪，跨账户追踪可以在跟踪列表和单个追踪地图中列出来自多个账户的跟踪。

X-Ray console
如何在 X-Ray 控制台中查看跟踪

  1. 在 X-Ray 控制台中打开跟踪页面。跟踪概述面板显示了按常见功能分组的跟踪列表，这些跟踪记录包括错误根本原因、R esourceArn 和。InstanceId

  2. 要选择一个常用特征来查看一组成组的轨迹，请展开 “分组依据” 旁边的向下箭头。下图显示了按网址分组的跟踪的跟踪概述以及关联跟踪的列表。Amazon X-Ray 示例应用程序

    按网址分组的跟踪概述示例，然后是跟踪列表，详细信息包括 ID、方法和响应。

  3. 选择跟踪的 ID 以在 “跟踪” 列表下进行查看。您也可以在导航窗格中选择 S ervice Map 来查看特定服务节点的跟踪。然后，您可以查看与该节点关联的跟踪。

    时间轴选项卡显示跟踪的请求流，包括以下内容：

    • 追踪中每个线段的路径地图。

    • 区段到达轨迹图中的节点花了多长时间。

    • 在追踪图中向该节点发出了多少请求。

    下图显示了与向示例应用程序发出的GET请求关联的示例 Trace Map。箭头显示每个分段完成请求所走的路径。服务节点显示请求期间发出的GET请求数。

    追踪地图，然后是时间轴，其中包含各个分段、其持续时间、起点和彼此的终点。

    有关 “时间轴” 选项卡的更多信息，请参阅以下 “探索跟踪时间轴” 部分。

    原始数据选项卡以格式显示有关轨迹以及构成轨迹的区段和子分段的信息。JSON这些信息可能包括以下内容：

    • 时间戳

    • 唯一 ID

    • 与区段或子细分市场关联的资源

    • 区段或子分段的来源或起源

    • 有关对您的应用程序的请求的其他信息，例如 HTTP 请求的响应

深入了解跟踪时间线

时间轴部分在水平栏旁边显示了区段和子区段的层次结构，该水平条与他们完成任务的时间相对应。列表中的第一个条目为分段，表示服务为单个请求记录的所有数据。子分段以缩进形式列出，紧随其后。列包含有关每个区段的信息。

CloudWatch console

在 CloudWatch 控制台中，区段时间轴提供以下信息：

  • 第一列：列出所选轨迹中的区段和子分段。

  • 区段状态列：列出每个区段和子细分的状态结果。

  • 响应代码列：列出针对分段或子分段发出的浏览器请求的 HTTP 响应状态代码（如果有）。

  • 持续时间列：列出区段或子区段的运行时长。

  • “托管于” 列：列出运行区段或子区段的命名空间或环境（如果适用）。有关更多信息，请参阅 https://docs.amazonaws.cn/AmazonCloudWatch/latest/monitoring/AppSignals-StandardMetrics.html#AppSignals-StandardMetrics-Dimensions。

  • 最后一列：显示与该区段或子区段运行的持续时间相对应的水平条，相对于时间轴中的其他片段或子分段。

要按服务节点对区段和子分段列表进行分组，请打开按节点分组。

X-Ray console

在轨迹详细信息页面中，选择时间轴选项卡以查看构成跟踪的每个区段和子区段的时间轴。

在 X-Ray 控制台中，时间轴提供以下信息：

  • “名称” 列：列出跟踪中分段和子分段的名称。

  • “回复” 列：列出针对区段或子分段发出的浏览器请求的 HTTP 响应状态码（如果有）。

  • 持续时间列：列出区段或子区段的运行时长。

  • 状态列：列出区段或子区段状态的结果。

  • 最后一列：显示与该区段或子区段运行的持续时间相对应的水平条，相对于时间轴中的其他片段或子分段。

要查看控制台用于生成时间轴的原始跟踪数据，请选择原始数据选项卡。原始数据以格式显示有关轨迹的信息，以及构成轨迹的分段和子分段的信息。JSON这些信息可能包括以下内容：

  • 时间戳

  • 唯一 ID

  • 与区段或子细分市场关联的资源

  • 区段或子分段的来源或起源

  • 有关对您的应用程序的请求的其他信息，例如 HTTP 请求的响应。

当您使用经过检测的 Amazon SDK 或SQL客户端调用外部资源时HTTP，X-Ray SDK 会自动记录子分段。您还可以使用 X-Ray SDK 录制任何函数或代码块的自定义子分段。在自定义子区段打开时录制的其他子细分将成为该自定义子区段的子细分。

查看分段详细信息

在跟踪时间轴中，选择区段的名称以查看其详细信息。

区段详细信息面板显示 “概述”、“资源”、“注释”、“元数据”、“异常” 和 “SQL” 选项卡。以下内容适用：

  • 概述选项卡显示有关请求和响应的信息。信息包括名称、开始时间、结束时间、持续时间、请求 URL、请求操作、请求响应代码以及任何错误和故障。

  • 区段的 “资源” 选项卡显示来自 X-Ray SDK 的信息以及有关运行应用程序的 Amazon 资源的信息。使用适用于 X-Ray SDK 的 Amazon EC2 或 Amazon ECS 插件来记录特定于服务的资源信息。 Amazon Elastic Beanstalk有关插件的更多信息，请参阅中的 “服务插件” 部分配置适用于 Java 的 X-Ray 开发工具包。

  • 其余选项卡显示为区段记录的 “注释”、“元数据” 和 “异常”。当异常是通过检测请求生成异常时，系统会自动捕获这些异常。注释和元数据包含您使用 X-Ray SDK 提供的操作记录的其他信息。要向区段添加注释或元数据，请使用 X-Ray SDK。有关更多信息，请参阅 “使用中的软件开发工具包对应用程序进行检测” 下面列出的特定语言链接。 Amazon X-Ray 正在对您的应用程序进行检测 Amazon X-Ray

查看子分段详细信息

在跟踪时间线中选择某个子分段的名称，可以查看其详细信息。

  • 概述选项卡包含有关请求和响应的信息。这包括名称、开始时间、结束时间、持续时间、请求URL、请求操作、请求响应代码以及任何错误和故障。对于使用已检测客户端生成的子分段，概述选项卡包含从您的应用程序角度来看的请求和响应信息。

  • 子区段的 “资源” 选项卡显示有关用于运行该子分段的 Amazon 资源的详细信息。例如，资源选项卡可能包含 Amazon Lambda 函数 ARN、有关 DynamoDB 表的信息、调用的任何操作以及请求 ID。

  • 其余选项卡显示子区段上记录的 “注释”、“元数据” 和 “异常”。当异常是通过检测请求生成异常时，系统会自动捕获这些异常。注释和元数据包含您使用 X-Ray SDK 提供的操作记录的其他信息。使用 X-Ray SDK 向您的区段添加注释或元数据。有关更多信息，请参阅 “使用中的软件开发工具包对应用程序进行检测” 下面列出的特定语言链接。 Amazon X-Ray 正在对您的应用程序进行检测 Amazon X-Ray

对于自定义子分段，概述选项卡显示子分段的名称，您可以设置该名称来指定它所记录的代码或函数区域。有关更多信息，请参阅 “使用中的软件开发工具包对应用程序进行检测” 下面列出的特定语言链接。 Amazon X-Ray 使用适用于 Java 的 X-Ray 开发工具包生成自定义子分段

下图显示了自定义子细分的概述选项卡。概述包含子分段 ID、父级 ID、名称、开始和结束时间、持续时间、状态以及错误或故障。

有关子分段的概述信息，包括 ID、父 ID、名称、时间、错误和故障。

自定义子细分的 “元数据” 选项卡以JSON格式包含有关该子区段使用的资源的信息。