Masalah runtime

Anda sedang melihat dokumentasi Apigee Edge.
Buka Dokumentasi Apigee X. info

Semua error, masalah latensi, atau hasil tidak terduga yang diamati selama eksekusi API Anda permintaan disebut sebagai masalah runtime.

Error 4XX/5XX

Playbook

Bagian ini memberikan informasi dan panduan tentang beberapa prosedur tertentu yang dapat diikuti untuk memecahkan masalah dan menyelesaikan error 4XX dan 5XX runtime.

Pesan/respons error Kode error Playbook
HTTP/1.1 500 Internal Server Error Bervariasi menurut error yang sebenarnya Error Server Internal 500

dan

Error Server Internal 500 - Streaming Diaktifkan
HTTP/1.1 503 Service Unavailable messaging.adaptors.http.flow.ServiceUnavailable Layanan 503 Tidak Tersedia
HTTP/1.1 503 Service Unavailable messaging.adaptors.http.flow.NoActiveTargets 503 Layanan Tidak Tersedia - NoActiveTargets
HTTP/1.1 503 Service Unavailable messaging.adaptors.http.flow.NoActiveTargets

(Penyebabnya karena kegagalan health check)

 503 Layanan Tidak Tersedia - Kegagalan Health Check Tidak Ada Target Aktif
HTTP/1.1 503 Service Unavailable

(dari server backend)

messaging.adaptors.http.flow.ErrorResponseCode Layanan 503 Tidak Tersedia - Server Backend
HTTP/1.1 504 Gateway Timeout messaging.adaptors.http.flow.GatewayTimeout Waktu Tunggu Gateway 504
HTTP/1.1 504 Gateway Timeout

(dari server backend)

messaging.adaptors.http.flow.ErrorResponseCode Waktu Tunggu Gateway 504 - Server Backend

Informasi diagnostik

Jika Anda memerlukan bantuan dari Dukungan Apigee Edge terkait 4XX error runtime (seperti 400, 401, 404, dan 499) atau 5XX (seperti 500, 503, dan 504), error, kemudian kumpulkan dan bagikan log diagnostik dan informasi berikut dalam kasus dukungan:

Informasi diagnostik Di mana saya dapat mengumpulkan informasi ini? Bagaimana cara mengumpulkan informasi ini?
Output alat rekaman aktivitas yang mencatat permintaan API yang gagal UI Edge Cara menggunakan Alat Rekaman Aktivitas
Log router Router 
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.*
Log Pemroses Pesan 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*
Kompresi semua data diagnostik 
>tar -cvzf /tmp/data_CASE#_$(hostname).tar.gz /tmp/router* /tmp/rmp_*

Kesalahan Permintaan Buruk 400 - Kesalahan Sertifikat SSL

Playbook

Bagian ini memberikan informasi dan panduan tentang beberapa prosedur tertentu yang dapat diikuti untuk memecahkan masalah dan menyelesaikan 400 Bad Request - SSL Certificate Error.

Pesan error Playbook 
<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>
Error Permintaan Buruk 400 - Error Sertifikat SSL

Informasi diagnostik

Jika Anda memerlukan bantuan dari Dukungan Apigee Edge di 400 Bad Request - SSL Certificate Error, kumpulkan informasi diagnostik berikut dan bagikan dalam kasus dukungan:

Informasi diagnostik Di mana saya dapat mengumpulkan informasi ini? Bagaimana cara mengumpulkan informasi ini?
Log router Router 
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

Ambil paket jaringan menggunakan perintah tcpdump di mesin Router:

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

Kompresi tcpdump: 

tar cvzf /tmp/router_tcpdumps_$(hostname)_$(date +%Y.%m.%d_%H.%M.%S).tar.gz /tmp/router_tcpdump_$(hostname).pcap
Tcpdumps Mesin klien

Ambil paket jaringan menggunakan perintah tcpdump di komputer klien:

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

Kompresi tcpdump:

tar cvzf /tmp/client_tcpdumps_$(hostname)_$(date +%Y.%m.%d_%H.%M.%S).tar.gz /tmp/router_tcpdump_$(hostname).pcap
Kompresi semua data diagnostik Router 
tar -cvzf /tmp/data_CASE#_$(hostname).tar.gz /tmp/router*

404 Tidak dapat mengidentifikasi proxy untuk error host

Playbook

Bagian ini memberikan informasi dan panduan tentang beberapa prosedur tertentu yang dapat diikuti untuk memecahkan masalah dan menyelesaikan 404 Unable to identify proxy for host {i>error<i}.

Pesan atau deskripsi error Kode error Playbook 
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 404 Tidak dapat mengidentifikasi proxy untuk host

Informasi diagnostik

Jika Anda memerlukan bantuan dari Dukungan Apigee Edge terkait error 404 Unable to identify proxy for host, kumpulkan informasi diagnostik berikut dan bagikan di kasus dukungan:

Informasi diagnostik Di mana saya dapat mengumpulkan informasi ini? Bagaimana cara mengumpulkan informasi ini?
Output Deployments API Server Pengelolaan 
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
Output API dan Classification Tree Message Processor

Dapatkan lingkungan yang dimuat untuk organisasi tertentu:

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

