Trace-Sitzung kann nicht erstellt werden

<ph type="x-smartling-placeholder"></ph> Sie sehen die Dokumentation zu Apigee Edge.
Gehen Sie zur Apigee X-Dokumentation. Weitere Informationen

Symptom

Benutzer kann keine Ablaufverfolgungssitzung in der Edge-Benutzeroberfläche erstellen.

Fehlermeldung

Sie erhalten eine Fehlermeldung in der Edge-Benutzeroberfläche, wie unten dargestellt:

Error creating trace session for API proxy <api proxy name>, revision <revision number>, environment <environment name>.
Failed to create DebugSession <session number>

Hier ist der Screenshot einer Beispielfehlermeldung in der Edge-Benutzeroberfläche:

Mögliche Ursachen

Im Folgenden finden Sie einige mögliche Ursachen für diesen Fehler:

Ursache Beschreibung Geltende Anleitung zur Fehlerbehebung
Problem mit der Netzwerkverbindung Kommunikationsfehler zwischen Verwaltungsserver und Message Processor aufgrund von Problemen mit der Netzwerkverbindung oder Firewallregeln. Edge Private Cloud-Nutzer
Umgebung nicht in den Message Processor geladen Eine bestimmte Umgebung (in der Sie versuchen, den Trace zu aktivieren) wurde aufgrund eines Fehlers nicht in die Message Processor-Systeme geladen.
Veraltete Nachrichtenverarbeitungseinträge Der Verwaltungsserver verweist auf nicht vorhandene (veraltete) Message Processor.
Nachrichtenverarbeiter nicht erreichbar Message Processor wurde angehalten oder ist nicht mehr erreichbar.
Problem mit hoher Ressourcenauslastung Die Nachrichtenprozessoren weisen eine hohe Ressourcenauslastung (CPU, Arbeitsspeicher oder Last) auf.
API-Proxy nicht auf einem oder mehreren Message Processorn bereitgestellt Der API-Proxy kann aufgrund einer fehlenden Ereignisbenachrichtigung während der Bereitstellung nicht auf einem oder mehreren Message Processorn bereitgestellt werden.
Problem mit der Edge-Benutzeroberfläche Edge-UI kann aufgrund eines Fehlers keine Ablaufverfolgungssitzung erstellen.

Allgemeine Diagnoseschritte

  1. Führen Sie diese Verwaltungs-API aus:

    curl -v <management-server-host>:8080/v1/runtime/organizations/<org-name>/environments/<env-name>/apis/<apiproxy-name>/revisions/<revision-number>/debugsessions -u <user>

  2. Wenn Sie Fehler erhalten, notieren Sie diese. Gehen Sie zu Problem mit der Netzwerkverbindung.

  3. Wenn Sie eine erfolgreiche Antwort erhalten, bedeutet dies, dass die Trace-Sitzung über die Management API erstellt werden kann. Es könnte jedoch ein mögliches Problem mit der Edge-Benutzeroberfläche bestehen, sodass die Ablaufverfolgungssitzung nicht in der Benutzeroberfläche erstellt werden kann. Gehen Sie zu Problem mit der Edge-Benutzeroberfläche.

Ursache: Problem mit der Netzwerkverbindung

Diagnose

  1. Prüfen Sie im Management Server-Protokoll /opt/apigee/var/log/edge-management-server/logs/system.log, ob beim Erstellen der Trace-/Debug-Sitzung Fehler aufgetreten sind.

    Beispielfehler aus dem Verwaltungsserverprotokoll

    2018-02-08 09:08:21,310 org:myorg env:uat  qtp1073741635-1074 ERROR DISTRIBUTION - DebugSessionAPI.createDebugSession() : createDebugSession : Unable to connect to the server with UUID cedeabd2-e4d1-40bb-8f18-d6afc8835e5b
org.apache.http.conn.HttpHostConnectException: Connect to 10.84.75.92:8082 [/10.84.75.92] failed: Connection refused
    at org.apache.http.impl.conn.HttpClientConnectionOperator.connect(HttpClientConnectionOperator.java:140) ~[httpclient-4.3.5.jar:4.3.5]
    at org.apache.http.impl.conn.PoolingHttpClientConnectionManager.connect(PoolingHttpClientConnectionManager.java:318) ~[httpclient-4.3.5.jar:4.3.5]
    at org.apache.http.impl.execchain.MainClientExec.establishRoute(MainClientExec.java:363) ~[httpclient-4.3.5.jar:4.3.5]
