ランタイムに関する問題

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

API の実行中に検出されたエラー、レイテンシの問題、予期しない結果 リクエストは runtime 問題と呼ばれます。

4XX/5XX エラー

ハンドブック

このセクションでは、実施可能な具体的な手順に関する情報とガイダンスを示します。 ランタイム 4XX エラーと 5XX エラーのトラブルシューティングと解決を行います。

エラー レスポンス/メッセージ エラーコード ハンドブック
HTTP/1.1 500 Internal Server Error 実際の誤差によって異なる <ph type="x-smartling-placeholder"></ph> 500 Internal Server Error（内部サーバーエラー）

と

<ph type="x-smartling-placeholder"></ph> 500 Internal Server Error - ストリーミングが有効
HTTP/1.1 503 Service Unavailable messaging.adaptors.http.flow.ServiceUnavailable <ph type="x-smartling-placeholder"></ph> 503 Service Unavailable（サービス利用不可）
HTTP/1.1 503 Service Unavailable messaging.adaptors.http.flow.NoActiveTargets <ph type="x-smartling-placeholder"></ph> 503 Service Unavailable - NoActiveTargets（サービス利用不可 - NoActiveTargets）
HTTP/1.1 503 Service Unavailable messaging.adaptors.http.flow.NoActiveTargets

（原因はヘルスチェックの失敗によるもの）

 <ph type="x-smartling-placeholder"></ph> 503 Service Unavailable - NoActiveTargets Health Check Failures（503 サービス利用不可 - NoActiveTargets ヘルスチェックの失敗）
HTTP/1.1 503 Service Unavailable

（バックエンド サーバーから）

messaging.adaptors.http.flow.ErrorResponseCode <ph type="x-smartling-placeholder"></ph> 503 Service Unavailable - Backend Server（サービス利用不可 - バックエンド サーバー）
HTTP/1.1 504 Gateway Timeout messaging.adaptors.http.flow.GatewayTimeout <ph type="x-smartling-placeholder"></ph> 504 Gateway Timeout（ゲートウェイ タイムアウト）
HTTP/1.1 504 Gateway Timeout

（バックエンド サーバーから）

messaging.adaptors.http.flow.ErrorResponseCode <ph type="x-smartling-placeholder"></ph> 504 Gateway Timeout - Backend Server（ゲートウェイ タイムアウト - バックエンド サーバー）

診断情報

4XX ランタイム エラーについて Apigee Edge サポートの支援が必要な場合 （400、401、404、499 など）または 5XX（500、503、504 など）のエラー、 次の診断ログと情報を収集し、サポートケースで共有してください。

診断情報 この情報はどこで収集できますか？ 収集方法
失敗した API リクエストをキャプチャするトレースツールの出力 Edge UI <ph type="x-smartling-placeholder"></ph> Trace ツールの使用方法
ルーターのログ ルーター 
tar cvzf /tmp/router_logs_ORGNAME_ENVNAME_$(hostname)_$(date +%Y.%m.%d_%H.%M.%S).tar.gz /opt/apigee/var/log/edge-router/nginx/ORGNAME~ENVNAME.*
Message Processor のログ Message Processor 
tar cvzf /tmp/rmp_systemlogs_$(hostname)_$(date +%Y.%m.%d_%H.%M.%S).tar.gz /opt/apigee/var/log/edge-message-processor/logs/system*
すべての診断データを圧縮する 
>tar -cvzf /tmp/data_CASE#_$(hostname).tar.gz /tmp/router* /tmp/rmp_*

400 Bad Request Error - SSL Certificate Error（SSL 証明書エラー）

ハンドブック

このセクションでは、実施可能な具体的な手順に関する情報とガイダンスを示します。 に沿って、400 Bad Request - SSL Certificate Error のトラブルシューティングと解決を行います。

エラー メッセージ ハンドブック 
<html>
  <head>
    <title>400 The SSL certificate error</title>
  </head>
  <body bgcolor="white">
    <center> <h1>400 Bad Request</h1>
    </center>
    <center>The SSL certificate error</center>
    <hr>
    <center>nginx</center>
  </body>
</html>
<ph type="x-smartling-placeholder"></ph> 400 Bad Request Error - SSL Certificate Error（400 不正なリクエスト エラー - SSL 証明書エラー）

診断情報

400 Bad Request - SSL Certificate Error に関して Apigee Edge サポートのサポートが必要な場合は、次の診断情報を収集してサポートケースで共有してください。

診断情報 この情報はどこで収集できますか？ 収集方法
ルーターのログ ルーター 
tar cvzf /tmp/router_logs_ORGNAME_ENVNAME_$(hostname)_$(date +%Y.%m.%d_%H.%M.%S).tar.gz /opt/apigee/var/log/edge-router/nginx/ORGNAME~ENVNAME.*
Tcpdumps ルーター

