500 Interner Serverfehler – Back-End-Server

Sie lesen gerade die Dokumentation zu Apigee Edge.
Zur Dokumentation zu Apigee X. info

Videos

Symptom

Die Clientanwendung erhält für API-Aufrufe den HTTP-Statuscode 500 mit der Meldung Internal Server Error als Antwort.

Der HTTP-Statuscode 500 ist eine allgemeine Fehlerantwort. Das bedeutet, dass auf dem Server eine unerwartete Bedingung aufgetreten ist, die verhindert hat, dass die Anfrage ausgeführt werden konnte. Dieser Fehler wird in der Regel vom Server zurückgegeben, wenn kein anderer Fehlercode geeignet ist.

Fehlermeldungen

Die Clientanwendung erhält den folgenden Antwortcode:

HTTP/1.1 500 Internal Server Error

Außerdem wird möglicherweise eine Fehlermeldung angezeigt, die der folgenden ähnelt:

{"errorMessage":"Sorry either your e-mail or password didn't match.",
"errorParameters":"{}",
"errorCode":"500",
"errorKey":"INVALID_EMAILPASSWORD"}

<Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
   <Body>
      <Error>
         <code>500</code>
         <message xml:lang="en-US">Not Authorised(e4138fa0-ec57).</message>
      </Error>
   </Body>
</Envelope>

Mögliche Ursachen

Der 500 Internal Server Error kann aus verschiedenen Gründen vom Backend-Server zurückgegeben werden. In diesem Playbook wird erklärt, wie Sie diesen Fehler mit allgemeinen Schritten beheben können, unabhängig von seiner Ursache.

Mögliche Ursachen für dieses Problem sind:

Allgemeine Diagnoseschritte

Verwenden Sie eines der folgenden Tools/Verfahren, um diesen Fehler zu diagnostizieren:

Ursache: Fehler auf dem Backend-Server

Diagnose

Der vom Backend-Server zurückgegebene Fehler 500 Internal Server Error kann verschiedene Ursachen haben. Sie müssen jede Situation unabhängig voneinander diagnostizieren.

1. Ermitteln Sie den Fehlercode und die Fehlerquelle für den beobachteten Fehler mit dem API-Monitoring, dem Trace-Tool oder den NGINX-Zugriffsprotokollen, wie unter Allgemeine Diagnoseschritte beschrieben.
2. Wenn die Fehlerquelle target und der Fehlercode messaging.adaptors.http.flow.ErrorResponseCode ist, wird der Fehler vom Backend-Server zurückgegeben.
3. Sie können eine der folgenden Maßnahmen ausführen, um die Ursache des Problems zu diagnostizieren:

   Trace

   Trace verwenden :

   Wenn Sie eine Trace-Sitzung für den Fehler haben, führen Sie die folgenden Schritte aus:

   1. Wählen Sie in der Trace die API-Anfrage aus, die mit 500 Internal Server Error fehlgeschlagen ist.

   2. Wählen Sie die Phase Response received from target server aus der fehlgeschlagenen API-Anfrage aus, wie in der folgenden Abbildung gezeigt:

      ( größeres Bild ansehen)

      

   3. Scrollen Sie nach unten zum Phasendetails Abschnitt und prüfen Sie den Antwortinhalt, der die Antwort vom Backend-Server enthält.

      Beispiel für Antwortinhalt :

      <Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
         <Body>
            <Error>
               <code>500</code>
               <message xml:lang="en-US">Not Authorised(e4138fa0-ec57).</message>
            </Error>
         </Body>
      </Envelope>

      In der obigen Antwort ist die Fehlermeldung vom Backend-Server Not Authorised. Das bedeutet, dass der Nutzer möglicherweise ungültige Anmeldedaten angegeben hat und daher diesen Fehler erhält.

   Backend-Server aufrufen

   Direkter Aufruf des Backend-Servers :

   Sie können den Backend-Server direkt aufrufen und:

   • prüfen, ob Sie dieselbe 500 Internal Server Error Antwort erhalten wie bei der Anfrage über Apigee Edge
   • die vom Backend-Server empfangene Fehlermeldung (Antwort) prüfen

   Führen Sie die folgenden Schritte aus, um den Backend-Server direkt aufzurufen:

   1. Achten Sie darauf, dass Sie alle erforderlichen Header, Abfrageparameter und alle Anmeldedaten haben, die im Rahmen der Anfrage an den Backend-Server übergeben werden müssen.
   2. Wenn der Backend-Dienst öffentlich zugänglich ist, können Sie den curl Befehl, 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 verwenden, Postman oder einen anderen REST-Client und die Backend-Server-API direkt vom Message Processor aus aufrufen.

   4. Prüfen Sie, ob der Backend-Dienst tatsächlich 500 Internal Server Error zurückgibt, prüfen Sie die vom Backend-Server zurückgegebene Fehlermeldung (Antwort) und ermitteln Sie die Ursache für diesen Fehler.

   Backend-Serverprotokolle

   Backend-Serverprotokolle verwenden

   1. Prüfen Sie die Backend-Serverprotokolle und versuchen Sie, weitere Details zum Fehler und seiner Ursache zu erhalten.
   2. Aktivieren Sie nach Möglichkeit den Debug-Modus auf dem Backend-Server, um weitere Details zum Fehler und zur Ursache zu erhalten.

