

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# 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 を使用してデータを保存するウェブ API アプリケーション用のサービスマップ](http://docs.aws.amazon.com/ja_jp/elasticbeanstalk/latest/dg/images/scorekeep-servicemap.png)


X-Ray は、アプリケーションコードを設定するために使用できる SDK と、SDK から X-Ray API にデバッグ情報を中継するデーモンアプリケーションを提供します。

**サポートされているプラットフォーム**

X-Ray SDK は、次の Elastic Beanstalk プラットフォームで使用できます。
+ **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 SDK を使用する必要があります。手順とサンプルアプリケーションについては、*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
```