Router マシンで tcpdump コマンドを使用して、ネットワーク パケットをキャプチャします。

sudo tcpdump -s 0 -i any host CLIENT_HOST_IP_ADDRESS -w /tmp/router_tcpdump_$(hostname).pcap

tcpdump を圧縮します。 

tar cvzf /tmp/router_tcpdumps_$(hostname)_$(date +%Y.%m.%d_%H.%M.%S).tar.gz /tmp/router_tcpdump_$(hostname).pcap
Tcpdumps クライアント マシン

クライアント マシンで tcpdump コマンドを使用してネットワーク パケットをキャプチャします。

sudo tcpdump -s 0 -i any host VIRTUAL_HOST_ALIAS -w /tmp/client_tcpdump_$(hostname).pcap

tcpdump を圧縮します。

tar cvzf /tmp/client_tcpdumps_$(hostname)_$(date +%Y.%m.%d_%H.%M.%S).tar.gz /tmp/router_tcpdump_$(hostname).pcap
すべての診断データを圧縮する ルーター 
tar -cvzf /tmp/data_CASE#_$(hostname).tar.gz /tmp/router*

404 Unable toidentify proxy for host error（ホストのプロキシを識別できない）

ハンドブック

このセクションでは、実施可能な具体的な手順に関する情報とガイダンスを示します。 トラブルシューティングと 404 Unable to identify proxy for host の解決に進みます エラーが発生します。

エラー メッセージまたは説明 エラーコード ハンドブック 
HTTP/1.1 404 Not Found

{
   "fault":{
      "faultstring":"Unable to identify proxy for host: VIRTUAL_HOST_NAME and url: PATH",
      "detail":{
         "errorcode":"messaging.adaptors.http.flow.ApplicationNotFound"
      }
   }
}
messaging.adaptors.http.flow.ApplicationNotFound <ph type="x-smartling-placeholder"></ph> 404 Unable to identifier to proxy for host（ホストのプロキシを識別できない）

診断情報

404 Unable to identify proxy for host エラーについて Apigee Edge サポートのサポートが必要な場合は、次の診断情報を収集して サポートケース:

診断情報 この情報はどこで収集できますか？ 収集方法
Deployment API の出力 管理サーバー 
curl -s http://MANAGEMENT_SERVER_HOST:8080/v1/organizations/ORGNAME/environments/ENVNAME/apis/APINAME/deployments > /tmp/deployments_output_$(hostname)_$(date +%Y.%m.%d_%H.%M.%S).json
API と分類ツリーの出力 Message Processor

特定の組織の環境を読み込みます。

curl -s 0:8082/v1/runtime/organizations/ORGNAME/environments > /tmp/rmp_environments_list_$(hostname)_$(date +%Y.%m.%d_%H.%M.%S).txt

特定の API プロキシ用にデプロイされたリビジョンを取得します。

curl -s 0:8082/v1/runtime/organizations/ORGNAME/environments/ENVNAME/apis/APINAME/revisions > /tmp/rmp_api_APINAME_revisions_$(hostname)_$(date +%Y.%m.%d_%H.%M.%S).txt

分類ツリーを取得します。

curl -s 0:8082/v1/classification/tree > /tmp/rmp_classification_tree_$(hostname)_$(date +%Y.%m.%d_%H.%M.%S).json
Message Processor のログ Message Processor 
tar cvzf /tmp/rmp_systemlogs_$(hostname)_$(date +%Y.%m.%d_%H.%M.%S).tar.gz /opt/apigee/var/log/edge-message-processor/logs/system*
 
tar cvzf /tmp/rmp_transactionlogs_$(hostname)_$(date +%Y.%m.%d_%H.%M.%S).tar.gz /opt/apigee/var/log/edge-message-processor/logs/transactions*
 
tar cvzf /tmp/rmp_configurationlogs_$(hostname)_$(date +%Y.%m.%d_%H.%M.%S).tar.gz /opt/apigee/var/log/edge-message-processor/logs/configurations*
 
tar cvzf /tmp/rmp_system_monitor_config_mp_logs_$(hostname)_$(date +%Y.%m.%d_%H.%M.%S).tar.gz /opt/apigee/var/log/edge-message-processor/edge-message-processor* /opt/apigee/var/log/edge-message-processor/config* /opt/apigee/var/log/edge-message-processor/system-monitor*
Message Processor のヒープダンプ Message Processor

ライブ ヒープダンプを取得します。

