本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
配置 AWS X-Ray 调试
您可以使用 AWS Elastic Beanstalk 控制台或配置文件在环境中的实例上运行 AWS X-Ray 守护程序。X-Ray 是一项AWS服务,用于收集有关应用程序服务的请求的数据,并使用它来构建服务地图,以便您发现应用程序问题和优化机会。
注意
有些区域不提供 X-Ray。如果您在其中一个区域中创建环境,则不能在环境中的实例上运行 X-Ray 守护程序。
有关每个区域中提供的 AWS 服务的信息,请参阅区域表
![使用 Amazon DynamoDB 存储数据的 Web API 应用程序的服务地图](images/scorekeep-servicemap.png)
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 控制台中启用调试
打开 Elastic Beanstalk 控制台
,然后在 Regions(区域)列表中选择您的 AWS 区域。 -
在导航窗格中,选择 Environments(环境),然后从列表中选择环境的名称。
注意
如果您有多个环境,请使用搜索栏筛选环境列表。
在导航窗格中,选择 Configuration(配置)。
-
在 Updates, monitoring, and logging(更新、监控和日志记录)配置类别中,选择 Edit(编辑)。
-
在 Amazon X-Ray 部分中,选择启用。
-
要保存更改,请选择页面底部的 Apply(应用)。
您也可以在创建环境期间启用此选项。有关更多信息,请参阅 创建新环境向导。
aws:elasticbeanstalk:xray 命名空间
您可以使用 XRayEnabled
命名空间中的 aws:elasticbeanstalk:xray
选项启用调试。
要在部署应用程序时自动启用调试,请在源代码中的配置文件中设置此选项,如下所示。
例 .ebextensions/debugging.config
option_settings:
aws:elasticbeanstalk:xray:
XRayEnabled: true