Çalışma zamanı sorunları

Apigee Edge belgelerini görüntülüyorsunuz.
Apigee X belgelerine gidin. bilgi

API isteklerinizin yürütülmesi sırasında gözlemlenen hatalar, gecikme sorunları veya beklenmedik sonuçlar runtime sorunları olarak adlandırılır.

4XX/5XX hataları

Başucu Kitabı

Bu bölümde, çalışma zamanı 4XX ve 5XX hatalarını gidermek ve çözmek için izlenebilecek bazı özel prosedürlerle ilgili bilgiler ve yönergeler verilmektedir.

Hata yanıtı/mesajı Hata kodu Başucu Kitabı
HTTP/1.1 500 Internal Server Error Gerçek 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 - NoActiveTargets
HTTP/1.1 503 Service Unavailable messaging.adaptors.http.flow.NoActiveTargets

(Nedeni durum denetimi hatalarıdır)

 503 Hizmet Kullanılamıyor - NoActiveTargets Sağlık Durumu Kontrolü Hataları
HTTP/1.1 503 Service Unavailable

(arka uç sunucusundan)

messaging.adaptors.http.flow.ErrorResponseCode 503 Hizmet Kullanılamıyor - Arka Uç Sunucusu
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ı (ör. 400, 401, 404 ve 499) veya 5XX (ör. 500, 503 ve 504) hatalarıyla ilgili olarak Apigee Edge Destek Ekibi'nden yardım almanız gerekiyorsa destek kaydında aşağıdaki teşhis günlüklerini ve bilgilerini toplayıp paylaşın:

Teşhis bilgileri Bu bilgileri nereden edinebilirim? Bu bilgileri nasıl toplayabilirim?
İzleme aracı çıkışı, başarısız API isteklerini yakalayamadı 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.*
Mesaj işleyici 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, 400 Bad Request - SSL Certificate Error sorunlarını gidermek ve çözmek için izlenebilecek bazı özel prosedürlerle ilgili bilgiler ve rehberlik sağlanmaktadır.

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ım almanız gerekiyorsa aşağıdaki teşhis bilgilerini toplayıp destek kaydında paylaşın:

Teşhis bilgileri Bu bilgileri nereden edinebilirim? Bu bilgileri nasıl toplayabilirim?
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 dosyasını 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 makinede tcpdump komutunu kullanarak ağ paketlerini yakalayın:

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

tcpdump dosyasını 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 için proxy tanımlanamadı hatası

Başucu Kitabı

Bu bölümde, 404 Unable to identify proxy for host hatasını gidermek ve çözmek için izlenebilecek bazı özel prosedürlerle ilgili bilgiler ve rehberlik sağlanmaktadır.

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ımlanamadı

Teşhis bilgileri

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

Teşhis bilgileri Bu bilgileri nereden edinebilirim? Bu bilgileri nasıl toplayabilirim?
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ı çıkışı Mesaj İşleyici

Belirli bir kuruluş için ortamları yükleme:

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 alma:

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ı alma:

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

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

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)

Bellek 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 - no live upstreams while connecting to upstream

Başucu Kitabı

Bu bölümde, 502 Bad Gateway - no live upstreams while connecting to upstream sorunlarını gidermek ve çözmek için izlenebilecek bazı özel prosedürlerle ilgili bilgiler ve rehberlik sağlanmaktadır.

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

502 Bad Gateway - no live streams while connecting to upstream ile ilgili olarak Apigee Edge Destek Ekibi'nden yardım almanız gerekiyorsa aşağıdaki teşhis bilgilerini toplayıp destek kaydında paylaşın:

Teşhis bilgileri Bu bilgileri nereden edinebilirim? Bu bilgileri nasıl toplayabilirim?
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.*
Mesaj işleyici 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 iyi komut çıkışını alma:

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

İleti dizisi dökümünü alma:

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 Bad Gateway - Unexpected EOF At Target

Başucu Kitabı

Bu bölümde, 502 Bad Gateway - Unexpected EOF At Target sorunlarını gidermek ve çözmek için izlenebilecek bazı özel prosedürler hakkında bilgi ve rehberlik sağlanmaktadır:

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

Teşhis bilgileri

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

Teşhis bilgileri Bu bilgileri nereden edinebilirim? Bu bilgileri nasıl toplayabilirim?
İzleme aracı çıkışı, başarısız API isteklerini yakalayamadı 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.*
Mesaj işleyici 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 İşleyici 
tar -cvzf /tmp/data_CASE#_$(hostname).tar.gz /tmp/router* /tmp/rmp_*

TLS el sıkışması hataları

Başucu Kitabı

Bu bölümde, TLS/SSL el sıkışması hatalarını gidermek ve çözmek için izlenebilecek bazı özel prosedürler hakkında bilgi ve rehberlik sağlanmaktadır:

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ıyla ilgili olarak Apigee Edge Destek Ekibi'nden yardım almanız gerekiyorsa aşağıdaki teşhis bilgilerini toplayıp destek kaydında paylaşın:

Teşhis bilgileri Bu bilgileri nereden edinebilirim? Bu bilgileri nasıl toplayabilirim?
İzleme aracı çıkışı, başarısız API isteklerini yakalayamadı 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.*
Mesaj işleyici 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ç sunucusu:

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

SNI etkin arka uç sunucusu:

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
Mesaj işleyicinin anahtar deposu ve güvenilen sertifika deposundaki sertifikalar Yönetim Sunucusu

Anahtar deposundan 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

Sertifika ayrıntılarını güvenli depodan 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_*