

# API Gateway で X-Ray を使用して REST API へのユーザーリクエストをトレースする
<a name="apigateway-xray"></a>

[AWS X-Ray](https://docs.aws.amazon.com/xray/latest/devguide/xray-services-apigateway.html) を使用して、Amazon API Gateway の REST API から基盤となるサービスへのユーザーリクエストの流れをトレースして分析することができます。API Gateway では、API Gateway のすべての REST API エンドポイントタイプ (リージョン、エッジ最適化、プライベート) で X-Ray によるトレースがサポートされています。X-Ray は、X-Ray を利用できるすべての AWS リージョンで Amazon API Gateway と併用できます。

X-Ray では、リクエスト全体をエンドツーエンドで確認できるため、API とそのバックエンドのサービスのレイテンシーを分析することができます。X-Ray のサービスマップを使用して、リクエスト全体のレイテンシーや X-Ray と統合されているダウンストリームのサービスのレイテンシーを確認できます。また、サンプリングルールを設定することで、X-Ray で記録するリクエストとサンプリングレートを条件に応じて指定できます。

既にトレースされているサービスから API Gateway の API を呼び出すと、API Gateway はその API に対して X-Ray によるトレースが有効になっていない場合でもトレースを行います。

X-Ray は、API のステージに対して、API Gateway コンソールを使用するか、API Gateway の API または CLI を使用して有効にすることができます。

**Topics**
+ [API Gateway REST API で AWS X-Ray を設定する](apigateway-enabling-xray.md)
+ [API Gateway で AWS X-Ray サービスマップとトレースビューを使用する](apigateway-using-xray-maps.md)
+ [API Gateway API の AWS X-Ray サンプリングルールを設定する](apigateway-configuring-xray-sampling-rules.md)
+ [Amazon API Gateway API に対する AWS X-Ray トレース](apigateway-understanding-xray-traces.md)