...<snipped>
Caused by: java.net.ConnectException: Connection refused
    at java.net.PlainSocketImpl.socketConnect(Native Method) ~[na:1.8.0_65]
    at java.net.AbstractPlainSocketImpl.doConnect(AbstractPlainSocketImpl.java:350) ~[na:1.8.0_65]
...<snipped>

  2. Der obige Beispielfehler zeigt an, dass der Fehler "Connection disapproved" zurückgegeben wird, wenn der Verwaltungsserver versucht, eine Verbindung zum Message Processor an Port 8082 herzustellen. Daher kann der Verwaltungsserver die Trace-Sitzung nicht erstellen.

  3. Wenn keine Fehler im Zusammenhang mit der Netzwerkverbindung oder ein ähnlicher Fehler wie im obigen Beispiel angezeigt werden, fahren Sie mit Umgebung nicht auf dem Message Processor geladen fort.

  4. Wenn Sie Fehler im Zusammenhang mit der Netzwerkverbindung oder ähnliche Fehler wie im obigen Beispiel feststellen, gehen Sie so vor:

  5. Testen Sie die Verbindung vom Management Server zum Message Processor an Port 8082 mithilfe der folgenden Schritte:

    1. Wenn Telnet verfügbar ist, verwenden Sie Telnet:

      telnet <MessageProcessor_IP> 8082

    2. Falls Telnet nicht verfügbar ist, prüfen Sie die Verbindung mit Netcat wie folgt:

      nc -vz <MessageProcessor_IP> 8082

    3. Wenn Sie die Antwort „Connection Refused“ erhalten oder "Zeitüberschreitung der Verbindung" und fahren Sie dann mit dem nächsten Schritt fort.

  6. Melden Sie sich bei jedem Message Processor mit der entsprechenden IP-Adresse an, bei der der Fehler angezeigt wurde, und führen Sie die folgenden Schritte aus:

    1. Prüfen Sie, ob der Message Processor Port 8082 überwacht:

      netstat -an | grep LISTEN | grep 8082

    2. Wenn der Message Processor Port 8082 überwacht, fahren Sie mit Schritt 7 fort.

    3. Wenn der Message Processor Port 8082 nicht überwacht, starten Sie ihn mit dem folgenden Befehl neu:

      /opt/apigee/apigee-service/bin/apigee-service edge-message-processor restart

    4. Warten Sie mit dem folgenden Befehl, bis der Message Processor vollständig gestartet wurde:

      /opt/apigee/apigee-service/bin/apigee-service edge-message-processor wait_for_ready

    5. Sobald der Message Processor hochgefahren ist, prüfen Sie noch einmal, ob Message Processor Port 8082 überwacht.

    6. Wenn der Message Processor Port 8082 überwacht, fahren Sie mit Schritt 7 fort.

  7. Prüfen Sie, ob Sie die Trace-Sitzung jetzt auf der Benutzeroberfläche starten können. Wenn das Problem nicht mehr auftritt, überspringen Sie die folgenden Schritte.

  8. Wenn der Message Processor ausgeführt wird und Port 8082 überwacht, Sie aber trotzdem keine Verbindung über andere Server wie den Management Server herstellen können, gibt es wahrscheinlich eine Firewall, die die externen Verbindungen blockieren muss.

  9. Überprüfen Sie die Firewallregeln mit dem entsprechenden Befehl. Sie können beispielsweise den Befehl iptables ausführen, um alle auf Ihrem System definierten Firewallregeln aufzulisten:

    iptables -L -n

  10. Wenn für Port 8082 keine Firewallregeln festgelegt sind, fahren Sie mit Problem mit hoher Ressourcenauslastung fort.

  11. Wenn auf Port 8082 Firewallregeln eingerichtet sind, fahren Sie unten mit dem Abschnitt „Lösung“ fort.

Lösung

  1. Wenden Sie sich an Ihren Netzwerkadministrator, um den ein- und ausgehenden Traffic von externen Servern über Port 8082 zuzulassen.

