503 Dienst nicht verfügbar

Sie lesen gerade die Dokumentation zu Apigee Edge.
Apigee X-Dokumentation aufrufen info

Videos

Weitere Informationen zu 503‑Fehlern finden Sie in den folgenden Videos:

Symptom

Die Clientanwendung empfängt nach einem API-Proxy-Aufruf den HTTP-Antwortstatus 503 mit der Meldung Service Unavailable.

Fehlermeldungen

Möglicherweise wird die folgende Fehlermeldung angezeigt:

HTTP/1.1 503 Service Unavailable
      

Möglicherweise wird auch die folgende Fehlermeldung in der HTTP-Antwort angezeigt:

Dienst nicht verfügbar

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

Mögliche Ursachen

Die HTTP-Antwort 503 Service Unavailable mit dem Fehlercode messaging.adaptors.http.flow.ServiceUnavailable tritt auf, wenn beim Message Processor von Apigee Edge Fehler aufgrund von Zeitüberschreitungen bei der Verbindung, falschen Hostnamen oder SSL-Handshake-Fehlern bei der Kommunikation mit dem Backend-Server auftreten.

Mögliche Ursachen für die Antwort 503 Service Unavailable:

Allgemeine Diagnoseschritte

Nachricht-ID der fehlgeschlagenen Anfrage ermitteln

Verbindungsfehler aufgrund einer falschen DNS-Auflösung

Diagnose

1. Nachricht‑ID der fehlgeschlagenen Anfrage ermitteln
2. Suchen Sie im Message Processor-Log (/opt/apigee/var/log/edge-message-processor/logs/system.log) nach der spezifischen Anfragenachricht-ID. Möglicherweise werden die folgenden Fehler angezeigt:
   
   Ein onConnectTimeout-Fehler weist darauf hin, dass der Message Processor innerhalb des voreingestellten Verbindungszeitlimits (Standard: 3 Sekunden) keine Verbindung zum Backend-Server herstellen konnte.

   2019-08-14 09:11:49,314 org:myorg env:prod api:Employees rev:1 messageid:mo-96cf6757a-9401-21-1 NIOThread@0 ERROR HTTP.CLIENT - HTTPClient$Context.onTimeout() : ClientChannel[Connected:]@164162 useCount=1 bytesRead=0 bytesWritten=0 age=3001ms lastIO=3001ms .onConnectTimeout connectAddress=www.abc.com/11.11.11.11  resolvedAddress=www.abc.com/22.22.22.22
   
   2019-08-14 09:11:49,333 org:myorg env:prod api:Employees rev:1 messageid:mo-96cf6757a-9401-21-1 NIOThread@0 ERROR ADAPTORS.HTTP.FLOW - RequestWriteListener.onTimeout() : RequestWriteListener.onTimeout(HTTPRequest@6b393600)
         

3. Notieren Sie sich die aufgelöste IP-Adresse im Fehler onConnectTimeout und prüfen Sie, ob die IP-Adresse für Ihren Backend-Server gültig ist. Wenn die IP-Adresse gültig ist, fahren Sie mit Verbindungsfehler fort.
4. Wenn die IP-Adresse ungültig ist, liegt das höchstwahrscheinlich an Problemen mit der DNS-Auflösung.
5. Wiederholen Sie Schritt 3 und Schritt 4 für einige weitere fehlgeschlagene API-Anfragen und prüfen Sie, ob Sie dieselben oder andere ungültige IP-Adressen sehen.
6. Suchen Sie im Message Processor-Log (/opt/apigee/var/log/edge-message-processor/logs/system.log) nach Nachrichten mit dem Keyword DNS Refresh. Prüfen Sie, ob dem DNS-Cache auf dem Message Processor gelegentlich ungültige oder fehlerhafte IP-Adressen hinzugefügt werden.

   2019-08-14 09:11:49,314 org:myorg env:prod api:Employees rev:1 messageid:mo-96cf6757a-9401-21-1 NIOThread@0 INFO c.a.p.h.d.DNSCachedAddress - DNSCachedAddress.reportDifferences() : DNS Refresh for host: apitarget-uat.schemeweb.co.uk:4436. Added 2 IPs [www.abc.com/22.22.22.22, www.abc.com/33.33.33.33] Removed 1 IPs [www.abc.com/11.11.11.11]
         

7. Dieses Problem kann auftreten, wenn es Probleme mit den autoritativen DNS-Servern oder den in /etc/resolv.conf konfigurierten Nameservern gibt.
   
   In der Regel können ein oder mehrere autoritative DNS-Server für die DNS-Auflösung konfiguriert werden. Wenn keine autoritativen DNS-Server vorhanden sind, wird auf die in /etc/resolv.conf konfigurierte Einrichtung zurückgegriffen und die DNS-Auflösung entsprechend durchgeführt. Wenn die /etc/resolv.conf beispielsweise für die Verwendung bestimmter Nameserver konfiguriert ist, werden diese Nameserver für die DNS-Auflösung verwendet.
