502 Bad Gateway - TooBigLine

<ph type="x-smartling-placeholder"></ph> 現在、Apigee Edge のドキュメントが表示されています。
Apigee X のドキュメント。 詳細

症状

クライアント アプリケーションが HTTP ステータス コードと 502 Bad Gateway エラーコードを取得する protocol.http.TooBigLine を API 呼び出しのレスポンスとして使用します。

エラー メッセージ

クライアント アプリケーションが次のレスポンス コードを受け取ります。

HTTP/1.1 502 Bad Gateway

また、次のエラー メッセージが表示される場合があります。

{
   "fault":{
      "faultstring":"response line size exceeding 2,048",
      "detail":{
         "errorcode":"protocol.http.TooBigLine"
      }
   }
}

考えられる原因

このエラーは、Response-Line サイズが ターゲット/バックエンド サーバーを Apigee に HTTP レスポンスの一部であるエッジが、許容される最大値を超えている Apigee Edge の制限をご覧ください。

このエラーの考えられる原因を確認する前に、レスポンス ラインが何であるかを理解して サイズの確認方法を説明します。

レスポンス ラインについて

一般的な HTTP レスポンスは、次の 3 つの部分で構成されます。

1. <ph type="x-smartling-placeholder"></ph> ステータス ライン（Apigee ではレスポンス ラインと呼ばれます）
2. （ HTTP ヘッダーのセット）
3. [本文 ]

Response-Line は、プロトコル バージョン と数値 という 3 つの部分で構成されます。 ステータスコードと関連するテキストフレーズを以下のように返します。

Response-Line   = <HTTP-Version> <Status-Code> <Reason-Phrase>

ターゲット/バックエンド サーバー アプリケーションから HTTP レスポンスが送信されると、 sent は、前述の Response-Line を表します。その後に レスポンスの本文/ペイロードが含まれます。次のサンプル スクリーンショットは、 curl リクエスト、Request パート、Response パート（ Response-Line）。

レスポンス ラインのサイズについて

1. 上記のサンプルでは、レスポンスの start 行（1 行目）も、 Response-Line と呼ばれるものは、次のとおりです。

   HTTP/1.1 200 OK
   

   このレスポンス行には 15 ASCII characters が含まれているため、~15 bytes のサイズになります。これは 内にあるため、 Apigee Edge で許可されている上限を超えると、レスポンスは何も変更せずにクライアントに返送されます。 エラーが表示されます。

2. 同様に、faultstring の 上記のエラー メッセージ。"response line size exceeding 2,048" が含まれています。これは、HTTP レスポンスの Response-Line が 2,048 バイトを超えています。

大きなレスポンス ラインについて

定義によると、 <ph type="x-smartling-placeholder"></ph> Status-Line（ここでは Response-Line と表記）と一般的な HTTP リクエストおよび レスポンスの場合、サイズは Apigee Edge に定義されているデフォルトの上限である 2,000 よりもはるかに小さくなります。 ですから、 上限に達します。ただし、次のような場合にこの上限を超える可能性があります。

1. ターゲット/バックエンド サーバーが HTTP システムではありません。非 HTTP レスポンスで応答している可能性があります。 レスポンスが返されます。
2. ターゲット/バックエンド サーバーに問題があり、HTTP の一部として長いレスポンス行を送信している レスポンスが返されます。

詳しくは、 <ph type="x-smartling-placeholder"></ph> エラー プロトコル.http.TooBigLine、「response line size too 2,048」（レスポンス行のサイズが 2,048 を超えています）が表示される。

このエラーには、次のような原因が考えられます。

原因	説明	トラブルシューティングの実施対象
レスポンス行のサイズが上限を超えています	トラフィックの一部としてターゲット/バックエンド サーバーによって送信される Response-Line のサイズ。 Apigee Edge への HTTP レスポンスが Apigee Edge で許可されている上限	Edge Public Cloud ユーザーと Edge Private Cloud ユーザー

共通の診断手順

このエラーを診断するには、次のいずれかのツールまたは手法を使用します。

原因: レスポンス行のサイズが許可された上限を超えている

診断

1. API を使用して、観測されたエラーの障害コードと障害ソースを特定します。 Monitoring、Trace ツール、または NGINX アクセスログ（ 一般的な診断手順。
2. [Fault Source] の値が target の場合は、 ターゲット/バックエンド サーバー アプリケーションから Apigee に送信されたレスポンス ラインのサイズが Apigee Edge で許可される上限。