Wenn das Problem weiterhin besteht, gehen Sie zu Diagnoseinformationen müssen erfasst werden.

Ursache: Umgebung wurde nicht in den Message Processor geladen

Diagnose

  1. Prüfen Sie die Verwaltungsserverprotokolle /opt/apigee/var/log/edge-management-server/logs/system.log und prüfen Sie, ob beim Erstellen der Trace-/Debug-Sitzung Fehler aufgetreten sind.

  2. Möglicherweise wird eine Fehlermeldung wie keine gültigen Antworten von MP(s) angezeigt. während der Erstellung der Trace-/Debug-Sitzung:

    2018-01-30 08:28:09,721 org:mynonprod env:uat  qtp2007599722-712162 ERROR DISTRIBUTION - DebugSessionAPI.createDebugSession() : no valid responses from MP(s), throwing error
2018-01-30 08:28:09,723 org:mynonprod env:uat  qtp2007599722-712162 ERROR REST - CustomJAXRSInvoker.performInvocation() : CustomJAXRSInvoker.performInvocation : Method com.apigee.distribution.DebugSessionAPI.createDebugSession threw an exception.
2018-01-30 08:28:09,724 org:mynonprod env:uat  qtp2007599722-712162 ERROR REST - ExceptionMapper.toResponse() : Error occurred : Failed to create DebugSession 1517297564678
2018-01-30 08:28:09,724 org:mynonprod env:uat  qtp2007599722-712162 ERROR REST - ExceptionMapper.toResponse() : Returning error response : ErrorResponse{errorCode = distribution.CreateDebugSessionFailed, errorMessage = Failed to create DebugSession 1517297564678}

    Dieser Fehler gibt an, dass der oder die Message Processor aus irgendeinem Grund nicht an den Verwaltungsserver antworten.

  3. Wenn kein ähnlicher Fehler wie im obigen Beispiel angezeigt wird, fahren Sie mit Veraltete Message Processor-Einträge fort.

  4. Wenn ein Fehler wie im obigen Beispiel auftritt, gehen Sie so vor:

  5. Eine der wahrscheinlichsten Ursachen für diesen Fehler ist, dass die Umgebung, in der Sie die Ablaufverfolgungssitzung erstellen möchten, nicht in den Message Processor geladen ist.

  6. Melden Sie sich bei jedem Message Processor an und prüfen Sie mit dem folgenden Befehl, ob die spezifische Umgebung, in der Sie die Ablaufverfolgungssitzung erstellen möchten, im Message Processor geladen ist:

    curl -s http://localhost:8082/v1/runtime/organizations/<org-name>/environments

    Beispielausgabe:

    Sie sehen die Liste der Umgebungen, die zu der jeweiligen Organisation gehören und in den Message Processor geladen werden, in der Ausgabe des obigen Befehls. Wenn beispielsweise die Umgebungen preprod und test in den Message Processor geladen werden, sehen Sie die Ausgabe so:

    [ "preprod", "test" ]

  7. Wenn die spezifische Umgebung, zum Beispiel „dev“, in der Sie eine Trace-Sitzung erstellen möchten, als Teil des obigen Befehls aufgeführt ist, fahren Sie mit Veraltete Message Processor-Einträge fort.

  8. Wenn die spezifische Umgebung, zum Beispiel "dev",, nicht als Teil des obigen Befehls aufgeführt ist, prüfen Sie /opt/apigee/var/log/edge-message-processor/logs/system.log und /opt/apigee/var/log/edge-message-processor/logs/startupruntimeerrors.log in den Message Processors auf Fehler beim Laden von Umgebungen.

  9. Es können viele verschiedene Fehler vorliegen, die dazu führen können, dass eine Umgebung nicht in den Message Processor geladen wird. Die Lösung hängt vom aufgetretenen Fehler ab.

Auflösung

