503 Dienst nicht verfügbar – Back-End-Server

Trace-Tool

1. Aktivieren Sie die Trace-Sitzung, und führen Sie den API-Aufruf aus, um das Problem zu reproduzieren: 503 Service Unavailable.
2. Wählen Sie eine der fehlgeschlagenen Anfragen aus und untersuchen Sie den Trace.
3. Navigieren Sie durch die verschiedenen Phasen des Traces und suchen Sie nach der Stelle, an der der Fehler aufgetreten ist.
4. Wenn der 503-Fehler als Antwort vom Zielserver zurückgegeben wird, ist der Zielserver die Ursache für den 503-Fehler.

   Hier sehen Sie einen Beispiel-Trace-Screenshot mit der Antwort „503 Service Unavailable“ vom Zielserver:

   
5. Klicken Sie auf die Phase Response received from target server (Antwort vom Zielserver empfangen) und sehen Sie sich die Abschnitte „Response Headers“ (Antwortheader) und „Response Content“ (Antwortinhalt) an, um festzustellen, ob sie nützliche Informationen enthalten:
   • Die Antwortheader können den Serverheader enthalten, der angibt von wo die Fehlerantwort gesendet wurde.
   • Der Antwortinhalt kann zusätzliche Informationen dazu enthalten, warum der Zielserver den Antwortcode 503 gesendet hat.
   
6. Bestätigen Sie, dass der 503-Fehler vom Zielserver stammt, indem Sie die Werte von X-Apigee-fault-source und X-Apigee-fault-code in der Phase AX (Analytics Data Recorded) im Trace anhand der folgenden Schritte prüfen:
   1. Klicken Sie auf die Phase AX (Analytics Data Recorded), wie im Screenshot unten gezeigt:
   2. Scrollen Sie in den Phasen-Details nach unten zum Abschnitt „Response Headers“ (Antwortheader) und ermitteln Sie die Werte von X-Apigee-fault-code und X-Apigee-fault-source wie unten gezeigt:
   3. Wenn die Werte von X-Apigee-fault-source und X-Apigee-fault-code mit den Werten in der folgenden Tabelle übereinstimmen, können Sie bestätigen, dass der 503-Fehler vom Zielserver stammt:

      Antwortheader	Wert
      X-Apigee-fault-source	Ziel
      X-Apigee-fault-code	messaging.adaptors.http.flow.ErrorResponseCode

7. Prüfen Sie, ob Sie die Proxy-Verkettung verwenden, d.h. ob der Zielserver/Zielendpunkt einen anderen Proxy in Apigee aufruft. So ermitteln Sie das:
   1. Kehren Sie zur Phase Request sent to target server (Anfrage an Zielserver gesendet) zurück und klicken Sie auf die Schaltfläche Show Curl (Curl anzeigen). Ermitteln Sie den Hostalias des Zielservers.
   2. Wenn der Hostalias des Zielservers auf einen Alias des virtuellen Hosts verweist, handelt es sich um eine Proxy-Verkettung. In diesem Fall müssen Sie alle oben genannten Schritte für den verketteten Proxy wiederholen, bis Sie die tatsächliche Ursache für den 503-Fehler (Service Unavailable) ermittelt haben. In diesen Fällen kann der 503-Fehler (Service Unavailable) auch in anderen verketteten Proxys in anderen Phasen auftreten. Sie können ihn mit diesem Playbook diagnostizieren.
   3. Wenn der Hostalias des Zielservers auf Ihren Backend-Server verweist, fahren Sie mit dem Abschnitt Auflösung fort.

NGINX-Zugriffslogs

Sie können auch in den NGINX-Zugriffslogs nachsehen, ob der Statuscode 503 vom Backend-Server gesendet wurde. Dies ist besonders hilfreich, wenn das Problem in der Vergangenheit aufgetreten ist oder wenn es sich um ein nur gelegentlich auftretendes Problem handelt und Sie den Trace nicht in der Benutzeroberfläche erfassen können. Führen Sie die folgenden Schritte aus, um diese Informationen aus den NGINX-Zugriffslogs zu ermitteln:

1. Prüfen Sie die NGINX-Zugriffslogs.

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

2. Suchen Sie nach 503-Fehlern für den jeweiligen API-Proxy während eines bestimmten Zeitraums (wenn das Problem in der Vergangenheit aufgetreten ist) oder nach Anfragen, die immer noch mit dem Statuscode 503 fehlschlagen.
3. Wenn 503-Fehler vorhanden sind, prüfen Sie, ob der Fehler vom Backend-Server stammt. Wenn die Werte von X-Apigee-fault-source und X-Apigee-fault-code mit den Werten in der folgenden Tabelle übereinstimmen, stammt der 503-Fehler vom Backend-Server:

   Antwortheader	Wert
   X-Apigee-fault-source	Ziel
   X-Apigee-fault-code	messaging.adaptors.http.flow.ErrorResponseCode

   Hier sehen Sie einen Beispielseintrag, der den 503-Fehler zeigt, der vom Zielserver verursacht wurde:

   
4. Prüfen Sie den jeweiligen API-Proxy und stellen Sie sicher, dass Sie die Proxy-Verkettung verwenden, d.h. ob der Zielserver/Zielendpunkt einen anderen Proxy in Apigee aufruft. Wenn Sie die Proxy-Verkettung verwenden, müssen Sie alle oben genannten Schritte für den verketteten Proxy wiederholen, bis Sie die tatsächliche Ursache für den 503-Fehler (Service Unavailable) ermittelt haben. In diesen Fällen kann der 503-Fehler (Service Unavailable) auch in anderen verketteten Proxys in anderen Phasen auftreten. Sie können ihn mit diesem Playbook diagnostizieren.
5. Wenn Sie bestätigen, dass Sie die Proxy-Verkettung nicht verwenden und der 503-Fehler von Ihrem Backend-Server stammt, fahren Sie mit dem Abschnitt Auflösung fort.

Aufruf des Backend-Servers

Sie können einen direkten Aufruf an den Backend-Server senden und prüfen, ob Sie dieselbe Antwort „503 Service Unavailable“ erhalten wie bei der Anfrage über Apigee Edge.

1. Achten Sie darauf, dass Sie alle erforderlichen Header, Abfrageparameter und Anmeldedaten haben, die an den Backend-Server als Teil der Anfrage übergeben werden müssen.
2. Wenn der Backend-Dienst öffentlich zugänglich ist, können Sie den Befehl „curl“, Postman oder einen anderen REST-Client verwenden und die Backend-Server-API direkt aufrufen.
3. Wenn der Backend-Server nur über die Message Processors zugänglich ist, können Sie den Befehl „curl“, Postman oder einen anderen REST-Client verwenden und die Backend-Server-API direkt vom Message Processor aufrufen.
4. Prüfen Sie, ob der Backend-Dienst tatsächlich den Fehler „503 Service Unavailable“ zurückgibt.