本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 設定 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_tw/elasticbeanstalk/latest/dg/images/scorekeep-servicemap.png)


X-Ray 提供了可用於檢測應用程式程式碼的軟體開發套件，以及一個將偵錯資訊從軟體開發套件轉送至 X-Ray API 的協助程式應用程式。

**支援平台**

您可以搭配下列 Elastic Beanstalk 平台使用 X-Ray 開發套件：
+ **Go** - 2.9.1 版及更新版本
+ **Java 8** - 2.3.0 版和更新版本
+ **Java 8 搭配 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. 在導覽窗格中，選擇**環境**，然後在清單中選擇您環境的名稱。

1. 在導覽窗格中，選擇**組態**。

1. 在**更新、監控和日誌記錄**組態類別中，選擇**編輯**。

1. 在 **Amazon X-Ray** 區段中，選取**已啟動**。

1. 若要儲存變更，請選擇頁面底部的**儲存變更**。

您亦可於環境建立期間啟用此選項。如需詳細資訊，請參閱[建立新的環境精靈](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
```