Die Umgebung kann aus verschiedenen Gründen nicht im Message Processor geladen werden. In diesem Abschnitt werden einige mögliche Gründe für dieses Problem aufgezeigt und es wird erläutert, wie Sie das Problem beheben können.

  1. Wenn Sie einen der folgenden Fehler im Message Processor-Protokoll sehen, wird dies durch ein Problem mit den Zertifikaten/Schlüsseln verursacht, die dem angegebenen Schlüsselspeicher/Truststore in der angegebenen Umgebung hinzugefügt wurden.

    Fehler Nr. 1: java.security.KeyStoreException: cannot override own certificate

    2018-01-30 12:04:38,248 pool-47-thread-4 ERROR MESSAGING.RUNTIME - AbstractConfigurator.propagateEvent() : Error while handling the update for the Configurator 
com.apigee.kernel.exceptions.spi.UncheckedException: Failed to add certificate : mycert in key store : mytruststore in environment : test
at com.apigee.entities.configurators.KeyStore.setCertificateEntry(KeyStore.java:156) ~[config-entities-1.0.0.jar:na] 
at com.apigee.entities.configurators.KeyStore.handleUpdate(KeyStore.java:101) ~[config-entities-1.0.0.jar:na] 
at com.apigee.entities.AbstractConfigurator.propagateEvent(AbstractConfigurator.java:85) ~[config-entities-1.0.0.jar:na] 
at com.apigee.messaging.runtime.Environment.handleUpdate(Environment.java:238) [message-processor-1.0.0.jar:na] 
… 
Caused by: java.security.KeyStoreException: Cannot overwrite own certificate 
at com.sun.crypto.provider.JceKeyStore.engineSetCertificateEntry(JceKeyStore.java:355) ~[sunjce_provider.jar:1.8.0_151] 
at java.security.KeyStore.setCertificateEntry(KeyStore.java:1201) ~[na:1.8.0_151] 
at com.apigee.entities.configurators.KeyStore.setCertificateEntry(KeyStore.java:153) ~[config-entities-1.0.0.jar:na]
... 20 common frames omitted
2018-01-30 12:04:38,250 pool-47-thread-4 ERROR MESSAGING.RUNTIME - AbstractConfigurator.rollbackTransaction() : Error in processing the changes : Unknown resource type cert

    Fehler 2: java.security.KeyStoreException: geheimer Schlüssel kann nicht überschrieben werden

    2017-11-01 03:28:47,560 pool-21-thread-7 ERROR MESSAGING.RUNTIME - AbstractConfigurator.propagateEvent() : Error while handling the update for the Configurator 
com.apigee.kernel.exceptions.spi.UncheckedException: Failed to add certificate : mstore in key store : myTruststore in environment : dev 
at com.apigee.entities.configurators.KeyStore.setCertificateEntry(KeyStore.java:156) ~[config-entities-1.0.0.jar:na] 
at com.apigee.entities.configurators.KeyStore.handleUpdate(KeyStore.java:101) ~[config-entities-1.0.0.jar:na] 
... 
Caused by: java.security.KeyStoreException: Cannot overwrite secret key 
at com.sun.crypto.provider.JceKeyStore.engineSetCertificateEntry(JceKeyStore.java:354) ~[sunjce_provider.jar:1.8.0_144] 
at java.security.KeyStore.setCertificateEntry(KeyStore.java:1201) ~[na:1.8.0_144] 
at com.apigee.entities.configurators.KeyStore.setCertificateEntry(KeyStore.java:153) ~[config-entities-1.0.0.jar:na] 
... 20 common frames omitted 

2017-11-01 03:28:47,562 pool-21-thread-7 ERROR MESSAGING.RUNTIME - AbstractConfigurator.rollbackTransaction() : Error in processing the changes : Unknown resource type cert

  2. Rufen Sie mit dem folgenden Verwaltungs-API-Aufruf die Details des Schlüsselspeichers/Truststores ab, der in der Fehlermeldung im vorherigen Schritt angegeben ist:

    curl -v "http://<management-IPaddress>:8080/v1/organizations/<org-name>/environments/<env-name>/keystores/myTruststore" -u <user>

    Beispielausgabe:

    { 
"certs": [ 
"mycert", 
"mycert-new" 
], 
"keys": [ 
"mycert" 
], 
"name": "myTruststore" 
}

  3. Die Beispielausgabe zeigt, dass im Truststore myTruststore zwei Zertifikate und ein Schlüssel vorhanden sind. Der Truststore enthält im Allgemeinen keinen Schlüssel. In diesem Fall ist es besser, ein einzelnes Zertifikat und einen einzelnen Schlüssel zu haben.

  4. Rufen Sie die Details zu den beiden Zertifikaten mithilfe der folgenden API ab:

    curl -s http://<management-IPaddress>:8080/v1/runtime/organizations/<org-name>/environments/<env-name>/keystores/<keystore-name>/certs/<cert-name>

  5. Prüfen Sie das Ablaufdatum der einzelnen Zertifikate und finden Sie heraus, welches abgelaufene/ältere Zertifikat abgelaufen ist.

  6. Löschen Sie das abgelaufene oder unerwünschte Zertifikat aus dem Truststore „myTruststore“.

