Çalışma zamanı sorunları

Apigee Edge belgelerini görüntülüyorsunuz.
. Git: Apigee X belgeleri. bilgi

API'niz yürütülürken gözlemlenen hatalar, gecikme sorunları veya beklenmedik sonuçlar istekler, runtime sorunları olarak adlandırılır.

4XX/5XX hataları

Başucu Kitabı

Bu bölümde, sonrasında sorun giderme ve çalışma zamanı 4XX ve 5XX hatalarının çözülmesi gerekir.

Hata yanıtı/mesajı Hata kodu Başucu Kitabı
HTTP/1.1 500 Internal Server Error Asıl hataya göre değişir 500 Dahili Sunucu Hatası

ve

500 Dahili Sunucu Hatası: Akış Etkin
HTTP/1.1 503 Service Unavailable messaging.adaptors.http.flow.ServiceUnavailable 503 Hizmet Kullanılamıyor
HTTP/1.1 503 Service Unavailable messaging.adaptors.http.flow.NoActiveTargets 503 Hizmet Kullanılamıyor - Etkin Hedef Yok
HTTP/1.1 503 Service Unavailable messaging.adaptors.http.flow.NoActiveTargets

(Neden, durum denetimi hatalarından kaynaklanır)

 503 Hizmet Kullanılamıyor - NoActiveTarget Durum Denetimi Hataları
HTTP/1.1 503 Service Unavailable

(arka uç sunucusundan)

messaging.adaptors.http.flow.ErrorResponseCode. 503 Hizmet Kullanılamıyor - Arka Uç Sunucu
HTTP/1.1 504 Gateway Timeout messaging.adaptors.http.flow.GatewayTimeout 504 Ağ Geçidi Zaman Aşımı
HTTP/1.1 504 Gateway Timeout

(arka uç sunucusundan)

messaging.adaptors.http.flow.ErrorResponseCode. 504 Ağ Geçidi Zaman Aşımı - Arka Uç Sunucusu

Teşhis bilgileri

4XX Çalışma zamanı hataları konusunda Apigee Edge Destek'ten yardıma ihtiyacınız varsa (ör. 400, 401, 404 ve 499) veya 5XX (500, 503 ve 504 gibi) hataları, ardından aşağıdaki teşhis günlüklerini ve bilgileri toplayıp destek kaydında paylaşın:

Teşhis bilgileri Bu bilgileri nereden toplayabilirim? Bu bilgileri nasıl toplarım?
Başarısız API isteklerini yakalayan izleme aracı çıkışı Edge kullanıcı arayüzü İzleme Aracı'nı kullanma
Yönlendirici günlükleri Yönlendirici 
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.*
İleti işleyen günlükleri Mesaj İşleyici 
tar cvzf /tmp/rmp_systemlogs_$(hostname)_$(date +%Y.%m.%d_%H.%M.%S).tar.gz /opt/apigee/var/log/edge-message-processor/logs/system*
Tüm teşhis verilerini sıkıştırın 
>tar -cvzf /tmp/data_CASE#_$(hostname).tar.gz /tmp/router* /tmp/rmp_*
.

400 Hatalı İstek Hatası - SSL Sertifika Hatası

Başucu Kitabı

Bu bölümde, sorun giderme ve 400 Bad Request - SSL Certificate Error sorunlarını çözme adımları için takip edin.

Hata mesajı Başucu Kitabı 
<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>

400 Hatalı İstek Hatası - SSL Sertifika Hatası

Teşhis bilgileri

400 Bad Request - SSL Certificate Error ile ilgili olarak Apigee Edge Destek Ekibi'nden yardıma ihtiyacınız olursa aşağıdaki teşhis bilgilerini toplayıp destek kaydında paylaşın:

Teşhis bilgileri Bu bilgileri nereden toplayabilirim? Bu bilgileri nasıl toplarım?
Yönlendirici günlükleri Yönlendirici 
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 Yönlendirici

Yönlendirici makinesinde tcpdump komutunu kullanarak ağ paketlerini yakalayın:

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

tcpdump öğesini sıkıştırın: 

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

İstemci makinesinde tcpdump komutunu kullanarak ağ paketlerini yakalayın:

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

tcpdump öğesini sıkıştırın:

tar cvzf /tmp/client_tcpdumps_$(hostname)_$(date +%Y.%m.%d_%H.%M.%S).tar.gz /tmp/router_tcpdump_$(hostname).pcap
Tüm teşhis verilerini sıkıştırın Yönlendirici 
tar -cvzf /tmp/data_CASE#_$(hostname).tar.gz /tmp/router*
.

404 Ana makine hatası için proxy tanımlanamıyor

Başucu Kitabı

Bu bölümde, sorun giderme ve 404 Unable to identify proxy for host çözümü için takip ediliyor hatası.

Hata mesajı veya açıklaması Hata kodu Başucu Kitabı 
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 Ana makine için proxy tanımlanamıyor

Teşhis bilgileri

404 Unable to identify proxy for host hatasıyla ilgili olarak Apigee Edge Destek Ekibi'nden yardıma ihtiyacınız olursa aşağıdaki teşhis bilgilerini toplayıp destek kaydı:

Teşhis bilgileri Bu bilgileri nereden toplayabilirim? Bu bilgileri nasıl toplarım?
Deployments API çıkışı Yönetim Sunucusu 
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 ve Sınıflandırma Ağacı çıktısı Mesaj İşleyici

Belirli bir kuruluş için yüklenen ortamları alın:

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

Belirli bir API Proxy'si için dağıtılan düzeltmeleri alın:

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

