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

# 配置 AWS X-Ray 调试
<a name="environment-configuration-debugging"></a>

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

**注意**  
有些区域不提供 X-Ray。如果您在其中一个区域中创建环境，则不能在环境中的实例上运行 X-Ray 守护程序。  
有关每个区域提供的 AWS 服务的信息，请参阅[区域表](https://aws.amazon.com/about-aws/global-infrastructure/regional-product-services/)。

![\[使用 Amazon DynamoDB 存储数据的 Web API 应用程序的服务地图\]](http://docs.aws.amazon.com/zh_cn/elasticbeanstalk/latest/dg/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 控制台](#environment-configuration-debugging-console)中或使用[配置文件](#environment-configuration-debugging-namespace)启用此守护程序。

要将数据上传到 X-Ray，X-Ray 守护程序需要**AWSXrayWriteOnlyAccess**托管策略中的 IAM 权限。这些权限包含在 [Elastic Beanstalk 实例配置文件](concepts-roles-instance.md)中。如果您不使用默认的实例配置文件，请参阅 *AWS X-Ray 开发人员指南*中的[为守护进程授予向 X-Ray 发送数据的权限](https://docs.aws.amazon.com/xray/latest/devguide/xray-daemon.html#xray-daemon-permissions)。

要使用 X-Ray 进行调试，必须使用 X-Ray 开发工具包。有关说明和示例应用程序，请参阅 *AWS X-Ray 开发人员指南*中的[开始使用 AWS X-Ray](https://docs.aws.amazon.com/xray/latest/devguide/xray-gettingstarted.html)。

如果使用不包含守护程序的平台版本，您仍然可以在配置文件中使用脚本运行它。有关更多信息，请参阅 *AWS X-Ray 开发人员指南*中的[手动下载和运行 X-Ray 守护进程（高级）](https://docs.aws.amazon.com/xray/latest/devguide/xray-daemon-beanstalk.html#xray-daemon-beanstalk-manual)。

**Topics**
+ [配置调试](#environment-configuration-debugging-console)
+ [aws:elasticbeanstalk:xray 命名空间](#environment-configuration-debugging-namespace)

## 配置调试
<a name="environment-configuration-debugging-console"></a>

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

**在 Elastic Beanstalk 控制台中启用调试**

1. 打开 [Elastic Beanstalk](https://console.aws.amazon.com/elasticbeanstalk) 控制台，然后**在 “区域” 列表中，选择您**的。 AWS 区域

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

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

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

1. 在 **Amazon X-Ray** 部分中，选择**启用**。

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

您也可以在创建环境期间启用此选项。有关更多信息，请参阅 [创建新环境向导](environments-create-wizard.md)。

## aws:elasticbeanstalk:xray 命名空间
<a name="environment-configuration-debugging-namespace"></a>

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

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

**Example .ebextensions/debugging.config**  

```
option_settings:
  aws:elasticbeanstalk:xray:
    XRayEnabled: true
```