の Amazon API Gateway のアクティブトレースサポートAWS X-Ray - AWS X-Ray

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

の Amazon API Gateway のアクティブトレースサポートAWS X-Ray

X-Ray を使用すると、Amazon API Gateway API から基盤となるサービスへのユーザーリクエストのトレースと分析を行うことができます。API Gateway では、API Gateway のすべてのエンドポイントタイプの X-Ray リージョン、エッジ最適化、プライベート。X-Ray は、X-Ray を利用できるすべての AWS リージョンで Amazon API Gateway と併用できます。詳細については、「」を参照してください。を使用した API Gateway API の実行のトレースAWS X-RayAmazon API Gateway デベロッパーガイドを参照してください。

注記

X-Ray は、API API Gateway を介した REST API のトレースのみをサポートします。

Amazon API Gateway ではアクティブトレースによる のサポートAWS X-Ray。API ステージのアクティブトレースを有効にして、受信リクエストをサンプリングし、X-Ray にトレースを送信します。

API ステージでアクティブトレースを有効にするには

  1. https://console.aws.amazon.com/apigateway で、API Gateway コンソールを開きます。

  2. API の選択

  3. ステージを選択します。

  4. リポジトリの []ログ/トレース[] タブで、X-Ray トレースを有効にする[] を選択し、変更の保存

  5. 左側のナビゲーションパネルで、[Resources] を選択します。

  6. 新しい設定で API を再デプロイするには、アクションドロップダウンをクリックし、API のデプロイ

API Gateway では、X-Ray コンソールで定義したサンプリングルールを使用して、記録するリクエストを決定します。API のみに適用されるルールを作成する、または特定のヘッダーを含むリクエストにのみ適用されるルールを作成することができます。API Gateway は、ステージおよびリクエストの詳細とともに、セグメントの属性にヘッダーを記録します。詳細については、「X-Ray コンソールでのサンプリングルールの設定」を参照してください。

すべての着信リクエストに対して、API Gateway はトレースヘッダーすでにない場合、受信 HTTP リクエストに入力します。

X-Amzn-Trace-Id: Root=1-5759e988-bd862e3fe1be46a994272793

トレース ID 形式

trace_id は 3 つの数字で構成され、ハイフンで区切られます。例えば、1-58406520-a006649127e371903a2de979 などです。これには以下が含まれます。

  • バージョン番号。1 です。

  • 元のリクエストの時刻。Unix エポック時間で、8 桁の 16 進数です。

    たとえば、2016 年 12 月 1 日 10:00 AM PST のエポック時間は 1480615200 秒、または 16 進数で 58406520 です。

  • トレースの 96 ビットの識別子。グローバルに一意であり、24 桁の 16 進数です。

アクティブなトレースが無効になっている場合でも、リクエストがサンプリングされ、かつトレースが開始されているサービスからのリクエストが送信された場合は、ステージによりセグメントが記録されます。たとえば、計測されたウェブアプリケーションは、HTTP クライアントを使用して API Gateway API を呼び出すことができます。X-Ray SDK を使用して HTTP クライアントを導入すると、サンプリングデシジョンを含む発信リクエストにトレースヘッダーが追加されます。API Gateway は、トレースヘッダーを読み取り、サンプリングされたリクエストのセグメントを作成します。

API Gateway を使用してAPI 用の Java SDK を生成するでは、手動で計測するのと同じ方法で、クライアントビルダーでリクエストハンドラーを追加して SDK クライアントを計測できます。AWSSDK クライアント. 手順については、「トレースAWSX-Ray SDK for Java による SDK の呼び出し」を参照してください。