AWS Elastic Beanstalk
开发人员指南
AWS 文档中描述的 AWS 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅中国的 AWS 服务入门

配置 AWS X-Ray 调试

您可以使用 AWS Elastic Beanstalk 控制台或配置文件在环境中的实例上运行 AWS X-Ray 守护程序。X-Ray 是一种 AWS 服务,用于收集有关应用程序服务的请求的数据,并使用它来构建服务地图,以便您发现应用程序问题和优化机会。

注意

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

有关每个区域中提供的 AWS 服务的信息,请参阅区域表


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

X-Ray 提供了一个可用于检测应用程序代码的软件开发工具包,以及一个用于将调试信息从软件开发工具包中继到 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 发送数据的权限

注意

支持的平台包括版本 2 的 X-Ray 守护程序。在此版本中,采样规则不完全受支持。您可以使用任何版本的守护程序在本地定义采样规则;要使用开发工具包调用 X-Ray 服务以获取集中定义的采样规则并报告采样统计数据,您需要 3.0.0 及更高版本。有关详细信息,请参阅 AWS X-Ray 开发人员指南 中的在 AWS X-Ray 控制台中配置采样规则

要使用 X-Ray 进行调试,必须使用 X-Ray 开发工具包。有关说明和示例应用程序,请参阅 AWS X-Ray 开发人员指南 中的开始使用 AWS X-Ray

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

配置调试

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

在 Elastic Beanstalk 控制台中启用调试

  1. 打开 Elastic Beanstalk 控制台

  2. 导航到您的环境的管理页

  3. 选择 Configuration

  4. Software 配置卡上,选择 Modify

  5. 对于 X-Ray Daemon (X-Ray 守护程序),选择 Enabled (已启用)

  6. 选择 Apply

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

aws:elasticbeanstalk:xray 命名空间

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

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

例 .ebextensions/debugging.config

option_settings: aws:elasticbeanstalk:xray: XRayEnabled: true