4. Prüfen Sie, ob Sie im spezifischen Zielendpunkt des fehlgeschlagenen API-Proxys eine Proxyverkettung verwenden. Das heißt, ob der Zielserver/Zielendpunkt einen anderen Proxy in Apigee Edge aufruft. So ermitteln Sie das:

   1. Wenn Sie die Trace für die fehlgeschlagene Anfrage haben, gehen Sie zur Phase Request sent to target server und klicken Sie auf Show Curl.

      
   2. Das Fenster Curl for Request Sent to Target Server wird geöffnet. Hier können Sie den Hostalias des Zielservers ermitteln.
   3. Prüfen Sie den Zielendpunkt Ihres API-Proxys und prüfen Sie, ob die Backend-Server URL oder der Hostname auf dem Zielserver auf einen anderen Proxy oder Ihren eigenen Backend-Server verweist.
   4. Wenn der Hostalias des Zielservers auf einen Alias des virtuellen Hosts verweist, handelt es sich um eine Proxyverkettung. 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 Fehler 500 Internal Server Error ermittelt haben. In diesen Fällen kann 500 Internal Server Error auch in anderen verketteten Proxys in anderen Phasen auftreten. Diese können mit den Anweisungen in diesem Playbook oder im Playbook 500 Internal Server Error diagnostiziert und behoben werden.
   5. Wenn der Hostalias des Zielservers auf Ihren Backend-Server verweist, fahren Sie mit Auflösung fort.

Auflösung

Wenn festgestellt wird, dass der Fehler 500 vom Backend-Server stammt, arbeiten Sie mit Ihrem Backend-Server-Team zusammen, um das Problem entsprechend zu beheben.

Im oben beschriebenen Beispiel müssen Sie möglicherweise die Nutzer auffordern, gültige Anmeldedaten anzugeben, um dieses Problem zu beheben.

Wichtige Hinweise

1. Die tatsächliche Fehlermeldung, die vom Backend-Server für 500 Internal Server Error zurückgegeben wird, kann nur angezeigt werden, wenn Sie die Trace-Sitzung für die fehlgeschlagenen Anfragen erfasst haben.
2. Die Antwort des Backend-Servers wird aus Sicherheitsgründen nicht in API-Monitoring, NGINX-Zugriffsprotokollen oder Nachrichtenverarbeiterprotokollen protokolliert.
3. Sie können die Backend-Serverprotokolle prüfen oder den Debug-Modus auf dem Backend-Server aktivieren, um weitere Details zum 500 Internal Server Error zu erhalten und/oder die vom Backend-Server zurückgegebene Fehlermeldung anzusehen.

Erfassen von Diagnoseinformationen erforderlich

Wenn das Problem auch nach Befolgen der obigen Anweisungen weiterhin besteht, erfassen Sie die folgenden Diagnoseinformationen und wenden Sie sich an den Apigee Edge-Support.

Wenn Sie Nutzer der Public Cloud sind, geben Sie die folgenden Informationen an:

• Name der Organisation
• Name der Umgebung
• Name des API-Proxys
• Vollständiger curl-Befehl zum Reproduzieren des Fehlers 500
• Trace-Datei mit den Anfragen mit 500 Internal Server Error
• Wenn die 500 Fehler derzeit nicht auftreten, geben Sie den Zeitraum mit den Zeitzoneninformationen an, in dem die 500 Fehler in der Vergangenheit aufgetreten sind.

Wenn Sie Nutzer der Private Cloud sind, geben Sie die folgenden Informationen an:

• Vollständige Fehlermeldung für die fehlgeschlagenen Anfragen
• Name der Organisation, der Umgebung und des API-Proxys, für die Sie 500 Fehler beobachten
• API-Proxy-Bundle
• Trace-Datei mit den Anfragen mit 500 Internal Server Error
• NGINX-Zugriffsprotokolle /opt/apigee/var/log/edge-router/nginx/ORG~ENV.PORT#_access_log

  Dabei gilt: ORG, ENV, und PORT# werden durch die tatsächlichen Werte ersetzt.

• Systemprotokolle des Message Processors /opt/apigee/var/log/edge-message-processor/logs/system.log
• Der Zeitraum mit den Zeitzoneninformationen, in dem die Fehler 500 aufgetreten sind.