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

# X-Ray 入门
<a name="xray-gettingstarted"></a>

**注意**  
X-Ray SDK/Daemon 维护通知 — 2026 年 2 月 25 日， AWS X-Ray SDKs/Daemon 将进入维护模式，在该模式下，X-Ray SDK 和 Daemon 的发布 AWS 将仅限于解决安全问题。有关支持时间表的更多信息，请参阅 [X-Ray SDK 和 Daemon Support 时间表](xray-sdk-daemon-timeline.md)。我们建议迁移到 OpenTelemetry。有关迁移到的更多信息 OpenTelemetry，请参阅[从 X-Ray 仪器迁移到 OpenTelemetry 仪器](https://docs.aws.amazon.com/xray/latest/devguide/xray-sdk-migration.html)。

要使用 X-Ray，请执行以下步骤：

1. 检测您的应用程序，以允许 X-Ray 跟踪您的应用程序如何处理请求。
   + 使用 X-Ray SDKs APIs、X-Ray ADOT 或 CloudWatch 应用程序信号向 X-Ray 发送跟踪数据。有关要使用哪个接口的更多信息，请参阅[选择界面](aws-xray-interface.md)。

    有关检测的更多信息，请参阅[正在对您的应用程序进行检测 AWS X-Ray](xray-instrumenting-your-app.md)。

1. （可选）将 X-Ray 配置为与其他 AWS 服务 与 X-Ray 集成的设备一起使用。您可以对跟踪采样并将标头添加到传入请求，运行代理或收集器，然后自动将跟踪数据发送到 X-Ray。有关更多信息，请参阅 [AWS X-Ray 与其他人集成 AWS 服务](xray-services.md)。

1. 部署您检测到的应用程序。当您的应用程序收到请求时，X-Ray SDK 将记录跟踪、分段和子分段数据。在此步骤中，您可能还必须设置 IAM 策略并部署代理或收集器。
   +  有关使用 D AWS istro for OpenTelemetry (ADOT) SDK 和 CloudWatch 代理在不同平台上部署应用程序的脚本示例，请参阅[应用程序信号演示](https://github.com/aws-observability/application-signals-demo/tree/main/scripts)脚本。
   + 有关使用 X-Ray SDK 和 X-Ray 进程守护程序部署应用程序的脚本示例，请参阅 [AWS X-Ray 示例应用程序](xray-scorekeep.md)。

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

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

![\[X-Ray 显示有关应用程序请求的详细信息，包括状态、持续时间和 HTTP 响应代码。\]](http://docs.aws.amazon.com/zh_cn/xray/latest/devguide/images/xray-get-started.png)


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