Sınıflandırma ağacını alın:

curl -s 0:8082/v1/classification/tree > /tmp/rmp_classification_tree_$(hostname)_$(date +%Y.%m.%d_%H.%M.%S).json
.
İleti işleyen günlükleri Mesaj İşleyici 
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*
İleti İşlemcilerindeki yığın dökümleri Mesaj İşleyici

Canlı yığın dökümünü alın:

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)

Yığın dökümünü sıkıştırın:

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
Tüm teşhis verilerini sıkıştırın Mesaj İşleyici 
tar -cvzf /tmp/data_CASE#_$(hostname).tar.gz /tmp/rmp_*
.

502 Bad Gateway - yukarı akışa bağlanırken canlı yayın yok

Başucu Kitabı

Bu bölümde, sorun giderme ve 502 Bad Gateway - no live upstreams while connecting to upstream sorunlarını çözme adımları için takip edin.

Sorun Günlüklerdeki hata mesajı Başucu Kitabı 
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 hata günlüklerinde aşağıdaki hatayı görürsünüz:

(/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 Hatalı Ağ Geçidi

Teşhis bilgileri

Apigee Edge Destek Ekibi'nden yardıma ihtiyacınız varsa 502 Bad Gateway - no live streams while connecting to upstream tarihinde gidip aşağıdaki teşhis bilgilerini kullanıp destek kaydında paylaşın:

Teşhis bilgileri Bu bilgileri nereden toplayabilirim? Bu bilgileri nasıl toplarım?
Yönlendirici günlükleri Yönlendirici 
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.*
.
İleti işleyen günlükleri Mesaj İşleyici 
tar cvzf /tmp/rmp_systemlogs_$(hostname)_$(date +%Y.%m.%d_%H.%M.%S).tar.gz /opt/apigee/var/log/edge-message-processor/logs/system*
En iyi çıkış, yığın dökümü ve iş parçacığı dökümleri Mesaj İşleyici

En üst komut çıkışını alın:

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

Yığın dökümünü alın:

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

İş parçacığı dökümünü alın:

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
.
Tüm teşhis verilerini sıkıştırın 
tar -cvzf /tmp/data_CASE#_$(hostname).tar.gz /tmp/router* /tmp/rmp_* /opt/apigee/var/rmp_heapdump_*
.

502 Hatalı Ağ Geçidi - Hedefte Beklenmeyen EOF

Başucu Kitabı

Bu bölümde, sorun giderme ve 502 Bad Gateway - Unexpected EOF At Target sorunlarını çözmek için takip edilenler:

Hata yanıtı/mesajı Hata kodu Başucu Kitabı 
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 Hatalı Ağ Geçidi Beklenmeyen EOF durumu

Teşhis bilgileri

502 Bad Gateway - Unexpected EOF At Target ile ilgili Apigee Edge Destek Ekibi'nden yardıma ihtiyacınız olursa aşağıdaki teşhis bilgilerini toplayıp destek kaydında paylaşın:

Teşhis bilgileri Bu bilgileri nereden toplayabilirim? Bu bilgileri nasıl toplarım?
Başarısız API isteklerini yakalayan izleme aracı çıkışı Edge kullanıcı arayüzü İzleme Aracı'nı kullanma
Yönlendirici günlükleri Yönlendirici 
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.*
İleti işleyen günlükleri Mesaj İşleyici 
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 Mesaj İşleyici 
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
Tüm teşhis verilerini sıkıştırın Yönlendirici/Mesaj İşlemci 
tar -cvzf /tmp/data_CASE#_$(hostname).tar.gz /tmp/router* /tmp/rmp_*
.

TLS el sıkışma hataları

Başucu Kitabı

Bu bölümde, TLS/SSL el sıkışma hatalarını gidermek ve çözmek için şu adımları izleyin:

Hata mesajı Başucu Kitabı
Received fatal alert: handshake_failure TLS/SSL El Sıkışma Hataları
Received fatal alert: bad_certificate SSL El Sıkışma Hataları - Hatalı İstemci Sertifikası

Teşhis bilgileri

TLS/SSL el sıkışma hataları konusunda Apigee Edge Desteği'nden yardıma ihtiyacınız varsa aşağıdaki teşhis bilgilerini inceleyip destek kaydında paylaşın:

Teşhis bilgileri Bu bilgileri nereden toplayabilirim? Bu bilgileri nasıl toplarım?
Başarısız API isteklerini yakalayan izleme aracı çıkışı Edge kullanıcı arayüzü İzleme Aracı'nı kullanma
Yönlendirici günlükleri Yönlendirici 
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.*
.
İleti işleyen günlükleri Mesaj İşleyici 
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 Komut Çıkışı Mesaj İşleyici

SNI etkin olmayan Arka Uç Sunucu:

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

SNI özellikli Arka Uç Sunucu:

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 Mesaj İşleyici 
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
İleti İşleyici'nin anahtar deposundan ve güven deposundan alınan sertifikalar Yönetim Sunucusu

Anahtar Deposu'ndan sertifika ayrıntılarını alın:

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

Truststore'dan sertifika ayrıntılarını alın:

curl -v http://MANAGEMENT_SERVER_HOSTPORT/v1/organizations/ORGNAME/environments/ENVNAME/keystores/TRUSTSTORENAME/certs/CERTNAME -u USERNAME
Tüm teşhis verilerini sıkıştırın Mesaj İşleyici 
tar -cvzf /tmp/data_CASE#_$(hostname).tar.gz /tmp/router* /tmp/rmp_*
.