Wenn das Problem weiterhin besteht oder ein Fehler auftritt, der nicht in Schritt 1 oben aufgeführt ist, lesen Sie den Abschnitt Diagnoseinformationen müssen erfasst werden.

Ursache: Veraltete Nachrichtenverarbeitungseinträge ODER Nachrichtenprozessoren sind nicht erreichbar

Diagnose

  1. Wenn die Edge-Benutzeroberfläche sehr lange dauert und die Trace-Sitzung nicht erstellen kann, gibt es einige der möglichen Ursachen: <ph type="x-smartling-placeholder">
      </ph>
    1. Der Verwaltungsserver verweist möglicherweise auf nicht vorhandene (veraltete) Message Processor.
    2. Der/die Message Processor(s) wurde(n) angehalten oder ist nicht mehr erreichbar
    3. Die Arbeitsspeicher-/CPU-Auslastung der Message Processor ist zu hoch
  2. Prüfen Sie die Verwaltungsserverprotokolle /opt/apigee/var/log/edge-management-server/logs/system.log und prüfen Sie, ob beim Erstellen der Trace-/Debug-Sitzung Fehler aufgetreten sind.

  3. Möglicherweise wird eine Fehlermeldung wie "server <UUID>" angezeigt, ist entweder nicht erreichbar oder nicht erreichbar“, wie unten gezeigt:

    2017-12-27 07:42:38,975 org:cocacola env:prod qtp2007599722-222063 INFO DISTRIBUTION - DebugSessionAPI.createDebugSession() : server 458b5910-2646-441c-a6e2-428b6d84e021 is either not up or reachable, skipping the server

    Möglicherweise folgt ein weiterer Fehler: „Zeitüberschreitung der Verbindung“ wie unten dargestellt:

    2017-12-27 07:44:46.000 UTC org:cocacola env:prod qtp2007599722-222063 ERROR DISTRIBUTION - DebugSessionAPI.createDebugSession() : createDebugSession : Unable to connect to the server with UUID {}, skipping it458b5910-2646-441c-a6e2-428b6d84e021 org.apache.http.conn.HttpHostConnectException: Connect to 192.168.101.7:8080 [/192.168.101.7] failed: Connection timed out (Connection timed out) at org.apache.http.impl.conn.HttpClientConnectionOperator.connect(HttpClientConnectionOperator.java:140) ~[httpclient-4.3.5.jar:4.3.5] at org.apache.http.impl.conn.PoolingHttpClientConnectionManager.connect(PoolingHttpClientConnectionManager.java:318) ~[httpclient-4.3.5.jar:4.3.5] at org.apache.http.impl.execchain.MainClientExec.establishRoute(MainClientExec.java:363) ~[httpclient-4.3.5.jar:4.3.5] at org.apache.http.impl.execchain.MainClientExec.execute(MainClientExec.java:219) ~[httpclient-4.3.5.jar:4.3.5] 
…<snipped>
Caused by: java.net.ConnectException: Connection timed out (Connection timed out) at java.net.PlainSocketImpl.socketConnect(Native Method) ~[na:1.8.0_144] at java.net.AbstractPlainSocketImpl.doConnect(AbstractPlainSocketImpl.java:350) ~[na:1.8.0_144]
…<snipped>

  4. Diese beiden Fehler können durch bestimmte Message Processors verursacht werden:

    1. Veraltet (ist nicht mehr vorhanden)
    2. Nicht erreichbar/aus irgendeinem Grund nicht erreichbar

  5. Bitte folgen Sie je nach Situation die passende Lösung.

Auflösung

