X-Ray 入门 - Amazon X-Ray
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅 中国的 Amazon Web Services 服务入门 (PDF)

X-Ray 入门

注意

终止支持通知:2027 年 2 月 25 日,Amazon X-Ray 将停止对 Amazon X-Ray SDK 和进程守护程序的支持。2027 年 2 月 25 日之后,您将不会再收到更新或发行版本。有关支持时间表的更多信息,请参阅 X-Ray SDK 和进程守护程序终止支持时间表。我们建议迁移到 OpenTelemetry。有关迁移到 OpenTelemetry 的更多信息,请参阅从 X-Ray 检测迁移到 OpenTelemetry 检测

要使用 X-Ray,请执行以下步骤:

  1. 检测您的应用程序,以允许 X-Ray 跟踪您的应用程序如何处理请求。

    • 使用 X-Ray SDK、X-Ray API、ADOT 或 CloudWatch Application Signals 向 X-Ray 发送跟踪数据。有关要使用哪个接口的更多信息,请参阅选择界面

    有关检测的更多信息,请参阅为 Amazon X-Ray 检测应用程序

  2. (可选)将 X-Ray 配置为与和 X-Ray 集成的其他 Amazon Web Services 服务一起使用。您可以对跟踪采样并将标头添加到传入请求,运行代理或收集器,然后自动将跟踪数据发送到 X-Ray。有关更多信息,请参阅 将 Amazon X-Ray 与其他 Amazon Web Services 服务 集成

  3. 部署您检测到的应用程序。当您的应用程序收到请求时,X-Ray SDK 将记录跟踪、分段和子分段数据。在此步骤中,您可能还必须设置 IAM 策略并部署代理或收集器。

    • 有关在不同平台上使用适用于 OpenTelemetry 的 Amazon Distro(ADOT)SDK 和 CloudWatch 代理部署应用程序的脚本示例,请参阅 Application Signals 演示脚本

    • 有关使用 X-Ray SDK 和 X-Ray 进程守护程序部署应用程序的脚本示例,请参阅 Amazon X-Ray 应用程序示例

  4. (可选)打开控制台以查看和分析数据。您可以查看跟踪地图、服务地图等的 GUI 表示形式,以检查应用程序的运行情况。使用控制台中的图形信息来优化、调试和了解您的应用程序。有关选择控制台的更多信息,请参阅使用控制台

下图展示了如何开始使用 X-Ray:

X-Ray 显示有关应用程序请求的详细信息,包括状态、持续时间和 HTTP 响应代码。

有关控制台中提供的数据和地图的示例,请启动已经过检测,可生成跟踪数据的应用程序示例。在几分钟内,您可以生成流量,将分段发送到 X-Ray,并查看跟踪和服务地图。