Fehlermeldungen

Sie sehen die Dokumentation zu Apigee Edge.
Zur Apigee X-Dokumentation weitere Informationen

Diese Seite enthält Links zu Playbooks zur Fehlerbehebung für Fehler und andere Probleme, die bei der Verwendung von Apigee Edge auftreten können. In jedem Playbook zur Fehlerbehebung wird erläutert, wie die einzelnen Problemtypen diagnostiziert und behoben werden.

Analytics-Probleme

In diesen Themen wird erläutert, wie Sie Fehler in Fällen beheben, in denen Analysedaten nicht in den Analytics-Dashboards oder benutzerdefinierten Berichten angezeigt werden.

Fehlermeldung oder Beschreibung Playbook
The report timed out: Try again with a smaller date range or a larger aggregation interval.

Zeitüberschreitung bei Analytics-Berichten

Oder:

Zeitüberschreitung beim Bericht
Möglicherweise wird keine Fehlermeldung angezeigt, es sei denn, der Speicherplatz auf dem Postgres-Server ist vollständig gefüllt. Speicherplatz wird beim Postgres-Server knapp
Es werden keine Fehler festgestellt. Benutzerdefinierte Variable für benutzerdefinierte Analytics-Berichte nicht sichtbar
No traffic in the selected date range Daten werden nicht in Analyse-Dashboards angezeigt
In diesem Kapitel wird erläutert, wie eine häufig angefragte Aufgabe erledigt wird. Analysekomponenten in Analysegruppen hinzufügen und löschen
Could not get data for path Benutzerdefinierte Dimensionen werden nicht angezeigt, wenn mehrere Achsengruppen konfiguriert wurden

Bereitstellungsfehler

Die Bereitstellung von API-Proxys kann aus verschiedenen Gründen wie Netzwerkverbindungsproblemen zwischen Edge-Servern, Problemen mit dem Cassandra-Datenspeicher, ZooKeeper-Ausnahmen und Fehlern im API-Proxy-Bundle fehlschlagen. Dieser Abschnitt enthält Informationen und Anleitungen zu einigen spezifischen Verfahren, die zur Fehlerbehebung bei Bereitstellungsfehlern ausgeführt werden können.
Fehlermeldung oder Beschreibung Playbook
Error: Call timed out; either server is down or server is not reachable Zeitüberschreitungsfehler
Unexpected error Error while fetching children for path Fehler beim Abrufen von untergeordneten Elementen für Pfad
Error while accessing datastore;Please retry later Fehler beim Zugriff auf den Datenspeicher
Configuration failed, associated contexts = [] Konfiguration fehlgeschlagen
Unexpected error occurred while processing the updates, associated contexts = [] Fehler beim Verarbeiten von Updates

Fehler im Entwicklerportal

Diese Themen helfen Ihnen bei Problemen, die bei der Nutzung des Entwicklerportals auftreten können. Bevor Sie versuchen, Probleme mit dem Entwicklerportal zu beheben, sollten Sie sich mit der Funktionsweise des Entwicklerportals vertraut machen, wie im Leitfaden zur Fehlerbehebung im Entwicklerportal erläutert.
Fehlermeldung oder Beschreibung Playbook
An internal error has occurred. Please retry your request. Interner Fehler im Entwicklerportal
The website encountered an unexpected error. Please try again later. ODER There was an error trying to create the App. Please try again later. Kommunikationsprobleme im Entwicklerportal

Probleme bei der Monetarisierung

Die folgenden Themen helfen Ihnen dabei, häufige Probleme bei der Monetarisierung zu beheben.

Fehlermeldung oder Beschreibung Playbook 
<error>
   <messages>
        <message>Exceeded developer limit configuration -</message>
        <message>Is Developer Suspended - true</message>
   </messages>
</error>
Entwickler gesperrt
Möglicherweise werden keine Fehlermeldungen angezeigt, aber es werden Probleme angezeigt, wie im Abschnitt Symptom unter Probleme bei der Einrichtung der Monetarisierung beschrieben. Probleme bei der Einrichtung der Monetarisierung

Probleme mit Edge Router

Der Edge Router wird mit NGINX implementiert. Während des Edge-Upgradeprozesses oder beim Ändern der Konfiguration des Routers können NGINX-Konfigurationsfehler auftreten. Das folgende Thema wird Ihnen bei der Lösung solcher Probleme helfen.

Fehlermeldung oder Beschreibung Playbook
Es werden keine Fehlermeldungen angezeigt. Allerdings können Sie Ihre API-Proxys aufgrund der fehlerhaften Konfigurationsdateien möglicherweise nicht ausführen. Fehlerhafte Konfigurationsdateien

OpenLDAP-Probleme

Die folgenden Themen helfen Ihnen bei der Behebung häufig auftretender OpenLDAP-Probleme.

