Laufzeitlogs

Verwenden Sie Laufzeitlogs, um Probleme mit den apigee-runtime-Pods zu diagnostizieren. Jeder Laufzeit-Pod enthält einen Message Processor, der für die Verarbeitung von API-Proxy-Traffic, für die Ausführung von Richtlinien, für Routinganfragen usw. zuständig ist.

Laufzeitlogs verwenden

Logs sind eine gute Möglichkeit, Probleme mit Ihrer Installation zu beheben. Weitere Informationen zu Logging.

Befehl "logs" verwenden

Mit dem Befehl kubectl logs können Sie die Laufzeitsystemlogs ansehen. Beispiele: 

kubectl logs -f -n hybrid apigee-runtime-apigee-gcp-prod1-test-blue-hd77q

Logs im Dateisystem anzeigen lassen

Die Dateien der Nachrichtenverarbeiter-Logdateien finden Sie im Dateisystem des Pods apigee-runtime. Öffnen Sie zum Anzeigen der Dateien eine Shell in einem apigee-runtime-Pod:

kubectl exec -it -n namespace apigee-runtime-pod-name bash

Beispiele:

kubectl exec -it -n hybrid apigee-runtime-apigee-gcp-prod1-test-blue-cnj5x bash

Nachdem Sie die Pod-Shell geöffnet haben, finden Sie die Logs des Hybrid-Nachrichtenverarbeiters unter /opt/apigee/var/log/apigee-runtime/config.log.

Informationen zur Vertragsversion

In der folgenden Tabelle werden Logeinträge beschrieben, die sich auf das Laden des Vertrags über die Verwaltungsebene beziehen:

Logeintrag Bedeutung
hybrid-runtime Apigee-Timer-9 INFO RUNTIME-SYNC-SERVICE - RuntimeSyncServiceImpl.updateToVersion() : Switched to newer version 750 from version null Die Verwaltungsebene wurde in eine neuere Version des Konfigurationsvertrags geändert.
hybrid-runtime Apigee-Timer-6 INFO RUNTIME-SYNC-SERVICE - RuntimeSyncServiceImpl.loadLatestVersionIfAvailable() : Found a newer version 750 Die aktuelle Vertragskonfigurationsversion von version.properties wurde von der Verwaltungsebene geladen.
hybrid-runtime Apigee-Timer-6 INFO RUNTIME-SYNC-SERVICE - RuntimeSyncServiceImpl.updateToVersion() : Attempting to update to a newer version 750 Die Verwaltungsebene wird auf eine neuere Version des Konfigurationsvertrags aktualisiert.
hybrid-runtime Apigee-Timer-6 INFO RUNTIME-SYNC-SERVICE - RuntimeSyncServiceImpl.updateToVersion() : Switched to newer version 751 from version 750 Die aktuelle Vertragskonfigurationsversion von version.properties wurde von der Verwaltungsebene geladen.

Bereitstellungsfehler

Folgende Laufzeitfehler beziehen sich auf Proxybereitstellungen:

Logeintrag Bedeutung
hybrid-runtime org:hybrid env:prod Apigee-Main-6 ERROR i.a.h.e.i.HermesEngineImpl - HermesEngineImpl.handleHermesException() : Keyspace cache_hybrid_hybrid does not exist Der Schlüsselbereich cache_orgname_hybrid wird in Cassandra nicht bereitgestellt.
hybrid-runtime org:hybrid Apigee-Timer-9 ERROR c.a.s.e.k.HybridEncryptionKeyServiceImpl - HybridEncryptionKeyServiceImpl.getEncryptionKey() : Encryption key does not exist for organization hybrid and type KmsKey Der Schlüsselbereich kms_orgname_hybrid wird in Cassandra nicht bereitgestellt.

Fehlerlogs der Bereitstellung des Nachrichtenverarbeiters

Suchen Sie in den Nachrichtenverarbeiterlogs nach folgenden Einträgen zu Bereitstellungsfehlern:

Logeintrag Beschreibung
hybrid-runtime org:hybrid env:prod Apigee-Main-6 ERROR i.a.h.e.i.HermesEngineImpl - HermesEngineImpl.handleHermesException() : Keyspace cache_hybrid_hybrid does not exist Schlüsselbereich cache_orgname_hybrid is not provisioned in Cassandra.
hybrid-runtime org:hybrid Apigee-Timer-9 ERROR c.a.s.e.k.HybridEncryptionKeyServiceImpl - HybridEncryptionKeyS erviceImpl.getEncryptionKey() : Encryption key does not exist for organization hybrid and type KmsKey Der Schlüsselbereich kms_orgname_hybrid wird in Cassandra nicht bereitgestellt.

Fehlercodes des Nachrichtenverarbeiters

Fehlercodes für den Nachrichtenverarbeiter beginnen mit runtime.sync.error-name. Beispiel:

Logeintrag Bedeutung
runtime.sync.ContractLoadFailedMessage: Error loading spec file Ursache: Der Fehler kann durch ein ungültiges Schema, eine beschädigte Vertragsspezifikationsdatei oder einen ungültigen Vertrag verursacht werden. Jedes dieser Probleme kann verhindern, dass der Nachrichtenverarbeiter die Spezifikationsdatei lädt.

Lösung: Achten Sie darauf, dass entweder die Vertragsspezifikationsdatei verfügbar ist, das Dateisystem nicht beschädigt ist oder das Schema/der Vertrag gültig ist.