Problemy z czasem działania

Przeglądasz dokumentację Apigee Edge.
Przejdź do Dokumentacja Apigee X. informacje.

wszelkie błędy, problemy z opóźnieniami lub nieoczekiwane wyniki zaobserwowane podczas wykonywania interfejsu API; są określane jako problemy runtime.

Błędy 4XX/5XX

Poradnik

Ta sekcja zawiera informacje i wskazówki dotyczące określonych procedur, które można te instrukcje dotyczące rozwiązywania problemów i rozwiązywania błędów 4XX i 5XX środowiska wykonawczego.

Odpowiedź/komunikat o błędzie Kod błędu Poradnik
HTTP/1.1 500 Internal Server Error Zależy od rzeczywistego błędu 500 – wewnętrzny błąd serwera

i

500 Wewnętrzny błąd serwera – strumieniowe przesyłanie danych włączone
HTTP/1.1 503 Service Unavailable messaging.adaptors.http.flow.ServiceUnavailable 503 Usługa niedostępna
HTTP/1.1 503 Service Unavailable messaging.adaptors.http.flow.NoActiveTargets 503 Usługa niedostępna – NoActiveTargets
HTTP/1.1 503 Service Unavailable messaging.adaptors.http.flow.NoActiveTargets

(Przyczyna jest spowodowana niepowodzeniem kontroli stanu)

 503 Usługa niedostępna – NoActiveTargets Niepowodzenie kontroli stanu
HTTP/1.1 503 Service Unavailable

(z serwera backendu)

messaging.adaptors.http.flow.ErrorResponseCode 503 Usługa niedostępna – serwer backendu
HTTP/1.1 504 Gateway Timeout messaging.adaptors.http.flow.GatewayTimeout 504 Przekroczono limit czasu bramy
HTTP/1.1 504 Gateway Timeout

(z serwera backendu)

messaging.adaptors.http.flow.ErrorResponseCode 504 Upłynął limit czasu bramy – serwer backendu

Informacje diagnostyczne

Jeśli potrzebujesz pomocy zespołu pomocy Apigee Edge w przypadku 4XX błędów środowiska wykonawczego (np. 400, 401, 404 i 499) lub Błędy 5XX (takie jak 500, 503 i 504), a następnie zbierz i udostępnij następujące rejestry diagnostyczne i informacje w zgłoszeniu do zespołu pomocy:

Informacje diagnostyczne: Gdzie mogę zebrać te informacje? Jak zebrać te informacje?
Dane wyjściowe narzędzia do śledzenia obejmujące nieudane żądania do interfejsu API Interfejs Edge Jak korzystać z narzędzia Trace Tool
Logi routera 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.*
Logi procesora wiadomości procesor komunikatów 
tar cvzf /tmp/rmp_systemlogs_$(hostname)_$(date +%Y.%m.%d_%H.%M.%S).tar.gz /opt/apigee/var/log/edge-message-processor/logs/system*
Skompresuj wszystkie dane diagnostyczne 
>tar -cvzf /tmp/data_CASE#_$(hostname).tar.gz /tmp/router* /tmp/rmp_*

400 Błąd nieprawidłowego żądania – błąd certyfikatu SSL

Poradnik

W tej sekcji znajdziesz informacje i wskazówki dotyczące określonych procedur, które można a potem postępuj zgodnie z instrukcjami dotyczącymi rozwiązywania problemów z 400 Bad Request - SSL Certificate Error.

Komunikat o błędzie Poradnik 
<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 Błąd nieprawidłowego żądania – błąd certyfikatu SSL

Informacje diagnostyczne:

Jeśli potrzebujesz pomocy zespołu pomocy Apigee Edge na urządzeniu 400 Bad Request - SSL Certificate Error, zbierz poniższe informacje diagnostyczne i udostępnij je w zgłoszeniu do zespołu pomocy:

