本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
入门 X-Ray
注意
X-Ray SDK/Daemon 维护通知 — 2026 年 2 月 25 日， AWS X-Ray SDKs/Daemon 将进入维护模式，在此模式下， X-Ray SDK 和守护程序的发布 AWS 将仅限于解决安全问题。有关支持时间表的更多信息，请参阅 X-Ray SDK 和 Daemon Support 时间表。我们建议迁移到 OpenTelemetry。有关迁移到的更多信息 OpenTelemetry，请参阅从 X-Ray 仪器仪器迁移到仪器 OpenTelemetry 仪表。
要使用 X-Ray，请执行以下步骤：
-
对您的应用程序进行检测 X-Ray ，这样可以跟踪您的应用程序如何处理请求。
-
使用 X-Ray 软件开发工具包、 X-Ray API ADOT 或 CloudWatch 应用程序信号将跟踪数据发送到 X-Ray。有关要使用哪个接口的更多信息，请参阅选择界面。
有关检测的更多信息，请参阅正在对您的应用程序进行检测 AWS X-Ray。
-
-
（可选）配置 X-Ray 为与集 AWS 服务 成的其他设备一起使用 X-Ray。您可以对跟踪进行采样并将标头添加到传入请求中，运行代理或收集器，并自动将跟踪数据发送到 X-Ray。有关更多信息，请参阅 AWS X-Ray 与其他人集成 AWS 服务。
-
部署您检测到的应用程序。当您的应用程序收到请求时， X-Ray SDK 将记录跟踪、分段和子分段数据。在此步骤中，您可能还必须设置 IAM 策略并部署代理或收集器。
-
有关使用 D AWS istro for OpenTelemetry (ADOT) SDK 和 CloudWatch 代理在不同平台上部署应用程序的示例脚本，请参阅应用程序信号演示脚本。
-
有关使用 X-Ray SDK 和 X-Ray 守护程序部署应用程序的示例脚本，请参阅AWS X-Ray 示例应用程序。
-
-
（可选）打开控制台以查看和分析数据。您可以查看跟踪地图、服务地图等的 GUI 表示形式，以检查应用程序的运行情况。使用控制台中的图形信息来优化、调试和了解您的应用程序。有关选择控制台的更多信息，请参阅使用控制台。
下图显示了如何开始使用 X-Ray：
有关控制台中提供的数据和地图的示例，请启动已经过检测，可生成跟踪数据的应用程序示例。几分钟后，您可以生成流量、向其 X-Ray发送分段以及查看追踪和服务地图。