sudo -u apigee jmap -dump:live,format=b,file=/opt/apigee/var/snapshot_$(hostname)-$(date +%Y.%m.%d_%H.%M.%S).hprof $(cat /opt/apigee/var/run/edge-message-processor/edge-message-processor.pid)

ヒープダンプを圧縮します。

tar cvzf /tmp/rmp_heapdumps_$(hostname)_$(date +%Y.%m.%d_%H.%M.%S).tar.gz /opt/apigee/var/snapshot_$(hostname)-$(date +%Y.%m.%d_%H.%M.%S).hprof
すべての診断データを圧縮する Message Processor 
tar -cvzf /tmp/data_CASE#_$(hostname).tar.gz /tmp/rmp_*

502 Bad Gateway - アップストリームへの接続中にライブ アップストリームがありません

ハンドブック

このセクションでは、実施可能な具体的な手順に関する情報とガイダンスを示します。 に沿って、502 Bad Gateway - no live upstreams while connecting to upstream のトラブルシューティングと解決を行います。

問題 ログのエラー メッセージ ハンドブック 
HTTP/1.1 502 Bad Gateway

<html>
<head>
<title>Error</title>
<style>
body {
width: 35em;
margin: 0 auto;
font-family: Tahoma, Verdana, Arial, sans-serif;
}
</style>
</head>
<body>
<h1>An error occurred.</h1>
<p>Sorry, the page you are looking for is currently unavailable.<br/>
Please try again later.</p>
</body>
</html>

NGINX エラーログに次のエラーが記録されています。

(/opt/apigee/var/log/edge-router/nginx/ORGNAME~ENVNAME._error_log)

[error] 4796#4796: *56357443 no live upstreams while connecting to upstream, client: ROUTER_IP_ADDRESS, server: HOST_ALIAS, request: "PUT BASE_PATH HTTP/1.1", upstream: "http://LISTOFMP_IP_R_MP_PORT/BASE_PATH", host: "HOST_ALIAS" 		<ph type="x-smartling-placeholder"></ph> 502 Bad Gateway（不正なゲートウェイ）

診断情報

Apigee Edge サポートのサポートが必要な場合は ログインし、502 Bad Gateway - no live streams while connecting to upstream 次の診断情報を提供し、サポートケースで共有してください。

診断情報 この情報はどこで収集できますか？ 収集方法
ルーターのログ ルーター 
tar cvzf /tmp/router_logs_ORGNAME_ENVNAME_$(hostname)_$(date +%Y.%m.%d_%H.%M.%S).tar.gz /opt/apigee/var/log/edge-router/nginx/ORGNAME~ENVNAME.*
Message Processor のログ Message Processor 
tar cvzf /tmp/rmp_systemlogs_$(hostname)_$(date +%Y.%m.%d_%H.%M.%S).tar.gz /opt/apigee/var/log/edge-message-processor/logs/system*
上位の出力、ヒープダンプ、スレッドダンプ Message Processor

最上位のコマンド出力を取得します。

top -H -bn5 > /tmp/rmp_top_output_$(hostname)-$(date +%Y.%m.%d_%H.%M.%S).txt

ヒープダンプを取得します。

sudo -u apigee jcmd $(cat /opt/apigee/var/run/edge-message-processor/edge-message-processor.pid) GC.heap_dump /opt/apigee/var/rmp_heapdump_$(hostname)-$(date +%Y.%m.%d_%H.%M.%S).hprof

スレッドダンプを取得します。

sudo -u apigee jcmd $(cat /opt/apigee/var/run/edge-message-processor/edge-message-processor.pid) Thread.print > /tmp/rmp_thread_print_$(hostname)-$(date +%Y.%m.%d_%H.%M.%S).tdump
すべての診断データを圧縮する 
tar -cvzf /tmp/data_CASE#_$(hostname).tar.gz /tmp/router* /tmp/rmp_* /opt/apigee/var/rmp_heapdump_*

502 Bad Gateway - 予期しない EOF - ターゲット

ハンドブック

このセクションでは、実施可能な具体的な手順に関する情報とガイダンスを示します。 以下の手順に沿って、502 Bad Gateway - Unexpected EOF At Target のトラブルシューティングと解決を行います。

エラー レスポンス/メッセージ エラーコード ハンドブック 
HTTP/1.1 502 Bad Gateway

{
   "fault": {
      "faultstring": "Unexpected EOF at target",
      "detail": {
           "errorcode": "messaging.adaptors.http.flow.UnexpectedEOFAtTarget"
       }
    }
}
messaging.adaptors.http.flow.UnexpectedEOFAtTarget <ph type="x-smartling-placeholder"></ph> 502 Bad Gateway 予期しない EOF

