414 Request-URI Too Long - TooBigLine（414 リクエスト URI が長すぎる - TooBigLine）

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

症状

クライアント アプリケーションは、次の HTTP ステータス コード 414 Request-URI Too Long を取得します。 API 呼び出しのレスポンスとしてエラーコード protocol.http.TooBigLine が返されます。

エラー メッセージ

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

HTTP/1.1 414 Request-URI Too Long

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

{
   "fault":{
      "faultstring":"request line size exceeding 7,168",
      "detail":{
         "errorcode":"protocol.http.TooBigLine"
      }
   }
}

上記のエラー メッセージの faultstring に、許可される上限が含まれています。 Apigee Edge のリクエスト行は 7168 bytes（7 KB）です。

考えられる原因

このエラーは、クライアント アプリケーションから Apigee Edge に送信されたリクエスト ラインのサイズが原因で発生します。 HTTP リクエストの一部として含まれている値が、Apigee Edge で許可されている上限を超えています。

このエラーの考えられる原因を確認する前に、リクエスト行が何であるかを理解しておきましょう。 サイズの確認方法を説明します。

リクエスト行について

一般的な HTTP リクエストは、次の 3 つの部分で構成されます。

1. <ph type="x-smartling-placeholder"></ph> リクエスト行
2. （ HTTP ヘッダーのセット）
3. [本文 ]

リクエスト行は、次に示すように 3 つの部分で構成されます。

Request-Line = <Method> <Request-URI> <HTTP-Version>

クライアント アプリケーションからサーバーに対して HTTP リクエストが送信されると、最初の行は サーバーには上記の Request-Line が含まれています。その後に リクエスト本文/ペイロードの 3 つです

次のサンプル スクリーンショットは、一般的な curl リクエストであるリクエストを示しています。 （Request-Line とともに）と Response パートがあります。

リクエスト ラインのサイズについて

1. 上記のサンプルでは、リクエストの start 行（最初の行）も、 リクエスト行と呼ばれるすべての行を以下に示します。

   GET /test/ HTTP/1.1
   

   リクエスト行のサイズは、次を含むため ~19 bytes です。 19 ASCII characters。これは 内にあるため、 場合、リクエストはエラーなしで処理されます。 成功のレスポンスが返されます

2. 同様に、の faultstring を見てみると、 上のエラー メッセージには "request line size exceeding 7,168" が含まれています。 これは、クライアントが行った HTTP リクエストの Request-Line が超過したことを示します。 7,168 バイト。

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

原因	説明	トラブルシューティングの実施対象
リクエストのペイロード サイズが上限を超えている	HTTP の一部としてクライアント アプリケーションが送信するリクエスト URI のサイズ。 Apigee Edge へのリクエストが Apigee Edge で許可されている上限を超えています。	Edge Public Cloud ユーザーと Edge Private Cloud ユーザー

共通の診断手順

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

原因: リクエストのペイロード サイズが上限を超えている

診断

1. [Fault Code]、[Fault Source]、[Request-Length size] の値を決定します。 API Monitoring、Trace Tool、または NGINX Access のログを使用して確認されたエラー 一般的な診断手順。
2. [Fault Source] の値が apigee または MP の場合、 は、クライアント アプリケーションから Apigee に送信されたリクエスト サイズが Apigee Edge で許可されている上限。
3. 次のいずれかを使用して、リクエスト行のサイズが上限の 7 KB を超えていることを確認できます。 次のメソッドを使用します。

   エラー メッセージ

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

   Apigee Edge から受信した完全なエラー メッセージにアクセスできる場合は、 faultstring をご覧ください。faultstring は、 リクエスト ラインのサイズが上限の 7 KB を超えています。

   エラー メッセージの例:

   "faultstring":"request line size exceeding 7,168"
   

   実際のリクエスト

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

   クライアント アプリケーションから行われた実際のリクエストにアクセスできる場合は、 次の操作を行います。

   1. リクエストで渡された URI のサイズを確認します。

   2. URI のサイズが Apigee Edge で許可されている上限を超えている場合、 問題の原因を特定します。

      リクエストの例:

      curl http://<hostalias>/testtoobigline?_qparam=000000000000000000……..000000<trimmed> -k -X POST
      

      上記の場合、クエリ パラメータの値 qparam 7 KB を超える（7 K を超える ASCII 文字を含む）

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

   Message Processor のログ

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

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

   Private Cloud ユーザーは、Message Processor のログを使用して リクエスト ラインのサイズが Apigee Edge で許可されている上限をご覧ください。

   1. Message Processor のログを確認します。

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

   2. 特定の期間に 414 エラーがないか検索する 問題が発生したか、問題が発生したか まだ 414 で失敗しています。次の検索文字列を使用できます。

      grep -ri "exceeding"
      

      grep -ri "RequestURITooLong"
      

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

      2021-07-12 08:53:31,461  NIOThread@0 ERROR ADAPTORS.HTTP.FLOW -
      AbstractRequestListener.onException() : Request:null, uri:null,
      message Id:null, exception:com.apigee.errors.http.user.RequestURITooLong{
      code = protocol.http.TooBigLine, message = request line size exceeding 7,168,
      associated contexts = []}, context:Context@366f4217
      input=ClientInputChannel(SSLClientChannel[Accepted: Remote:192.168.195.90:8443
      Local:192.168.67.23:34256]@301912 useCount=1 bytesRead=0 bytesWritten=45849
      age=2254670ms lastIO=0ms isOpen=true)
      

      テキスト message = request line size exceeding 7,168 上記のエラー メッセージは、リクエスト URI のサイズが 7 KB を超えていることを示しています。 そのため、Apigee Edge は例外をスローします。 com.apigee.errors.http.user.RequestURITooLong、返品可能 障害コード protocol.http.TooBigline とともに 414 ステータス コードをクライアント アプリケーションに送信します。

解決策

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

上限

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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