8. Wenn es Probleme mit autoritativen DNS-Servern oder Nameservern gibt, die in /etc/resolv.conf angegeben sind, werden die Hostnamen des Backend-Servers in fehlerhafte/ungültige IP-Adressen aufgelöst. Die ungültigen IP-Adressen werden dann im DNS-Cache des Message Processors gespeichert.
   1. Wenn das Problem mit den autoritativen DNS-Servern oder den in /etc/resolv.conf angegebenen Nameservern weiterhin besteht, bleiben die ungültigen IP-Adressen im DNS-Cache des Message Processors. Solange die ungültigen IP-Adressen im DNS-Cache des Message Processors gespeichert sind, schlagen die Anfragen für alle APIs, die den entsprechenden Backend-Server verwenden, mit dem Fehler 503 fehl.
   2. Wenn das Problem mit autoritativen DNS-Servern oder Nameservern, die in /etc/resolv.conf angegeben sind, nur zeitweise auftritt, werden gute und schlechte IP-Adressen zeitweise im DNS-Cache gespeichert. In diesem Fall werden für alle APIs, die den jeweiligen Backend-Server verwenden, zeitweise 503-Fehler angezeigt.
9. Wenn das Problem mit den DNS-Servern weiterhin besteht, treten fortlaufend Fehler auf. Wenn das Problem mit DNS-Servern nur zeitweise auftritt, sehen Sie auch nur zeitweise Fehler. Das bedeutet, dass immer dann, wenn der Hostname des Backend-Servers in fehlerhafte IP-Adressen aufgelöst wird, 503-Fehler auftreten. Wenn die Hostnamen des Backend-Servers in gültige IP-Adressen aufgelöst werden, erhalten Sie erfolgreiche Antworten.

Auflösung

Wenden Sie sich an den Administrator Ihres Betriebssystems, um die Probleme mit den DNS-Servern zu beheben.

1. Wenn es ein Problem mit Ihren autoritativen DNS-Servern oder den in /etc/resolv.conf angegebenen Nameservern gibt, beheben Sie das Problem auf dem entsprechenden Server.
2. Wenn es ein Problem mit der Konfiguration in /etc/resolv.conf auf den Systemen mit Message Processors gibt, beheben Sie das Konfigurationsproblem.

Verbindungsfehler

Ein Verbindungsfehler tritt auf, wenn ein Apigee Edge Message Processor versucht, eine Verbindung zu einem Backend-Server herzustellen, und eines der folgenden Probleme auftritt:

• Der Message Processor kann innerhalb des voreingestellten Zeitlimits für die Verbindung keine Verbindung herstellen. (Standard: 3 Sekunden)
• Der Backend-Server lehnt die Verbindung ab.

Diagnose

1. Nachricht‑ID der fehlgeschlagenen Anfrage ermitteln
2. Suchen Sie im Message Processor-Log (/opt/apigee/var/log/edge-message-processor/logs/system.log) nach der ID der jeweiligen Anfragenachricht. Möglicherweise werden die folgenden Fehler angezeigt:
   1. Ein onConnectTimeout-Fehler gibt an, dass der Message Processor innerhalb des voreingestellten Verbindungszeitlimits keine Verbindung zum Backend-Server herstellen konnte.

      2016-06-23 09:11:49,314 org:myorg env:prod api:Employees rev:1 messageid:mo-96cf6757a-9401-21-1 NIOThread@2 ERROR HTTP.CLIENT - HTTPClient$Context.onTimeout() : ClientChannel[C:]@10 useCount=1 bytesRead=0 bytesWritten=0 age=3001ms lastIO=3001ms .onConnectTimeout connectAddress=www.abc.com/11.11.11.11:80 resolvedAddress=www.abc.com/11.11.11.11
      2016-06-23 09:11:49,333 org:myorg env:prod api:Employees rev:1 messageid:mo-96cf6757a-9401-21-1 NIOThread@2 ERROR ADAPTORS.HTTP.FLOW - RequestWriteListener.onTimeout() : RequestWriteListener.onTimeout(HTTPRequest@6b393600)

   2. Der Fehler java.net.ConnectException: Connection refused weist darauf hin, dass die Verbindung vom Backend-Server abgelehnt wurde.

      14:40:16.531 +0530
      2016-06-17 09:10:16,531 org:myorg env:prod api:www.abc.com rev:1 rrt07eadn-22739-40983870-15 NIOThread@2 ERROR HTTP.CLIENT - HTTPClient$Context.onConnectFailure() : connect to www.abc.com:11.11.11.11:443 failed with exception {}
      java.net.ConnectException: Connection refused
      at sun.nio.ch.SocketChannelImpl.checkConnect(Native Method) ~[na:1.7.0_75]
      at sun.nio.ch.SocketChannelImpl.finishConnect(SocketChannelImpl.java:739) ~[na:1.7.0_75]
      at com.apigee.nio.ClientChannel.finishConnect(ClientChannel.java:121) ~[nio-1.0.0.jar:na]
      at com.apigee.nio.handlers.NIOThread.run(NIOThread.java:108) ~[nio-1.0.0.jar:na]