Szenario 1 : Nachrichtenverarbeiter sind veraltet (nicht vorhanden)

  1. Rufen Sie die Liste der Message Processors mithilfe der folgenden Verwaltungs-API ab:

    curl -u <sysadmin> "http://<management-server-host>:8080/v1/servers?pod=<podName>&regions=<regionName>"

  2. Notieren Sie sich die IP-Adresse oder den Hostnamen, die den UUID (s) der Message Processors entsprechen, die in der Fehlermeldung in den Management Server-Protokollen (Schritt Nr. 3 der Diagnose oben) erwähnt werden. Prüfen Sie mit einer der folgenden Methoden, ob dies gültige Message Processor sind:

    1. Diagramm zur Einrichtung der aktuellen Private Cloud-Topologie
    2. Neueste Edgeserver-IP-Adresse – Zuordnungstabelle für Hostnamen

    Wenn Sie der Meinung sind, dass es sich um gültige Message Processor handelt, fahren Sie mit Szenario 2 : Message Processor (s) sind nicht erreichbar fort.

  3. Löschen Sie die veralteten (nicht vorhandenen) Message Processor mithilfe der folgenden Verwaltungs-APIs:

    1. Heben Sie die Registrierung von Message Processor in den Umgebungen der Organisation auf: 

      curl -X POST http://<management-server-host>:8080/v1/o/<orgName>/e/<envName>/servers -d "uuid={uuid}&region=<regionName>&pod=<podName}&action=remove"

    2. Registrierung von Servertyp aufheben: 

      curl http://<management-server-host>:8080/v1/servers -X POST -d "type={message-processor}&region=<regionName>&pod=<podName>&uuid=<uuid>&action=remove"

    3. Löschen Sie den Server: 

      curl http://<management-ip>:8080/v1/servers/<uuid> -X DELETE

  4. Wiederholen Sie Schritt 3, wenn das Problem auch in anderen Umgebungen in Ihrer Organisation auftritt.

Szenario 2: Der oder die Nachrichtenverarbeiter sind nicht erreichbar

  1. Melden Sie sich bei jedem Message Processor an, indem Sie die IP-Adressen/Hostnamen anhand der UUIDs in der Fehlermeldung in den Verwaltungsserverprotokollen ermitteln.

  2. Starten Sie den Message Processor neu:

    /opt/apigee/apigee-service/bin/apigee-service edge-message-processor restart

Prüfen Sie noch einmal, ob Sie die Trace-Sitzung erstellen können. Wenn das Problem weiterhin besteht, lesen Sie den Abschnitt Diagnoseinformationen müssen erfasst werden.

Ursache: Problem mit hoher Ressourcenauslastung

Diagnose

  1. Melden Sie sich bei jedem Message Processor an und prüfen Sie, ob die Ressourcen(CPU, Arbeitsspeicher oder Last) stark ausgelastet sind. Auf Unix-basierten Betriebssystemen können Sie den Befehl top verwenden, um Informationen zur Ressourcenauslastung des Message Processor-Prozesses abzurufen:

    top

  2. Wenn bei den Message Processorn keine hohe Ressourcenauslastung auftritt, fahren Sie mit Diagnoseinformationen müssen erfasst fort.

  3. Wenn bei dem Message Processor eine hohe CPU- oder Speicherauslastung auftritt, kann dies dazu führen, dass der Message Processor dem Management Server nicht rechtzeitig antwortet. Dies verhindert schließlich, dass Sie eine Trace-Sitzung erstellen können.

    1. Wenn die CPU-Auslastung bei einem Message Processor hoch ist, generieren Sie mit dem folgenden Befehl alle 30 Sekunden drei Thread-Dumps:

      sudo <JAVA_HOME>/bin/jstack -l <pid> > <filename>

    2. Wenn ein Message Processor eine hohe Arbeitsspeicherauslastung hat, generieren Sie mit dem folgenden Befehl einen Heap-Dump:

      sudo -u apigee <JAVA_HOME>/bin/jmap -dump:live,format=b,file=<filename> <pid>

    3. Zu „Auflösung“ wechseln.

