Apigee Edge belgelerini görüntülüyorsunuz.
Apigee X belgelerine gidin. bilgi
API istekleriniz yürütülürken gözlemlenen tüm 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 için izlenebilecek bazı prosedürler hakkında bilgi ve yol gösterici bilgiler sağlanmaktadır.
| 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 |
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 - NoActiveTarget (Etkin Olmayan Hedef) |
HTTP/1.1 503 Service Unavailable |
messaging.adaptors.http.flow.NoActiveTargets
(Nedeni durum denetimi hatalarından kaynaklanır) |
503 Hizmet Kullanılamıyor - NoActiveTarget Durum Denetimi Hataları |
HTTP/1.1 503 Service Unavailable
(arka uç sunucudan) |
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ç sunucudan) |
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ı konusunda Apigee Edge Desteği'nden yardıma ihtiyacınız olursa aşağıdaki teşhis günlüklerini ve bilgileri destek kaydında toplayıp 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ı nasıl kullanılır? |
| 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 İş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 |
>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ı prosedürler hakkında bilgi ve yol gösterici bilgiler 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 Apigee Edge Desteği'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 sudo tcpdump -s 0 -i any host CLIENT_HOST_IP_ADDRESS -w /tmp/router_tcpdump_$(hostname).pcap
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
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 | 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, 404 Unable to identify proxy for host hatasını gidermek ve çözmek için izlenebilecek bazı prosedürler hakkında bilgi ve yol gösterici bilgiler 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ımlanamıyor |
Teşhis bilgileri
404 Unable to identify proxy for
host hatasıyla ilgili olarak Apigee Edge Desteği'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? |
|---|---|---|
| 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ın yüklenmesini sağlayı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 |
| Mesaj İş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 İşleyicilerinde 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: 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 | Mesaj İşleyici |
tar -cvzf /tmp/data_CASE#_$(hostname).tar.gz /tmp/rmp_* |
502 Hatalı Ağ Geçidi - yukarı akışa bağlanırken canlı yukarı akış yok
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ı prosedürler hakkında bilgi ve yol gösterici bilgiler sağlanmaktadır.
| Sorun | Günlüklerde 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)
|
502 Hatalı Ağ Geçidi |
Teşhis bilgileri
502 Bad Gateway - no live streams while connecting to upstream ile ilgili Apigee Edge Desteği'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.* |
| Mesaj İş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* |
| Üst çıkış, yığın dökümü ve iş parçacığı dökümleri | Mesaj İşleyici |
Ü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 |
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, 502 Bad Gateway - Unexpected EOF At
Target sorunlarını gidermek ve çözmek için izlenebilecek bazı prosedürler hakkında bilgi ve yol gösterici bilgiler verilmektedir:
| 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 Apigee Edge Desteği'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ı nasıl kullanılır? |
| 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 İş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 | Yönlendirici/Mesaj İşleyici |
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ın giderilmesi ve çözümlenmesi için izlenebilecek bazı prosedürler hakkında bilgi ve yol gösterici bilgiler 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ı hakkında Apigee Edge Desteği'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ı nasıl kullanılır? |
| 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 İş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 Çıktısı | 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 |
| İleti İşleyici'nin anahtar deposu ve güven deposundan alınan 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 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 | Mesaj İşleyici |
tar -cvzf /tmp/data_CASE#_$(hostname).tar.gz /tmp/router* /tmp/rmp_* |