503 Usługa niedostępna – serwer backendu

Narzędzie Trace

1. Włącz sesję śledzenia, i wywołaj interfejs API, aby odtworzyć problem – 503 Service Unavailable.
2. Wybierz jedno z nieudanych żądań i sprawdź ślad.
3. Przejdź przez różne etapy śledzenia i znajdź miejsce, w którym wystąpił błąd.
4. Jeśli okaże się, że błąd 503 jest zwracany jako odpowiedź z serwera docelowego, przyczyną błędu 503 jest serwer docelowy.

   Oto przykładowy zrzut ekranu śledzenia pokazujący odpowiedź 503 Service Unavailable otrzymaną z serwera docelowego:

   
5. Kliknij etap Response received from target server (Odpowiedź otrzymana z serwera docelowego) i sprawdź sekcje Response Headers (Nagłówki odpowiedzi) i Response Content (Treść odpowiedzi), aby sprawdzić, czy zawierają przydatne informacje:
   • Nagłówki odpowiedzi mogą zawierać nagłówek Server (Serwer), który wskazuje skąd została wysłana odpowiedź o błędzie.
   • Treść odpowiedzi może zawierać dodatkowe informacje o tym, dlaczego serwer docelowy wysłał kod odpowiedzi 503.
   
6. Aby potwierdzić, że błąd 503 pochodzi z serwera docelowego, sprawdź wartości X-Apigee-fault-source i X-Apigee-fault-code w fazie AX (Analytics Data Recorded) (Zapisane dane analityczne) w śladzie, wykonując te czynności:
   1. Kliknij fazę AX (Analytics Data Recorded) (Zapisane dane analityczne), jak pokazano na zrzucie ekranu poniżej:
   2. Przewiń w dół do sekcji Phase Details (Szczegóły fazy) do sekcji Response Headers (Nagłówki odpowiedzi) i określ wartości X-Apigee-fault-code i X-Apigee-fault-source , jak pokazano poniżej:
   3. Jeśli wartości X-Apigee-fault-source i X-Apigee-fault-code są zgodne z wartościami podanymi w tabeli poniżej, możesz potwierdzić, że błąd 503 pochodzi z serwera docelowego:

      Nagłówki odpowiedzi	Wartość
      X-Apigee-fault-source	cel
      X-Apigee-fault-code	messaging.adaptors.http.flow.ErrorResponseCode

7. Sprawdź, czy używasz łańcucha proxy, czyli czy serwer docelowy lub punkt końcowy docelowy jest wywoływany przez inne proxy w Apigee. Aby to sprawdzić:
   1. Wróć do fazy Request sent to target server (Żądanie wysłane do serwera docelowego) kliknij przycisk Show Curl (Pokaż Curl) i określ alias hosta serwera docelowego.
   2. Jeśli alias hosta serwera docelowego wskazuje alias hosta wirtualnego, oznacza to łańcuch proxy. W takim przypadku musisz powtórzyć wszystkie powyższe czynności w przypadku proxy w łańcuchu , aż ustalisz, co faktycznie powoduje błąd 503 Service Unavailable. W takich przypadkach błąd 503 Service Unavailable może wystąpić również w innych proxy w łańcuchu na innych etapach, co można zdiagnozować za pomocą tego przewodnika.
   3. Jeśli alias hosta serwera docelowego wskazuje serwer backendu, przejdź do sekcji Rozwiązanie.

Logi dostępu NGINX

Możesz też sprawdzić logi dostępu NGINX, aby określić, czy kod stanu 503 został wysłany przez serwer backendu. Jest to szczególnie przydatne, jeśli problem wystąpił w przeszłości lub jeśli występuje sporadycznie i nie możesz zarejestrować śladu w interfejsie. Aby uzyskać te informacje z logów dostępu NGINX:

1. Sprawdź logi dostępu NGINX.

   /opt/apigee/var/log/edge-router/nginx/<org>~<env>.<port#>_access_log

2. Wyszukaj błędy 503 w przypadku konkretnego proxy interfejsu API w określonym czasie (jeśli problem wystąpił w przeszłości) lub w przypadku żądań, które nadal kończą się niepowodzeniem z powodu błędu 503.
3. Jeśli występują błędy 503, sprawdź, czy pochodzą one z serwera backendu. Jeśli wartości X-Apigee-fault-source i X-Apigee-fault-code są zgodne z wartościami podanymi w tabeli poniżej, błąd 503 pochodzi z serwera backendu:

   Nagłówki odpowiedzi	Wartość
   X-Apigee-fault-source	cel
   X-Apigee-fault-code	messaging.adaptors.http.flow.ErrorResponseCode

   Oto przykładowy wpis pokazujący błąd 503 spowodowany przez serwer docelowy:

   
4. Sprawdź konkretne proxy interfejsu API i upewnij się, że używasz łańcucha proxy czyli czy serwer docelowy lub punkt końcowy docelowy nie wywołuje innego proxy w Apigee. Jeśli używasz łańcucha proxy, musisz powtórzyć wszystkie powyższe czynności w przypadku proxy w łańcuchu, aż ustalisz, co faktycznie powoduje błąd 503 Service Unavailable. W takich przypadkach, błąd 503 Service Unavailable może wystąpić również w innych proxy w łańcuchu na innych etapach, co można zdiagnozować za pomocą tego przewodnika.
5. Jeśli potwierdzisz, że nie używasz łańcucha proxy, a błąd 503 pochodzi z twojego serwera backendu, przejdź do sekcji Rozwiązanie.

Wywołanie serwera backendu

Możesz bezpośrednio wywołać serwer backendu i sprawdzić, czy otrzymujesz tę samą 503 Service Unavailable odpowiedź, która została odebrana, gdy żądanie zostało wysłane przez Apigee Edge.

1. Upewnij się, że masz wszystkie wymagane nagłówki, parametry zapytania i dane logowania, które muszą zostać przekazane do serwera backendu w ramach żądania.
2. Jeśli usługa backendu jest publicznie dostępna, możesz użyć polecenia curl, Postmana lub innego klienta REST i bezpośrednio wywołać interfejs API serwera backendu.
3. Jeśli serwer backendu jest dostępny tylko z procesorów komunikatów, możesz użyć polecenia curl, Postmana lub innego klienta REST i bezpośrednio wywołać interfejs API serwera backendu z procesora komunikatów.
4. Sprawdź, czy usługa backendu rzeczywiście zwraca błąd 503 Service Unavailable.