配置 AWS X-Ray 调试 - 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 发送数据的权限

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

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

配置调试

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

在 Elastic Beanstalk 控制台中启用调试

  1. 打开 Elastic Beanstalk 控制台,然后在 Regions (区域) 列表中选择您的 AWS 区域。

  2. 在导航窗格中,选择 Environments (环境),然后从列表中选择环境的名称。

    注意

    如果您有多个环境,请使用搜索栏筛选环境列表。

  3. 在导航窗格中,选择 Configuration (配置)

  4. Software (软件) 配置类别中,选择 Edit (编辑)

  5. AWS X-Ray 部分中,选择 X-Ray daemon (X-Ray 守护程序)

  6. 选择 Apply

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

aws:elasticbeanstalk:xray 命名空间

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

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

例 .ebextensions/debugging.config

option_settings: aws:elasticbeanstalk:xray: XRayEnabled: true