View a markdown version of this page

配置 AWS X-Ray 调试 - AWS Elastic Beanstalk
配置调试aws:elasticbeanstalk:xray 命名空间

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

配置 AWS X-Ray 调试

您可以使用 AWS Elastic Beanstalk 控制台或配置文件在环境中的实例 AWS X-Ray 上运行守护程序。 X-Ray 是一项 AWS 服务，它收集有关您的应用程序所服务的请求的数据，并使用它来构建服务映射，您可以使用该服务映射来识别应用程序的问题和优化机会。

注意

运行该 X-Ray 守护程序仅适用于 Beanstalk 标准环境。使用 Beanstalk 集群， AWS X-Ray 通过将aws:elasticbeanstalk:eks:observability命名空间中的traces-backend选项设置为，将应用程序的跟踪发送到xray，然后 Elastic Beanstalk 会为您运行收集组件。请参阅监控 Beanstalk 集群环境和Beanstalk 集群环境的配置选项。

注意

有些地区不提供 X-Ray。如果您在其中一个区域创建环境，则无法在环境中的实例 X-Ray 上运行守护程序。

有关每个地区提供的 AWS 服务的信息，请参阅区域表。

使用 Amazon DynamoDB 存储数据的 Web API 应用程序的服务地图

X-Ray 提供了一个可用于检测应用程序代码的 SDK 和一个守护程序应用程序，用于将调试信息从 SDK 中继到 X-Ray API。

支持的平台

您可以将该 X-Ray 软件开发工具包与以下 Elastic Beanstalk 平台一起使用：

  • Go - 版本 2.9.1 及更高版本

  • Java 8 - 版本 2.3.0 及更高版本

  • Java 8 with Tomcat 8 - 版本 2.4.0 及更高版本

  • Node.js-版本 3.2.0 及更高版本

  • Windows Server - 在 2016 年 12 月 18 日或之后发布的所有平台版本

  • Python - 版本 2.5.0 及更高版本

在支持的平台上，您可以使用配置选项在环境中的实例 X-Ray 上运行守护程序。您可以在 Elastic Beanstalk 控制台中或使用配置文件启用此守护程序。

要将数据上传到 X-Ray， X-Ray 守护程序需要AWSXrayWriteOnlyAccess托管策略中的 IAM 权限。这些权限包含在 Elastic Beanstalk 实例配置文件中。如果您不使用默认实例配置文件，请参阅AWS X-Ray 开发者指南 X-Ray中的授予守护程序向其发送数据的权限。

使用调试 X-Ray 需要使用 SD X-Ray K。有关说明和示例应用程序，请参阅 AWS X-Ray 开发人员指南中的开始使用 AWS X-Ray。

如果使用不包含守护程序的平台版本，您仍然可以在配置文件中使用脚本运行它。有关更多信息，请参阅《AWS X-Ray 开发者指南》中的手动下载和运行 X-Ray 守护程序（高级）。

配置调试

您可以 X-Ray 在 Elastic Beanstalk 控制台的运行环境中启用该守护程序。

在 Elastic Beanstalk 控制台中启用调试

  1. 打开 E lastic Beanstalk 控制台，然后在区域列表中选择您的。 AWS 区域

  2. 在导航窗格中，选择 Environments（环境），然后从列表中选择环境的名称。

  3. 在导航窗格中，选择 Configuration（配置）。

  4. 在 Updates, monitoring, and logging（更新、监控和日志记录）配置类别中，选择 Edit（编辑）。

  5. 在亚马逊 X-Ray部分中，选择已激活。

  6. 要保存更改，请选择页面底部的 Apply（应用）。

您也可以在创建环境期间启用此选项。有关更多信息，请参阅 创建新环境向导。

aws:elasticbeanstalk:xray 命名空间

您可以使用 XRayEnabled 命名空间中的 aws:elasticbeanstalk:xray 选项启用调试。

要在部署应用程序时自动启用调试，请在源代码中的配置文件中设置此选项，如下所示。

例。ebextensions/debugging.config
option_settings:
  aws:elasticbeanstalk:xray:
    XRayEnabled: true