Fehlermeldung oder Beschreibung Playbook
Unknown username and password combination. SMTP ist deaktiviert und Nutzer müssen das Passwort zurücksetzen
Es werden keine Fehler angezeigt. Die Edge-Benutzeroberfläche zeigt einfach nicht die Liste der Nutzer an, die auf allen OpenLDAP-Servern repliziert werden sollten. LDAP repliziert nicht.
SLAPD Dead But Pid File Exists OpenLDAP kann nicht gestartet werden
Unknown username and password combination. Beschädigung von OpenLDAP-Daten

Laufzeitfehler

Die folgenden Themen helfen Ihnen bei der Behebung häufiger Laufzeitprobleme.

Fehlermeldung oder Beschreibung Playbook
HTTP/1.1 500 Internal Server Error ODER 
{
   "fault":{
      "detail":{
         "errorcode":"steps.servicecallout.ExecutionFailed"
      },
      "faultstring":"Execution of ServiceCallout callWCSAuthServiceCallout failed.
        Reason: ResponseCode 400 is treated as error"
   }
}
500 Interner Serverfehler
HTTP/1.1 502 Bad Gateway ODER 
{
   "fault": {
      "faultstring": "Unexpected EOF at target",
      "detail": {
           "errorcode": "messaging.adaptors.http.UnexpectedEOFAtTarget"
       }
    }
}
502 Ungültiges Gateway
HTTP/1.1 503 Service Unavailable ODER HTTP/1.1 503 Service Unavailable: Back-end server is at capacity ODER 
{
   "fault": {
      "faultstring": "The Service is temporarily unavailable",
      "detail": {
           "errorcode": "messaging.adaptors.http.flow.ServiceUnavailable"
       }
    }
}
503 Dienst nicht verfügbar
HTTP/1.1 503 Service Unavailable ODER Received fatal alert: handshake_failure SSL-Handshakefehler
HTTP/1.1 503 Service Unavailable ODER 
{
 "fault": {
    "faultstring":"The Service is temporarily unavailable",
    "detail":{
        "errorcode":"messaging.adaptors.http.flow.ServiceUnavailable"
    }
 }
}
SSL-Handshakefehler – fehlerhaftes Clientzertifikat
HTTP/1.1 504 Gateway Timeout ODER 
{
   "fault": {
      "faultstring": "Gateway Timeout",
      "detail": {
           "errorcode": "messaging.adaptors.http.flow.GatewayTimeout"
       }
    }
}
504-Fehler – Gateway-Zeitüberschreitung

Zookeeper-Probleme

Die folgenden Themen helfen Ihnen bei der Behebung häufiger Probleme mit Zookeeper.
Fehlermeldung oder Beschreibung Playbook
org: env: main ERROR ZOOKEEPER - ZooKeeperServiceImpl.exists() : Could not detect existence of path: /regions/dc-1/pods/analytics/servers/abc123/reachable , reason: KeeperErrorCode = ConnectionLoss

ODER

org.apache.zookeeper.KeeperException$ConnectionLossException: KeeperErrorCode = ConnectionLoss

ODER

Die Edge-Benutzeroberfläche zeigt möglicherweise diesen Fehler an:

Error Fetching Deployments Error while checking path existence for path: path 		Zookeeper – Fehler beim Verbindungsverlust
Datenbezogene Probleme, die im Allgemeinen als Verkabelungsprobleme bezeichnet werden, können sich als eines von mehreren Problemen äußern. Weitere Informationen finden Sie unter Probleme mit Zookeeper-Daten. Zookeeper-Datenprobleme
+ apigee-service apigee-zookeeper status apigee-service: apigee-zookeeper: Not running (DEAD) apigee-all: Error: status failed on [apigee-zookeeper] Zookeeper kann nicht gestartet werden

Diagnosetools und Protokolle

In diesen Themen werden Tools und Logs beschrieben, mit denen Sie bestimmte Probleme diagnostizieren können, die bei der Verwendung von Apigee Edge auftreten können.

  • TCP/IP-Paket-Sniffer-Dienstprogramm (tcpdump)
    Das Tool „tcpdump“ ist ein Befehlszeilen-Paket-Sniffer-Tool, mit dem Sie TCP/IP-Pakete erfassen oder filtern können, die über ein Netzwerk empfangen oder übertragen werden.
  • Heap-Dumps
    Heap-Dumps sind Snapshots des Arbeitsspeichers eines Java-Prozesses. Sie enthalten die Informationen über die Java-Objekte und -Klassen im Heap zum Zeitpunkt der Erfassung des Heap-Dumps.
  • Thread-Dumps
    Ein Thread-Dump ist ein Snapshot des Status aller Threads eines laufenden Java-Prozesses. Der Status jedes Threads wird mit dem Inhalt seines Stacks angezeigt. Dieser wird als Stacktrace bezeichnet.