503 Service Unavailable - バックエンド サーバー

Trace ツール

1. トレース セッションを有効にします。 API 呼び出しを行って問題を再現し、「503 Service Unavailable」を再現します。
2. 失敗したリクエストのいずれかを選択し、トレースを調べます。
3. トレースのさまざまなフェーズを移動して、エラーが発生した場所を特定します。
4. ターゲット サーバーからレスポンスとして 503 エラーが返された場合は、 503 エラーの原因はターゲット サーバーです。

   以下は、503 Service Unavailable レスポンスが受信されたことを示すトレースのスクリーンショットです。 次のコマンドを入力します。

   
5. [Response received from target server] フェーズをクリックして、 [Response Headers] セクションと [Response Content] セクションで、有用な情報があるかどうかを確認できます。 <ph type="x-smartling-placeholder">
   </ph>
   • 応答ヘッダーには、サーバーヘッダーを含む場合があります。 エラー レスポンスの送信元。
   • レスポンス コンテンツには、その理由に関する追加情報が含まれる場合があります。 ターゲット サーバーから 503 レスポンス コードが送信されました。
   で確認できます。
6. チェックして、503 エラーがターゲット サーバーからのものであることを確認します。 AX 内の X-Apigee-fault-source と X-Apigee-fault-code の値 （記録されたアナリティクス データ）トレースのフェーズを以下の手順で行います。 <ph type="x-smartling-placeholder">
   </ph>
   1. 以下のスクリーンショットに示すように、[AX (Analytics Data Recorded)] フェーズをクリックします。
   2. [Phase Details] で [Response Headers] セクションまで下にスクロールし、値を確認します。 X-Apigee-fault-code と X-Apigee-fault-source を次のように設定します。
   3. X-Apigee-fault-source と X-Apigee-fault-code の値が一致する場合 503 エラーの原因が target server:

      レスポンス ヘッダー	値
      X-Apigee-fault-source	ターゲット
      X-Apigee-fault-code	messaging.adaptors.http.flow.ErrorResponseCode

7. プロキシ チェーンを使用しているかどうかを確認する（ターゲット サーバー/ターゲット エンドポイントが Apigee での別のプロキシの呼び出しこれを判断するには: <ph type="x-smartling-placeholder">
   </ph>
   1. 「Request sent to target server」フェーズに戻り、 [Show Curl] ボタンをクリックして、ターゲット サーバーのホスト エイリアスを特定します。
   2. ターゲット サーバーのホスト エイリアスが仮想ホストのエイリアスを指している場合、そのエイリアスは プロキシ チェーン。この場合、連鎖しているサービスに対して上記のすべての手順を繰り返す必要があります。 503 Service Unavailable エラーの実際の原因を特定します。 このような場合、他のチェーン接続のプロキシで 503 Service Unavailable が発生することがある さまざまなステージの情報も表示されます。 こちらのハンドブックをご覧ください。
   3. ターゲット サーバーのホスト エイリアスがバックエンド サーバーを指している場合は、 解決策。

NGINX アクセスログ

また、NGINX のアクセスログを参照して、503 ステータス コードが送信されたかどうかを判断することもできます。 バックエンドサーバーによって 書き込まれますこの問題が過去に発生した場合は特に便利です。 または、問題が断続的に発生し、UI でトレースをキャプチャできない場合。 次の手順で NGINX アクセスログからこの情報を特定します。

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

   /opt/apigee/var/log/edge-router/nginx/<org>~<env>.<port#>_access_log

2. 特定の期間に特定の API プロキシの 503 エラーを検索する （過去に発生した問題の場合）、または 503 でまだ失敗しているリクエスト。
3. 503 エラーが発生している場合は、エラーの発生元がバックエンド サーバーかどうかを確認します。 X-Apigee-fault-source と X-Apigee-fault-code の値が一致している場合、 表示される値 下の表では、バックエンド サーバーからの 503 エラーが表示されています。

   レスポンス ヘッダー	値
   X-Apigee-fault-source	ターゲット
   X-Apigee-fault-code	messaging.adaptors.http.flow.ErrorResponseCode

   次に、ターゲット サーバーに起因する 503 エラーを示すサンプル エントリを示します。

   
4. 特定の API プロキシを確認し、 プロキシ チェーン（例: もし ターゲット サーバー/ターゲット エンドポイントが Apigee の別のプロキシを呼び出しません。以下を使用している場合: プロキシ チェーン接続の場合は、次の時点まで、チェーンされたプロキシに対して上記の手順をすべて繰り返す必要があります。 503 Service Unavailable エラーの原因を特定します。このような場合 「503 Service Unavailable（サービス利用不可）」は、他のステージにある他のチェーン プロキシでも発生する可能性があります。 このハンドブックで診断できます
5. プロキシ チェーンを使用していないことを確認し、503 エラーの原因が [解決策] に移動します。

バックエンド サーバーへの呼び出し

バックエンド サーバーを直接呼び出して、同じ結果が得られることを確認できます。 Apigee Edge からリクエストが行われたときに受信した 503 Service Unavailable レスポンス。

1. 必要なヘッダー、クエリ パラメータ、 リクエストの一部としてバックエンド サーバーに渡す必要があります。
2. バックエンド サービスが一般公開されている場合は、curl コマンドを使用し、 Postman または他の REST クライアントを使用して、バックエンド サーバー API を直接呼び出すことができます。
3. Message Processor からのみバックエンド サーバーにアクセスできる場合は、 curl コマンド、Postman、その他の REST クライアントを使用して、バックエンド サーバーの API を直接呼び出す Message Processor から返されます
4. バックエンド サービスが実際に 503 Service Unavailable エラーを返していることを確認します。