すべてのプロダクト
Search

このプロダクト

    API Gateway:トラフィックレプリケーションポリシーの設定

    ドキュメントセンター

    API Gateway:トラフィックレプリケーションポリシーの設定

    最終更新日:Jun 09, 2026

    Cloud-native API Gateway では、本番環境のルートのトラフィックを指定したサービスにレプリケートし、シミュレーションテストやトラブルシューティングに活用できます。

    背景情報

    テスト環境で実際のトラフィックをシミュレートすることは困難です。トラフィックレプリケーションは、ゲートウェイイングレスで本番環境のリクエストをコピーし、テストサービスに転送することでこの課題を解決します。これにより、実際の本番トラフィックを使用して新機能の検証や不具合の再現が可能になります。

    シナリオ例

    この例では、Route1 のトラフィックを 100% Service2 にレプリケートします。以下の図にアーキテクチャを示します。

    image

    トラフィックレプリケーションポリシーの設定

    1. トラフィックレプリケーションポリシーは、以下のいずれかのエントリポイントから設定できます。

      インスタンス外のAPI

      1. Cloud-native API Gateway コンソールにログインします。左側のナビゲーションペインで [API] をクリックします。上部メニューでリージョンを選択します。

      2. 目的の API 名をクリックします。 インスタンスのドロップダウンリストから、目的のインスタンスを選択するか、すべてのインスタンス を選択します。 [HTTP API] タブをクリックします。

      3. Routes で、対象のルートをクリックします。

      インスタンス内のAPI

      1. Cloud-native API Gateway コンソールにログインします。 左側のナビゲーションペインで、[インスタンス] をクリックします。 上部のナビゲーションバーで、リージョンを選択します。

      2. [インスタンス] ページで、対象のゲートウェイインスタンス ID をクリックします。左側のナビゲーションペインで [API] をクリックし、次に対象の API をクリックします。

      3. [ルートリスト]で、対象のルートをクリックします。

    2. Configure Policy タブをクリックします。次に、Inbound Processing セクションで、[ポリシー/プラグインの追加] をクリックします。

    3. Mirror Traffic カードをクリックします。「ポリシーの追加: ミラートラフィック」パネルで、パラメーターを設定し、Add をクリックします。

      パラメータ

      説明

      [Enable]

      トラフィックレプリケーションポリシーを有効または無効にします。

      [Destination Service]

      レプリケートされたトラフィックを受信する宛先サービスを指定します。

      説明

      HTTP/HTTPS サービスのみがサポートされています。

      [Port]

      宛先サービスのポートを指定します。サービスポートが動的に変更される場合は、[動的ポート] を選択します。

      説明

      動的ポートは、マルチポートサービスでは使用できません。

      [Traffic Mirror Percentage]

      レプリケートするトラフィックの割合を指定します。有効な値：0～100。

      説明

      例えば、50 を指定すると、ルートのトラフィックの 50% が宛先サービスにレプリケートされます。

    結果の確認

    ゲートウェイインスタンスの Observation and Analysis > ビジネスモニタリング > Canary Release Comparison Dashboard ページに移動し、 Service1 と Service2 を選択して QPS データを比較します。QPS トレンドが同一である場合、トラフィックが正常に複製されたことを確認できます。