Informacje diagnostyczne: Gdzie mogę zebrać te informacje? Jak zebrać te informacje?
Logi routera 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

Przechwyć pakiety sieciowe za pomocą polecenia tcpdump na routerze routera:

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

Skompresuj tcpdump: 

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

Przechwyć pakiety sieciowe na komputerze klienckim przy użyciu polecenia tcpdump:

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

Skompresuj tcpdump:

tar cvzf /tmp/client_tcpdumps_$(hostname)_$(date +%Y.%m.%d_%H.%M.%S).tar.gz /tmp/router_tcpdump_$(hostname).pcap
Skompresuj wszystkie dane diagnostyczne Router 
tar -cvzf /tmp/data_CASE#_$(hostname).tar.gz /tmp/router*

404 Nie można zidentyfikować serwera proxy dla błędu hosta

Poradnik

Ta sekcja zawiera informacje i wskazówki dotyczące określonych procedur, które można postępuje zgodnie z instrukcjami w celu rozwiązania problemu i rozwiązania problemu 404 Unable to identify proxy for host .

Komunikat o błędzie lub opis Kod błędu Poradnik 
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 Nie udało się zidentyfikować serwera proxy dla hosta

Informacje diagnostyczne:

Jeśli potrzebujesz pomocy zespołu pomocy Apigee Edge w przypadku błędu 404 Unable to identify proxy for host, zbierz poniższe informacje diagnostyczne i udostępnij je w zgłoszenie do zespołu pomocy:

Informacje diagnostyczne: Gdzie mogę zebrać te informacje? Jak zebrać te informacje?
Dane wyjściowe interfejsu Deployments API Serwer zarządzania 
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
Dane wyjściowe interfejsu API i drzewa klasyfikacji procesor komunikatów

Pobierz środowiska dla określonej organizacji:

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

Pobierz wersje wdrożone dla określonego serwera proxy interfejsu 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

Pobierz drzewo klasyfikacji:

curl -s 0:8082/v1/classification/tree > /tmp/rmp_classification_tree_$(hostname)_$(date +%Y.%m.%d_%H.%M.%S).json
Logi procesora wiadomości procesor komunikatów 
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*
Zrzuty stosu procesorów wiadomości procesor komunikatów

Pobierz zrzut stosu na żywo:

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)

Skompresuj zrzut stosu:

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
Skompresuj wszystkie dane diagnostyczne procesor komunikatów 
tar -cvzf /tmp/data_CASE#_$(hostname).tar.gz /tmp/rmp_*

502 Nieprawidłowa brama – brak transmisji na żywo podczas łączenia z siecią nadrzędną

Poradnik

Ta sekcja zawiera informacje i wskazówki dotyczące określonych procedur, które można a potem postępuj zgodnie z instrukcjami dotyczącymi rozwiązywania problemów z 502 Bad Gateway - no live upstreams while connecting to upstream.

Problem Komunikat o błędzie w logach Poradnik 
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>

W logach błędów NGINX pojawi się ten błąd:

(/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 Nieprawidłowa brama

Informacje diagnostyczne:

Jeśli potrzebujesz wsparcia zespołu pomocy Apigee Edge na: 502 Bad Gateway - no live streams while connecting to upstream, a następnie te informacje diagnostyczne i udostępnij je w zgłoszeniu do zespołu pomocy:

Informacje diagnostyczne: Gdzie mogę zebrać te informacje? Jak zebrać te informacje?
Logi routera 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.*
Logi procesora wiadomości procesor komunikatów 
tar cvzf /tmp/rmp_systemlogs_$(hostname)_$(date +%Y.%m.%d_%H.%M.%S).tar.gz /opt/apigee/var/log/edge-message-processor/logs/system*
Najważniejsze dane wyjściowe, zrzut stosu i zrzuty wątków procesor komunikatów

Wyświetl główne dane wyjściowe polecenia:

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

Pobierz zrzut stosu:

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

Pobierz zrzut wątku:

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
Skompresuj wszystkie dane diagnostyczne 
tar -cvzf /tmp/data_CASE#_$(hostname).tar.gz /tmp/router* /tmp/rmp_* /opt/apigee/var/rmp_heapdump_*

502 Nieprawidłowa brama – nieoczekiwany EOF w miejscu docelowym

Poradnik

Ta sekcja zawiera informacje i wskazówki dotyczące określonych procedur, które można postępuj zgodnie z instrukcjami dotyczącymi rozwiązywania problemów z 502 Bad Gateway - Unexpected EOF At Target:

Odpowiedź lub komunikat o błędzie Kod błędu Poradnik 
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 Nieprawidłowa brama Nieoczekiwany EOF

Informacje diagnostyczne:

Jeśli potrzebujesz pomocy zespołu pomocy Apigee Edge na 502 Bad Gateway - Unexpected EOF At Target, Zbierz te informacje diagnostyczne i udostępnij je w zgłoszeniu do zespołu pomocy:

Informacje diagnostyczne: Gdzie mogę zebrać te informacje? Jak zebrać te informacje?
Dane wyjściowe narzędzia do śledzenia obejmujące nieudane żądania do interfejsu API Interfejs Edge Jak korzystać z narzędzia Trace Tool
Logi routera 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.*
Logi procesora wiadomości procesor komunikatów 
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 procesor komunikatów 
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
Skompresuj wszystkie dane diagnostyczne Router/procesor wiadomości 
tar -cvzf /tmp/data_CASE#_$(hostname).tar.gz /tmp/router* /tmp/rmp_*

Nieudane uzgadnianie połączenia TLS

Poradnik

Ta sekcja zawiera informacje i wskazówki dotyczące określonych procedur, które można a następnie w celu rozwiązywania problemów związanych z nieudanymi uzgadnianiem połączenia TLS/SSL:

Komunikat o błędzie Poradnik
Received fatal alert: handshake_failure Nieudane uzgadnianie połączenia TLS/SSL
Received fatal alert: bad_certificate Błędy uzgadniania połączenia SSL – nieprawidłowy certyfikat klienta

Informacje diagnostyczne:

Jeśli potrzebujesz pomocy zespołu pomocy Apigee Edge w przypadku niepowodzeń uzgadniania połączenia TLS/SSL, zbierz te informacje diagnostyczne i udostępnij je w zgłoszeniu do zespołu pomocy:

Informacje diagnostyczne: Gdzie mogę zebrać te informacje? Jak zebrać te informacje?
Dane wyjściowe narzędzia do śledzenia obejmujące nieudane żądania do interfejsu API Interfejs Edge Jak korzystać z narzędzia Trace Tool
Logi routera 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.*
Logi procesora wiadomości procesor komunikatów 
tar cvzf /tmp/rmp_systemlogs_$(hostname)_$(date +%Y.%m.%d_%H.%M.%S).tar.gz /opt/apigee/var/log/edge-message-processor/logs/system*
Dane wyjściowe polecenia OpenSSL procesor komunikatów

Serwer backendu bez SNI:

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

Serwer backendu z włączonym 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 procesor komunikatów 
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
Certyfikaty z magazynu kluczy i magazynu zaufania podmiotu przetwarzającego wiadomości Serwer zarządzania

Pobierz szczegóły certyfikatu z magazynu kluczy:

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

Pobierz szczegóły certyfikatu z Truststore:

curl -v http://MANAGEMENT_SERVER_HOSTPORT/v1/organizations/ORGNAME/environments/ENVNAME/keystores/TRUSTSTORENAME/certs/CERTNAME -u USERNAME
Skompresuj wszystkie dane diagnostyczne procesor komunikatów 
tar -cvzf /tmp/data_CASE#_$(hostname).tar.gz /tmp/router* /tmp/rmp_*