3. Prüfen Sie, ob Sie mit dem Befehl telnet von jedem Message Processor aus eine direkte Verbindung zum jeweiligen Backend-Server herstellen können:
   1. Wenn der Backend-Server in eine einzelne IP-Adresse aufgelöst wird, verwenden Sie den folgenden Befehl:

      telnet BackendServer-IPaddress 443
                

   2. Wenn der Backend-Server in mehrere IP-Adressen aufgelöst wird, verwenden Sie den Hostnamen des Backend-Servers im telnet-Befehl, wie unten gezeigt:

      telnet BackendServer-HostName 443
                

4. Wenn Sie eine Verbindung zum Backend-Server herstellen können, wird möglicherweise eine Meldung wie Connected to backend-server angezeigt. Wenn Sie keine Verbindung zum Backend-Server herstellen können, liegt das möglicherweise daran, dass die IP-Adressen der Message Processors auf dem jeweiligen Backend-Server nicht auf der Zulassungsliste stehen.

Auflösung

Gewähren Sie Zugriff auf die IP-Adressen des Message Processors auf dem jeweiligen Backend-Server, damit Traffic von den Edge Message Processors auf Ihren Backend-Server zugreifen kann. Unter Linux können Sie beispielsweise iptables verwenden, um den Traffic von den IP-Adressen des Message Processors auf dem Backend-Server zuzulassen.

Wenn das Problem weiterhin besteht, wenden Sie sich an Ihren Netzwerkadministrator, um das Problem zu ermitteln und zu beheben. Wenn Sie weitere Unterstützung von Apigee benötigen, wenden Sie sich an den Apigee-Support.

Falscher Hostname des Zielservers

Diagnose

Wenn der im Zielserver angegebene Hostname falsch ist, erhalten Sie möglicherweise die Antwort 503 Service Unavailable mit dem Fehlercode messaging.adaptors.http.flow.ServiceUnavailable..

Auflösung

1. Achten Sie darauf, dass der in der Zielendpunktkonfiguration oder in der Zielserverdefinition angegebene Zielserverhostname korrekt ist und keine unerwünschten Leerzeichen oder Sonderzeichen enthält.
2. Wenn Sie eine AssignMessage-/JavaScript-Richtlinie verwenden, um den Hostnamen des Zielservers dynamisch zu generieren, untersuchen Sie die Richtliniendefinition und den Code und sorgen Sie dafür, dass der Hostname des Zielservers korrekt generiert wird.

Fehler beim SSL-Handshake

Ein ganzes Playbook zur Fehlerbehebung ist TLS/SSL-Handshake-Fehlern gewidmet. Weitere Informationen finden Sie unter SSL-Handshake-Fehler.

Ursache des Problems ermitteln

Bestimmte Fehlertypen können entweder bei der eingehenden (Northbound) oder ausgehenden (Southbound) Verbindung auftreten. Ein eingehender (Northbound-)Fehler tritt zwischen der Clientanwendung und Edge auf. Ein ausgehender (Southbound-)Fehler tritt zwischen Edge und dem Backend-Zielserver auf. Um diese Art von Problemen zu diagnostizieren, müssen Sie zuerst herausfinden, ob der Fehler bei der Nord- oder Südverbindung auftritt.

Northbound- und Southbound-Verbindungen

In Edge kann der Fehler „503 Service Unavailable“ sowohl bei der eingehenden als auch bei der ausgehenden Verbindung auftreten:

• Eingehende (oder nordwärts gerichtete) Verbindung: Die Verbindung zwischen der Clientanwendung und dem Edge-Router. Der Router ist die Komponente von Apigee Edge, die eingehende Anfragen an das System verarbeitet.
• Ausgehende (oder Southbound-)Verbindung: Die Verbindung zwischen dem Edge-Message Processor und dem Backend-Server. Der Message Processor ist eine Komponente von Apigee Edge, die API-Anfragen an Backend-Zielserver weiterleitet.

Wenn Sie Edge Public Cloud verwenden, sind Ihnen interne Komponenten wie der Router oder der Message Processor wahrscheinlich nicht bekannt. Diese internen Komponenten sind für Nutzer der Public Cloud nicht sichtbar oder zugänglich. Wenn möglich, bieten wir alternative Möglichkeiten zur Untersuchung des Problems an, die keinen direkten Zugriff auf diese Komponenten erfordern.

Die folgende Abbildung zeigt Northbound- und Southbound-Verbindungen für Apigee Edge.

Ermitteln, wo der Fehler „503 Service Unavailable“ aufgetreten ist

Verwenden Sie eines der folgenden Verfahren, um festzustellen, ob der Fehler „503 Service Unavailable“ bei der Nord- oder Südverbindung aufgetreten ist.