診断情報

502 Bad Gateway - Unexpected EOF At Target に関して Apigee Edge サポートのサポートが必要な場合は、 次の診断情報を収集し、サポートケースで共有してください。

診断情報 この情報はどこで収集できますか？ 収集方法
失敗した API リクエストをキャプチャするトレースツールの出力 Edge UI <ph type="x-smartling-placeholder"></ph> Trace ツールの使用方法
ルーターのログ ルーター 
tar cvzf /tmp/router_logs_ORGNAME_ENVNAME_$(hostname)_$(date +%Y.%m.%d_%H.%M.%S).tar.gz /opt/apigee/var/log/edge-router/nginx/ORGNAME~ENVNAME.*
Message Processor のログ Message Processor 
tar cvzf /tmp/rmp_systemlogs_$(hostname)_$(date +%Y.%m.%d_%H.%M.%S).tar.gz /opt/apigee/var/log/edge-message-processor/logs/system*
Tcpdumps Message Processor 
sudo tcpdump -s 0 -i any host BACKENDSERVER_HOSTNAME -w /tmp/rmp_tcpdump_$(hostname).pcap
 
tar cvzf /tmp/rmp_tcpdumps_$(hostname)_$(date +%Y.%m.%d_%H.%M.%S).tar.gz /tmp/$(hostname).pcap
すべての診断データを圧縮する Router/Message Processor 
tar -cvzf /tmp/data_CASE#_$(hostname).tar.gz /tmp/router* /tmp/rmp_*

TLS handshake の失敗

ハンドブック

このセクションでは、実施可能な具体的な手順に関する情報とガイダンスを示します。 TLS/SSL handshake 失敗のトラブルシューティングと解決については、

エラー メッセージ ハンドブック
Received fatal alert: handshake_failure <ph type="x-smartling-placeholder"></ph> TLS/SSL handshake の失敗
Received fatal alert: bad_certificate <ph type="x-smartling-placeholder"></ph> SSL handshake の失敗 - 不正なクライアント証明書

診断情報

TLS/SSL handshake の失敗について Apigee Edge サポートのサポートが必要な場合は、 次の診断情報について確認し、サポートケースで共有してください。

診断情報 この情報はどこで収集できますか？ 収集方法
失敗した API リクエストをキャプチャするトレースツールの出力 Edge UI <ph type="x-smartling-placeholder"></ph> Trace ツールの使用方法
ルーターのログ ルーター 
tar cvzf /tmp/router_logs_ORGNAME>_ENVNAME_$(hostname)_$(date +%Y.%m.%d_%H.%M.%S).tar.gz /opt/apigee/var/log/edge-router/nginx/ORGNAME~ENVNAME.*
Message Processor のログ Message Processor 
tar cvzf /tmp/rmp_systemlogs_$(hostname)_$(date +%Y.%m.%d_%H.%M.%S).tar.gz /opt/apigee/var/log/edge-message-processor/logs/system*
OpenSSL コマンド出力 Message Processor

SNI が有効になっていないバックエンド サーバー:

openssl s_client -connect BACKEND_SERVER_HOSTNAME:PORT -showcerts | tee /tmp/rmp_openssl_$(hostname)-$(date +%Y.%m.%d_%H.%M.%S).txt

SNI が有効になっているバックエンド サーバー:

openssl s_client -connect BACKEND_SERVER_HOSTNAME:PORT -server BACKEND_SERVER_HOSTNAME -showcerts | tee /tmp/rmp_openssl_$(hostname)-$(date +%Y.%m.%d_%H.%M.%S).txt
Tcpdumps Message Processor 
sudo tcpdump -s 0 -i any host BACKEND_SERVER_HOSTNAME -w /tmp/$(hostname).pcap
 
tar cvzf /tmp/rmp_tcpdumps_$(hostname)_$(date +%Y.%m.%d_%H.%M.%S).tar.gz /tmp/$(hostname).pcap
Message Processor のキーストアとトラストストアからの証明書 管理サーバー

キーストアから証明書の詳細を取得します。

curl -v http://MANAGEMENT_SERVER_HOST:PORT/v1/organizations/ORGNAME/environments/ENVNAME/keystores/KEYSTORENAME/certs/CERTNAME -u USERNAME

トラストストアから証明書の詳細を取得します。

curl -v http://MANAGEMENT_SERVER_HOSTPORT/v1/organizations/ORGNAME/environments/ENVNAME/keystores/TRUSTSTORENAME/certs/CERTNAME -u USERNAME
すべての診断データを圧縮する Message Processor 
tar -cvzf /tmp/data_CASE#_$(hostname).tar.gz /tmp/router* /tmp/rmp_*