Wyświetlasz dokumentację Apigee Edge.
Otwórz dokumentację Apigee X. info
Wszelkie błędy, problemy z opóźnieniami lub nieoczekiwane wyniki zaobserwowane podczas wykonywania żądań interfejsu API są określane jako runtime.
Błędy 4XX/5XX
Scenariusz
W tej sekcji znajdziesz informacje i wskazówki dotyczące konkretnych procedur, które można zastosować do rozwiązywania problemów i błędów czasu działania 4XX i 5XX.
| Odpowiedź lub komunikat o błędzie | Kod błędu | Scenariusz |
|---|---|---|
HTTP/1.1 500 Internal Server Error |
Zależy od konkretnego błędu |
500 Wewnętrzny błąd serwera
i 500 Wewnętrzny błąd serwera – przesyłanie strumieniowe 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
(Przyczyną są nieudane kontrole stanu) |
503 Usługa niedostępna – błędy sprawdzania stanu NoActiveTargets |
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 Przekroczono limit czasu bramy – serwer backendu |
Informacje diagnostyczne
Jeśli potrzebujesz pomocy zespołu pomocy Apigee Edge w sprawie błędów środowiska wykonawczego 4XX (takich jak 400, 401, 404 i 499) lub błędów 5XX (takich jak 500, 503 i 504), zbierz i udostępnij w zgłoszeniu do zespołu pomocy te dzienniki diagnostyczne i informacje:
| Informacje diagnostyczne: | Gdzie mogę znaleźć te informacje? | Jak mogę zebrać te informacje? |
|---|---|---|
| Dane wyjściowe narzędzia śledzącego rejestrujące nieudane żądania do interfejsu API | Interfejs Edge | Jak korzystać z narzędzia Trace |
| 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.* |
| Dzienniki procesora komunikatów | 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* |
| Kompresowanie wszystkich danych diagnostycznych |
>tar -cvzf /tmp/data_CASE#_$(hostname).tar.gz /tmp/router* /tmp/rmp_* |
Błąd 400: Nieprawidłowe żądanie – błąd certyfikatu SSL
Scenariusz
W tej sekcji znajdziesz informacje i wskazówki dotyczące konkretnych procedur, które można zastosować w celu rozwiązywania problemów z 400 Bad Request - SSL Certificate Error.
| Komunikat o błędzie | Scenariusz |
|---|---|
<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> |
Błąd 400 „Nieprawidłowe żądanie” – błąd certyfikatu SSL |
Informacje diagnostyczne:
Jeśli potrzebujesz pomocy zespołu pomocy Apigee Edge w sprawie 400 Bad Request - SSL Certificate
Error, zbierz te informacje diagnostyczne i podaj je w zgłoszeniu do zespołu pomocy:
| Informacje diagnostyczne: | Gdzie mogę znaleźć te informacje? | Jak mogę 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 sudo tcpdump -s 0 -i any host CLIENT_HOST_IP_ADDRESS -w /tmp/router_tcpdump_$(hostname).pcap Skompresuj tar cvzf /tmp/router_tcpdumps_$(hostname)_$(date +%Y.%m.%d_%H.%M.%S).tar.gz /tmp/router_tcpdump_$(hostname).pcap |
Tcpdumps |
Komputer klienta |
Przechwyć pakiety sieciowe za pomocą polecenia tcpdump na komputerze klienckim: sudo tcpdump -s 0 -i any host VIRTUAL_HOST_ALIAS -w /tmp/client_tcpdump_$(hostname).pcap Skompresuj tar cvzf /tmp/client_tcpdumps_$(hostname)_$(date +%Y.%m.%d_%H.%M.%S).tar.gz /tmp/router_tcpdump_$(hostname).pcap |
| Kompresowanie wszystkich danych diagnostycznych | Router |
tar -cvzf /tmp/data_CASE#_$(hostname).tar.gz /tmp/router* |
Błąd 404 Nie udało się zidentyfikować serwera proxy dla hosta
Scenariusz
W tej sekcji znajdziesz informacje i wskazówki dotyczące konkretnych procedur, które można zastosować w celu rozwiązywania problemów i 404 Unable to identify proxy for host
błędów.
| Komunikat o błędzie lub opis | Kod błędu | Scenariusz |
|---|---|---|
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 rozwiązaniu problemu z błędem 404 Unable to identify proxy for
host, zbierz te informacje diagnostyczne i podaj je w zgłoszeniu:
| Informacje diagnostyczne: | Gdzie mogę znaleźć te informacje? | Jak mogę 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 załadowane w 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 wdrożone wersje konkretnego 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 |
| Dzienniki procesora komunikatów | 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 sterty w procesorach wiadomości | procesor komunikatów |
Uzyskaj 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 sterty: 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 |
| Kompresowanie wszystkich danych diagnostycznych | procesor komunikatów |
tar -cvzf /tmp/data_CASE#_$(hostname).tar.gz /tmp/rmp_* |
502 Nieprawidłowa brama – brak aktywnych połączeń wychodzących podczas łączenia się z połączeniem wychodzącym
Scenariusz
W tej sekcji znajdziesz informacje i wskazówki dotyczące konkretnych procedur, które można zastosować w celu rozwiązywania problemów z 502 Bad Gateway - no live upstreams while
connecting to upstream.
| Problem | Komunikat o błędzie w dziennikach | Scenariusz |
|---|---|---|
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 dziennikach błędów NGINX zobaczysz ten błąd:
(/opt/apigee/var/log/edge-router/nginx/ORGNAME~ENVNAME._error_log)
|
502 Nieprawidłowa brama |
Informacje diagnostyczne:
Jeśli potrzebujesz pomocy zespołu pomocy Apigee Edge w sprawie 502 Bad Gateway - no live streams while connecting to upstream, zbierz następujące informacje diagnostyczne i udostępnij je w zgłoszeniu:
| Informacje diagnostyczne: | Gdzie mogę znaleźć te informacje? | Jak mogę 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.* |
| Dzienniki procesora komunikatów | 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 top, zrzut sterty i zrzuty wątków | procesor komunikatów |
Uzyskaj dane wyjściowe polecenia top: top -H -bn5 > /tmp/rmp_top_output_$(hostname)-$(date +%Y.%m.%d_%H.%M.%S).txt Pobierz zrzut sterty: 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ątków: 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 |
| Kompresowanie wszystkich danych diagnostycznych |
tar -cvzf /tmp/data_CASE#_$(hostname).tar.gz /tmp/router* /tmp/rmp_* /opt/apigee/var/rmp_heapdump_* |
502 Nieprawidłowa brama – nieoczekiwany koniec pliku w miejscu docelowym
Scenariusz
W tej sekcji znajdziesz informacje i wskazówki dotyczące konkretnych procedur, które można zastosować w celu rozwiązywania problemów z 502 Bad Gateway - Unexpected EOF At
Target:
| Odpowiedź lub komunikat o błędzie | Kod błędu | Scenariusz |
|---|---|---|
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 koniec pliku |
Informacje diagnostyczne:
Jeśli potrzebujesz pomocy zespołu pomocy Apigee Edge w sprawie 502 Bad Gateway - Unexpected EOF At Target, zbierz te informacje diagnostyczne i udostępnij je w zgłoszeniu:
| Informacje diagnostyczne: | Gdzie mogę znaleźć te informacje? | Jak mogę zebrać te informacje? |
|---|---|---|
| Dane wyjściowe narzędzia śledzącego rejestrujące nieudane żądania do interfejsu API | Interfejs Edge | Jak korzystać z narzędzia Trace |
| 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.* |
| Dzienniki procesora komunikatów | 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 |
| Kompresowanie wszystkich danych diagnostycznych | Router/procesor komunikatów |
tar -cvzf /tmp/data_CASE#_$(hostname).tar.gz /tmp/router* /tmp/rmp_* |
Nieudane uzgadnianie połączenia TLS
Scenariusz
W tej sekcji znajdziesz informacje i wskazówki dotyczące konkretnych procedur, które można zastosować w celu rozwiązania problemów z nawiązywaniem połączenia TLS/SSL:
| Komunikat o błędzie | Scenariusz |
|---|---|
Received fatal alert: handshake_failure |
Nieudane uzgodnienia połączenia TLS/SSL |
Received fatal alert: bad_certificate |
Nieudane uzgadnianie SSL – nieprawidłowy certyfikat klienta |
Informacje diagnostyczne:
Jeśli potrzebujesz pomocy zespołu pomocy Apigee Edge w sprawie błędów uzgadniania TLS/SSL, zbierz te informacje diagnostyczne i udostępnij je w zgłoszeniu:
| Informacje diagnostyczne: | Gdzie mogę znaleźć te informacje? | Jak mogę zebrać te informacje? |
|---|---|---|
| Dane wyjściowe narzędzia śledzącego rejestrujące nieudane żądania do interfejsu API | Interfejs Edge | Jak korzystać z narzędzia Trace |
| 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.* |
| Dzienniki procesora komunikatów | 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* |
| Wynik polecenia OpenSSL | procesor komunikatów |
Serwer backendu bez włączonego 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łączoną funkcją 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 zaufanych certyfikatów procesora komunikatów | 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 magazynu zaufanych certyfikatów: curl -v http://MANAGEMENT_SERVER_HOSTPORT/v1/organizations/ORGNAME/environments/ENVNAME/keystores/TRUSTSTORENAME/certs/CERTNAME -u USERNAME |
| Kompresowanie wszystkich danych diagnostycznych | procesor komunikatów |
tar -cvzf /tmp/data_CASE#_$(hostname).tar.gz /tmp/router* /tmp/rmp_* |