Dapatkan revisi yang di-deploy untuk Proxy API tertentu:

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

Dapatkan hierarki klasifikasi:

curl -s 0:8082/v1/classification/tree > /tmp/rmp_classification_tree_$(hostname)_$(date +%Y.%m.%d_%H.%M.%S).json
Log Pemroses Pesan 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*
Heap dump pada Pemroses Pesan Message Processor

Dapatkan heap dump langsung:

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)

Kompresi heap dump:

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
Kompresi semua data diagnostik Message Processor 
tar -cvzf /tmp/data_CASE#_$(hostname).tar.gz /tmp/rmp_*

502 Bad Gateway - tidak ada upstream live saat terhubung ke upstream

Playbook

Bagian ini memberikan informasi dan panduan tentang beberapa prosedur tertentu yang dapat diikuti untuk memecahkan masalah dan menyelesaikan 502 Bad Gateway - no live upstreams while connecting to upstream.

Masalah Pesan error di log Playbook 
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>

Anda akan melihat error berikut dalam log error 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" 		502 Gateway Buruk

Informasi diagnostik

Jika Anda memerlukan bantuan dari Dukungan Apigee Edge di 502 Bad Gateway - no live streams while connecting to upstream, lalu kumpulkan informasi diagnostik berikut dan bagikan dalam kasus dukungan:

Informasi diagnostik Di mana saya dapat mengumpulkan informasi ini? Bagaimana cara mengumpulkan informasi ini?
Log router Router 
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.*
Log Pemroses Pesan 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*
Output teratas, heap dump, dan thread dump Message Processor

Dapatkan output perintah top:

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

Dapatkan heap dump:

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

Dapatkan thread dump:

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
Kompresi semua data diagnostik 
tar -cvzf /tmp/data_CASE#_$(hostname).tar.gz /tmp/router* /tmp/rmp_* /opt/apigee/var/rmp_heapdump_*

502 Gateway Buruk - EOF Tak Terduga Pada Target

Playbook

Bagian ini memberikan informasi dan panduan tentang beberapa prosedur tertentu yang dapat diikuti untuk memecahkan masalah dan menyelesaikan 502 Bad Gateway - Unexpected EOF At Target:

Pesan/respons error Kode error Playbook 
HTTP/1.1 502 Bad Gateway

{
   "fault": {
      "faultstring": "Unexpected EOF at target",
      "detail": {
           "errorcode": "messaging.adaptors.http.flow.UnexpectedEOFAtTarget"
       }
    }
}
messaging.adaptors.http.flow.UnexpectedEOFAtTarget 502 EOF Gateway Buruk Tak Terduga

Informasi diagnostik

Jika Anda memerlukan bantuan dari Dukungan Apigee Edge di 502 Bad Gateway - Unexpected EOF At Target, lalu kumpulkan informasi diagnostik berikut dan bagikan dalam kasus dukungan:

Informasi diagnostik Di mana saya dapat mengumpulkan informasi ini? Bagaimana cara mengumpulkan informasi ini?
Output alat rekaman aktivitas yang mencatat permintaan API yang gagal UI Edge Cara menggunakan Alat Rekaman Aktivitas
Log router Router 
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.*
Log Pemroses Pesan 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
Kompresi semua data diagnostik Router/Pemroses Pesan 
tar -cvzf /tmp/data_CASE#_$(hostname).tar.gz /tmp/router* /tmp/rmp_*

Kegagalan handshake TLS

Playbook

Bagian ini memberikan informasi dan panduan tentang beberapa prosedur tertentu yang dapat diikuti untuk memecahkan masalah dan menyelesaikan kegagalan handshake TLS/SSL:

Pesan error Playbook
Received fatal alert: handshake_failure Kegagalan Handshake TLS/SSL
Received fatal alert: bad_certificate Kegagalan Handshake SSL - Sertifikat Klien Buruk

Informasi diagnostik

Jika Anda memerlukan bantuan dari Dukungan Apigee Edge terkait kegagalan handshake TLS/SSL, kumpulkan informasi diagnostik berikut dan membagikannya dalam kasus dukungan:

Informasi diagnostik Di mana saya dapat mengumpulkan informasi ini? Bagaimana cara mengumpulkan informasi ini?
Output alat rekaman aktivitas yang mencatat permintaan API yang gagal UI Edge Cara menggunakan Alat Rekaman Aktivitas
Log router Router 
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.*
Log Pemroses Pesan 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*
Output Perintah OpenSSL Message Processor

Server Backend yang tidak mengaktifkan SNI:

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

Server Backend dengan kemampuan 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
Sertifikat dari keystore dan truststore Pemroses Pesan Server Pengelolaan

Dapatkan detail sertifikat dari Keystore:

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

Dapatkan detail sertifikat dari Truststore:

curl -v http://MANAGEMENT_SERVER_HOSTPORT/v1/organizations/ORGNAME/environments/ENVNAME/keystores/TRUSTSTORENAME/certs/CERTNAME -u USERNAME
Kompresi semua data diagnostik Message Processor 
tar -cvzf /tmp/data_CASE#_$(hostname).tar.gz /tmp/router* /tmp/rmp_*