3. 1 つのメッセージを使用して、レスポンス行のサイズが 2 KB の上限を超えていることを確認できます。 次のメソッドを使用できます。

   エラー メッセージ

   エラー メッセージを使用して検証するには:

   Apigee Edge から受信した完全なエラー メッセージにアクセスできる場合は、 faultstring。

   エラー メッセージの例:

   "faultstring":"response line size exceeding 2,048"
   

   上の faultstring は、レスポンス行のサイズが許容値を超えたことを示します。 サイズの上限は 2 KB です。

   実際のリクエスト

   実際のリクエストを使用して検証するには:

   ターゲット/バックエンド サーバーに対する実際のリクエストにアクセスできる場合 次の手順を実施します

   1. レスポンス行のサイズを確認する
   2. URI のサイズが Apigee Edge で許可されている上限を超えている場合、これが 解決します。

      ターゲット/バックエンド サーバーからのレスポンスの例:

      curl -v http://HOSTALIAS/test
      

      *   Trying 3.2.1.4...
      * TCP_NODELAY set
      * Connected to <hostalias> (3.2.1.4) port 80 (#0)
      > GET /test HTTP/1.1
      > Host: HOSTALIAS
      > User-Agent: curl/7.64.1
      > Accept: */*
      >
      < HTTP/1.1 200 1111…<trimmed>...11111111
      < Date: Mon, 26 Jul 2021 07:07:18 GMT
      < Content-Type: application/json
      < Content-Length: 269
      < Connection: keep-alive
      < Server: gunicorn/19.9.0
      < Access-Control-Allow-Origin: *
      < Access-Control-Allow-Credentials: true
      <
      {
      <Response Body>
      }
      * Connection #0 to host <hostalias> left intact
      * Closing connection 0
      

      上記のケースでは、レスポンス行の HTTP/1.1 200 1111…<trimmed>...11111111 が 2 KB を超えています。つまり、次が含まれています 2,000 文字以下の ASCII 文字を使用してください。

      他のクライアントを使用している場合は、クライアント ログを確認して、 Apigee Edge に送信される Response-Line のサイズを確認します。

   Message Processor のログ

   Message Processor ログを使用して検証するには:

   <ph type="x-smartling-placeholder">

   Private Cloud ユーザーは、Message Processor ログを使用して次のことができます。 応答行のサイズが Apigee Edge で許可されている上限をご覧ください。

   1. 失敗したリクエストのメッセージ ID を、API Monitoring、Trace ツール、 または NGINX アクセスログを作成する必要があります。詳しくは、一般的な診断手順をご覧ください。

   2. Message Processor ログでメッセージ ID を検索します。

      /opt/apigee/var/log/edge-message-processor/logs/system.log

   3. system.log から次のような行が表示されます。

      2021-07-26 06:45:41,451 org:myorg env:prod api:testtoobigline rev:1 messageid:r-5110240-1
      NIOThread@1 ERROR HTTP.CLIENT - HTTPClient$Context$3.onException() :
      ClientChannel[Connected: Remote:3.2.1.2:80 Local:192.168.205.251:44398]@20592
      useCount=1 bytesRead=0 bytesWritten=201 age=144ms  lastIO=0ms  isOpen=true.onExceptionRead
      exception: {}
      com.apigee.errors.http.server.BadGateway: response line size exceeding 2,048
      at <snipped>
      
      2021-07-26 06:45:41,451 org:myorg env:prod api:testtoobigline rev:1
      messageid:r-5110240-1  NIOThread@1 ERROR ADAPTORS.HTTP.FLOW -
      AbstractResponseListener.onException() : AbstractResponseListener.onError
      (HTTPResponse@6a5d6c33, response line size exceeding 2,048)
      

      上記のテキスト message = response line size exceeding 2,048 レスポンス ラインのサイズが 2 KB を超えていることを示すエラー メッセージ。したがって、 Apigee Edge は例外をスローし、次の内容を含むステータス コード 502 を返します。 クライアント アプリケーションに送信します。protocol.http.TooBigline

解決策

<ph type="x-smartling-placeholder">

上限

Apigee では、クライアント アプリケーションとバックエンド サーバーがリクエスト/レスポンス行を送信しないことを想定している サイズが、リクエスト/レスポンス ラインの上限に記載されている上限より大きい場合。 （Apigee Edge 制限内）をご覧ください。

1. Public Cloud ユーザーの場合、リクエストと レスポンス ラインのサイズは、リクエスト/レスポンス ラインのサイズに記載されています。 Apigee Edge の制限。
2. Private Cloud ユーザー の場合は、デフォルトの上限を変更した可能性があります。 リクエストとレスポンス行のサイズに制限があります（推奨されませんが）。 レスポンス行の最大サイズは、 現在の上限を確認する方法

現在の上限を確認する方法

<ph type="x-smartling-placeholder">

このセクションでは、プロパティ HTTPResponse.line.limit に以下が設定されていることを確認する方法について説明します。 Message Processor 上の新しい値で更新されました。

1. Message Processor マシンで、次のプロパティを検索します。 HTTPResponse.line.limit（ /opt/apigee/edge-message-processor/conf ディレクトリを作成し、 次のように設定されている値を確認します。

   grep -ri "HTTPResponse.line.limit" /opt/apigee/edge-message-processor/conf
   

2. 上記のコマンドのサンプル結果は次のとおりです。

   /opt/apigee/edge-message-processor/conf/http.properties:HTTPResponse.line.limit=2k
   

3. 上記の出力例では、プロパティ HTTPResponse.line.limit が http.properties の値 2k に設定されています。

   これは、Apigee for Private で構成されたレスポンス ラインのサイズの上限を示しています。 クラウドは 2 KB です。

Apigee サポートのサポートが必要な場合は、 診断情報の収集が必要な場合。

診断情報の収集が必要な場合

次の診断情報を収集して、Apigee Edge サポートに連絡してください。

Public Cloud ユーザーの場合は、次の情報を提供します。

• 組織名
• 環境名
• API プロキシ名
• 502 エラーを再現するための完全な curl コマンド
• API リクエストのトレース ファイル

Private Cloud ユーザーの場合は、次の情報を提供します。

• 失敗したリクエストについて観測された完全なエラー メッセージ
• 組織名
• 環境名
• API プロキシ バンドル
• 失敗した API リクエストのトレース ファイル
• 502 エラーの再現に使用する完全な curl コマンド

• NGINX アクセスログ /opt/apigee/var/log/edge-router/nginx/ORG~ENV.PORT#_access_log

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

• Message Processor システムログ /opt/apigee/var/log/edge-message-processor/logs/system.log