Auflösung

  1. Starten Sie den Message Processor mit dem folgenden Befehl neu. Dies sollte die CPU- und Speichernutzung reduzieren:

    /opt/apigee/apigee-service/bin/apigee-service edge-message-processor restart

  2. Überwachen Sie die API-Aufrufe und prüfen Sie, ob das Problem weiterhin besteht.

  3. Wenden Sie sich an den Apigee Edge-Support und senden Sie die Thread-Dumps, den Heap-Dump und die Message Processor-Logs (/opt/apigee/var/log/edge-message-processor/logs/system.log)), damit das Team die Ursache für die hohe CPU-/Arbeitsspeichernutzung untersuchen kann.

Ursache: API-Proxy wurde auf einem oder mehreren Message Processor nicht bereitgestellt

In seltenen Fällen kann ein API-Proxy nicht auf einem oder mehreren Message Processorn bereitgestellt werden. Dies liegt hauptsächlich daran, dass während der Bereitstellung des jeweiligen API-Proxys eine Ereignisbenachrichtigung vom Management Server an den Message Processor fehlt. In diesem Fall können Sie auch die Ablaufverfolgungssitzung nicht in der Edge-Benutzeroberfläche erstellen.

Diagnose

  1. Melden Sie sich bei jedem Message Processor an und prüfen Sie mit dem folgenden Befehl, ob die jeweilige Version des API-Proxys bereitgestellt ist:

    curl -v localhost:8082/v1/runtime/organizations/<orgname>/environments/<envname>/apis/<apiname>/revisions

    Beispielausgabe:

    Sie sehen die Liste der Überarbeitungen als Ausgabe des obigen Befehls. Wenn beispielsweise Version 12 bereitgestellt wird, sehen Sie folgende Ausgabe:

    [ "12" ]

  2. Wenn die spezifische Version des API-Proxys nicht als Ausgabe des in Schritt 1 genannten Befehls angezeigt wird, starten Sie den betreffenden Message Processor neu, wie in der Lösung unten beschrieben.

  3. Wiederholen Sie die Schritte 1 bis 2 für alle Message Processor.

  4. Wenn die spezifische Version des API-Proxys auf allen Message Processors bereitgestellt wird, ist dies nicht die Ursache für dieses Problem. Lesen Sie den Abschnitt Diagnoseinformationen müssen erfasst werden.

Auflösung

  1. Starten Sie den/die Message Processor neu, auf dem/denen die spezifische Version des API-Proxys nicht bereitgestellt ist:

    /opt/apigee/apigee-service/bin/apigee-service edge-message-processor restart

Ursache: Problem mit der Edge-Benutzeroberfläche

Diagnose

  1. Prüfen Sie die Edge-UI-Protokolle /opt/apigee/var/log/edge-ui/application.log und /opt/apigee/var/log/edge-ui/edge-ui.log und prüfen Sie, ob Fehler vorliegen.
  2. Wenden Sie sich an den Apigee Edge-Support und geben Sie diese Dateien zur weiteren Untersuchung frei.

Diagnoseinformationen erforderlich

Wenn das Problem trotz Befolgen der obigen Anweisungen weiterhin besteht, holen Sie die folgenden Diagnoseinformationen zusammen. Teilen Sie sie dem Apigee Edge-Support mit:

  1. Ausgabe des Befehls:

    curl -v <management-server-host>:8080/v1/runtime/organizations/<org-name>/environments/<env-name>/apis/<apiproxy-name>/revisions/<revision-number>/debugsessions -u <user>

  2. Verwaltungsserverprotokoll 

    /opt/apigee/var/log/edge-management-server/logs/system.log.

  3. Message Processor-Logs

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

  4. Ausgabe der telnet/nc-Befehle vom Verwaltungsserver an den Message Processor:

    telnet <MessageProcessor_IP> 8082
nc -vz <MessageProcessor_IP> 8082

  5. Ausgabe des folgenden netstat-Befehls an den Message Processor(s):

    netstat -an > netstat.txt

  6. Wenn ein Problem mit der Edge-Benutzeroberfläche festgestellt wurde, geben Sie die Edge-UI-Protokolle /opt/apigee/var/log/edge-ui/application.log und /opt/apigee/var/log/edge-ui/edge-ui.log. an.

  7. Details dazu, welche Abschnitte in diesem Playbook bereits ausprobiert wurden, sowie sonstige Informationen, die uns bei der schnellen Lösung dieses Problems helfen.