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,请执行以下步骤:
-
检测您的应用程序,以允许 X-Ray 跟踪您的应用程序如何处理请求。
-
使用 X-Ray SDK、X-Ray API、ADOT 或 CloudWatch Application Signals 向 X-Ray 发送跟踪数据。有关要使用哪个接口的更多信息,请参阅选择界面。
有关检测的更多信息,请参阅为 Amazon X-Ray 检测应用程序。
-
-
(可选)将 X-Ray 配置为与和 X-Ray 集成的其他 Amazon Web Services 服务一起使用。您可以对跟踪采样并将标头添加到传入请求,运行代理或收集器,然后自动将跟踪数据发送到 X-Ray。有关更多信息,请参阅 将 Amazon X-Ray 与其他 Amazon Web Services 服务 集成。
-
部署您检测到的应用程序。当您的应用程序收到请求时,X-Ray SDK 将记录跟踪、分段和子分段数据。在此步骤中,您可能还必须设置 IAM 策略并部署代理或收集器。
-
有关在不同平台上使用适用于 OpenTelemetry 的 Amazon Distro(ADOT)SDK 和 CloudWatch 代理部署应用程序的脚本示例,请参阅 Application Signals 演示脚本
。 -
有关使用 X-Ray SDK 和 X-Ray 进程守护程序部署应用程序的脚本示例,请参阅 Amazon X-Ray 应用程序示例。
-
-
(可选)打开控制台以查看和分析数据。您可以查看跟踪地图、服务地图等的 GUI 表示形式,以检查应用程序的运行情况。使用控制台中的图形信息来优化、调试和了解您的应用程序。有关选择控制台的更多信息,请参阅使用控制台。
下图展示了如何开始使用 X-Ray:
有关控制台中提供的数据和地图的示例,请启动已经过检测,可生成跟踪数据的应用程序示例。在几分钟内,您可以生成流量,将分段发送到 X-Ray,并查看跟踪和服务地图。