配置 AWS X-Ray 调试 - AWS Elastic Beanstalk

配置 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