502 Bad Gateway - 重複ヘッダー

API Monitoring

API Monitoring を使用してエラーを診断するには:

1. <ph type="x-smartling-placeholder"></ph> Apigee Edge UI にログインするユーザーとして、 付与します。

2. 問題を調査する組織に切り替えます。

   
3. [Analyze] >API モニタリング >Investigate ページをご覧ください。
4. エラーが発生した期間を選択します。
5. [プロキシ] フィルタが [すべて] に設定されていることを確認します。
6. 障害コードを Time に対してプロットします。

7. 以下のように、障害コード protocol.http.DuplicateHeader が含まれるセルを選択します。

   （大きい画像を表示）

   

8. 障害コード protocol.http.DuplicateHeader に関する情報が次のように表示されます。

   （大きい画像を表示）

   
9. 上の例に示すように、[Status Code] が 502 であることを確認します。
10. [ログを表示] をクリックし、失敗したリクエストの行を開きます。

11. [ログ] ウィンドウで、次の情報をメモします。

    • ステータス コード: 502
    • 障害の発生元: target
    • 障害コード: protocol.http.DuplicateHeader
12. [Fault Source] が target の場合、バックエンド サーバーからのレスポンスに重複したヘッダーが含まれていました。

Trace ツール

Trace ツールを使用してエラーを診断するには:

1. トレース セッションを有効にし、以下のいずれかを行います。 <ph type="x-smartling-placeholder">
   </ph>
   1. 502 Bad Gateway エラーが発生するのを待つ、または
   2. 問題を再現できる場合は、API 呼び出しを行い、 502 Bad Gateway 件のエラー

2. [Show all Flow Infos] が有効になっていることを確認します。

   
3. 失敗したリクエストのいずれかを選択し、トレースを調べます。
4. トレースのさまざまなフェーズを移動して、エラーが発生した場所を特定します。

5. このエラーは通常、Request sent to target の後のフローで発生します。 server フェーズで実行します。

   （大きい画像を表示）

   

6. トレースのエラーの値をメモします。

   上記のサンプル トレースでは、エラーが Duplicate Header "Expires" と表示されます。以降 リクエストがバックエンド サーバーに送信された後に Apigee によってエラーが発生した場合、 バックエンド サーバーがヘッダー Expires を複数回送信したことを示しています。

7. トレースの [AX（Analytics Data Recorded）] フェーズに移動してクリックします。

8. [Phase Details - Response Headers] セクションまで下にスクロールし、 次のように、X-Apigee-fault-code と X-Apigee-fault-source の値を設定します。

   （大きい画像を表示）

   
9. X-Apigee-fault-code と X-Apigee-fault-source の値が表示されます。 protocol.http.DuplicateHeader と target として定義され、 このエラーは、バックエンド サーバーによって重複したヘッダーが レスポンス ヘッダー Expires。

   レスポンス ヘッダー	値
   X-Apigee-fault-code	protocol.http.DuplicateHeader
   X-Apigee-fault-source	target

10. 以下について プロキシ チェーン つまり、ターゲット サーバーまたはターゲット エンドポイントが Apigee の別のプロキシを呼び出している場合です。

    1. これを判断するには、Request sent to target サーバー フェーズに戻ります。 [Show Curl] をクリックします。

       

    2. [Curl for Request Sent to Target Server] ウィンドウが開き、ここから次のことができます。 ターゲット サーバーのホスト エイリアスを指定します。

    3. ターゲット サーバーのホスト エイリアスが仮想ホストのエイリアスを指している場合、そのエイリアスはプロキシ チェーン化します。この場合、次の時点まで、チェーンされたプロキシに対して上記のすべての手順を繰り返す必要があります。 502 Bad Gateway エラーの原因を特定します。
    4. ターゲット サーバーのホスト エイリアスがバックエンド サーバーを指している場合、 バックエンド サーバーがレスポンスで重複するヘッダーを Apigee に送信しています。

NGINX

NGINX アクセスログを使用してエラーを診断するには:

1. Private Cloud ユーザーは、NGINX アクセスログを使用して次のことを行えます。 HTTP 502 エラーに関する重要な情報を確認する。

2. NGINX アクセスログを確認します。

   /opt/apigee/var/log/edge-router/nginx/ORG~ENV.PORT#_access_log

   ここで、ORG、ENV、PORT# は、 使用します。

3. 特定の期間に 502 エラーがないか検索して確認できます （過去に発生した場合）か、引き続き失敗するリクエストがあるかどうかを 502。

4. X-Apigee-fault-code で 502 エラーが見つかった場合 protocol.http.DuplicateHeader の値と一致する場合は、 X-Apigee-fault-source. の値を確認します。

   NGINX アクセスログの 502 エラーの例:

   

   NGINX アクセスログの上記のサンプル エントリでは、X- Apigee-fault-code と X-Apigee-fault-source:

   レスポンス ヘッダー	値
   X-Apigee-fault-code	protocol.http.DuplicateHeader
   X-Apigee-fault-source	target

重複を修正する

オプション 1 [推奨される方法] 重複したヘッダーが含まれないようにバックエンド サーバーを修正する

1. 特定のバックエンド サーバーが重複ヘッダーを送信する理由を分析する Expires を実行し、API プロキシがそれを受け入れられるかどうかを確認します。イン HTTP 仕様上、これは望ましいことではありません。 RFC7230。
2. これが望ましくない場合は、重複したヘッダーを送信しないようにターゲット サーバー アプリケーションを変更します。 上記の例では、ヘッダー Expires が送信されています。 同じ値で 2 回実行されるため、これは望ましいことではありません。この問題を解決するには、 ターゲット サーバーが Expires ヘッダーを 1 回だけ渡すようにします。
3. これが望ましく、ヘッダーの重複を許可する場合は、 オプション #2 CwC プロパティを使用する

CwC

オプション #2 CwC プロパティを使用する

Apigee には CwC プロパティが用意されています。 HTTPHeader.<HeaderName>: クライアント アプリケーションとターゲット Apigee Edge の API プロキシに重複するヘッダーを送信します。

たとえば、Message Processor で次のプロパティを設定して、重複を許可することができます。 ヘッダー Expires に複数の値を設定します。

HTTPHeader.Expires=allowDuplicates, multiValued

1. Private Cloud ユーザーは、プロパティを構成して Apigee を阻止できます。 リクエストに 502 Bad Gateway エラーが含まれている場合でも、エッジが 502 Bad Gateway エラーを発生させない 複製ヘッダーを使用します。 <ph type="x-smartling-placeholder"></ph> 重複ヘッダーを使用するように Message Processor を構成するの入門ガイドを参照してください。
2. Public Cloud ユーザーの場合は、Apigee Edge サポートに連絡して、この構成を依頼してください。 おすすめします。