503 Usługa niedostępna – brak aktywnych celów

Wyświetlasz dokumentację Apigee Edge.
Otwórz dokumentację Apigee X. info

Filmy

Więcej informacji o błędach 503 znajdziesz w tych filmach:

Krótki opis problemu

Aplikacja kliencka otrzymuje kod stanu odpowiedzi HTTP 503 z komunikatem Usługa niedostępna i kodem błędu NoActiveTargets w przypadku żądań do proxy interfejsu API.

Komunikat o błędzie

Zobaczysz tę odpowiedź o błędzie:

HTTP/1.1 503 Service Unavailable
  

W odpowiedzi HTTP zobaczysz ten komunikat o błędzie:

{
   "fault": {
      "faultstring": "The Service is temporarily unavailable",
      "detail": {
           "errorcode": "messaging.adaptors.http.flow.NoActiveTargets"
       }
    }
}
  

Możliwe przyczyny

Odpowiedź HTTP 503: Usługa niedostępna z kodem błędu NoActiveTargets jest zwykle obserwowana gdy w konfiguracji punktu końcowego docelowego w proxy interfejsu API używasz co najmniej 1 serwera docelowego.

W tabeli poniżej znajdziesz możliwe przyczyny odpowiedzi 503: Usługa niedostępna z kodem błędu NoActiveTargets :

Przyczyna: serwer docelowy jest wyłączony

Jeśli wszystkie serwery docelowe określone w konfiguracji punktu końcowego docelowego są wyłączone, otrzymasz odpowiedź 503: Usługa niedostępna z kodem błędu NoActiveTargets.

Diagnostyka

1. Określ nazwę serwera docelowego używanego w konkretnej konfiguracji punktu końcowego docelowego w przypadku proxy interfejsu API, które nie działa, korzystając z jednej z tych metod:
1. Jeśli jest tylko 1 punkt końcowy docelowy, sprawdź go.
2. Jeśli jest wiele punktów końcowych docelowych i nie masz pewności, który z nich ma wyłączony serwer docelowy, wykonaj te czynności:
1. Włącz sesję śledzenia, wykonaj wywołanie interfejsu API i odtwórz problem – 503: Usługa niedostępna.
2. W śledzeniu otwórz Rozpoczęto przepływ żądania docelowego i określ nazwę punktu końcowego docelowego, jak pokazano poniżej:



2. Po zidentyfikowaniu punktu końcowego docelowego pobierz nazwę serwera docelowego używanego w konfiguracji punktu końcowego docelowego, jak pokazano w przykładzie poniżej:

   <TargetEndpoint name="default">>
     <HTTPTargetConnection>
       <LoadBalancer>
         <Server name="demo-target" />
       </LoadBalancer>
       <Path>/test</Path>
     </HTTPTargetConnection>
   </TargetEndpoint>
         

   W powyższym przykładzie jest 1 serwer docelowy o nazwie demo-target.

3. Pobierz definicję każdego serwera docelowego używanego w docelowym punkcie końcowym za pomocą interfejsu Edge lub wywołania interfejsu API Edge.

   Interfejs Edge

   Aby pobrać definicję za pomocą interfejsu Edge:

   1. Otwórz Administracja > Środowiska > Serwery docelowe.
   2. Wybierz środowisko, w którym występuje błąd.
   3. Wyszukaj nazwę serwera docelowego, aby uzyskać jego definicję.

      Na przykład wpisz nazwę serwera docelowego demo-target. Zobaczysz jego definicję, jak pokazano poniżej:

      

      Zwróć uwagę, że serwer docelowy demo-target ma alias hosta, numer portu i włączony protokół SSL. Jednak sam serwer docelowy jest wyłączony , co jest oznaczone przez wyszarzony element ENABLED.

   Interfejs Edge API

   Aby pobrać definicję za pomocą interfejsu Edge API:

   Użyj interfejsu Get TargetServer API, aby pobrać definicję serwera docelowego.

   Dane wyjściowe definicji serwera docelowego

   <TargetServer name="demo-target">
     <Host>demo-target.apigee.net</Host>
     <Port>443</Port>
     <IsEnabled>false</IsEnabled>
     <SSLInfo>
         <Enabled>true</Enabled>
     </SSLInfo>
   </TargetServer>
             

   Dane wyjściowe interfejsu Apigee API wskazują, że serwer docelowy demo-target jest wyłączony , ponieważ element IsEnabled ma wartość false.

   Ponieważ serwer docelowy jest wyłączony, procesor komunikatów natychmiast wyśle do klienta odpowiedź 503: Usługa niedostępna z kodem błędu NoActiveTargets.

Rozdzielczość

Upewnij się, że serwery docelowe używane w konfiguracji punktu końcowego docelowego w proxy interfejsu API są zawsze włączone.

<TargetServer name="demo-target">
  <Host>demo-target.apigee.net</Host>
  <Port>443</Port>
  <IsEnabled>true</IsEnabled>
  <SSLInfo>
      <Enabled>true</Enabled>
  </SSLInfo>
</TargetServer>
        

Jeśli problem nadal występuje, przejdź do sekcji Informacje diagnostyczne, które należy zebrać.

Diagnozowanie problemów za pomocą monitorowania interfejsu API

Monitorowanie interfejsu API umożliwia szybkie izolowanie obszarów problemowych w celu diagnozowania błędów, problemów z wydajnością i opóźnieniami oraz ich źródła, takiego jak aplikacje deweloperów, proxy interfejsu API, cele backendu lub platforma interfejsu API.

Zapoznaj się z przykładowym scenariuszem który pokazuje, jak rozwiązywać problemy z kodem 5xx w interfejsach API za pomocą monitorowania interfejsu API. Możesz na przykład skonfigurować alert, aby otrzymywać powiadomienia, gdy liczba messaging.adaptors.http.flow.NoActiveTargets błędów przekroczy określony próg.

Informacje diagnostyczne, które należy zebrać

Jeśli problem nadal występuje po wykonaniu powyższych instrukcji, zbierz te informacje diagnostyczne. Skontaktuj się z zespołem pomocy Apigee i udostępnij mu te informacje:

1. Jeśli korzystasz z chmury publicznej, podaj te informacje:
1. Nazwa organizacji
2. Nazwa środowiska
3. Nazwa proxy interfejsu API
4. Pełne polecenie curl do odtworzenia błędu
5. Plik śledzenia zawierający żądania z błędem 503: Usługa niedostępna z kodem błędu NoActiveTargets
2. Jeśli korzystasz z chmury prywatnej, podaj te informacje:
   1. Pełny komunikat o błędzie
   2. Nazwa środowiska
   3. Pakiet proxy interfejsu API
   4. Plik śledzenia zawierający żądania z błędem 503: Usługa niedostępna z kodem błędu NoActiveTargets
   5. Dzienniki dostępu NGINX

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

   6. Dzienniki procesora komunikatów

      (/opt/apigee/var/log/edge-message-processor/logs/system.log)