您可以使用執行階段記錄來診斷 apigee-runtime pod 的問題。每個執行階段 Pod 都包含一個訊息處理器，負責處理 API Proxy 流量、執行政策、路由要求等等。
使用執行階段記錄
記錄是排解安裝問題的好方法。詳情請參閱「記錄」。
使用 logs 指令
您可以使用 kubectl logs 指令查看執行階段系統記錄。例如：
kubectl logs -f -n hybrid apigee-runtime-apigee-gcp-prod1-test-blue-hd77q
查看檔案系統上的記錄
您可以在 apigee-runtime pod 的檔案系統中找到訊息處理器記錄檔。如要查看檔案，請在 apigee-runtime 容器中開啟殼層：
kubectl exec -it -n namespace apigee-runtime-pod-name bash
例如：
kubectl exec -it -n hybrid apigee-runtime-apigee-gcp-prod1-test-blue-cnj5x bash
開啟 Pod 殼層後，您可以在 /opt/apigee/var/log/apigee-runtime/config.log 下方找到混合訊息處理器記錄。
合約版本資訊
下表簡要說明從管理層載入合約的相關記錄項目：
| 記錄項目 | 意義 |
hybrid-runtime Apigee-Timer-9 INFO RUNTIME-SYNC-SERVICE -
RuntimeSyncServiceImpl.updateToVersion() : Switched to newer version
750 from version null
|
MP 已改用較新版本的設定合約。 |
hybrid-runtime Apigee-Timer-6 INFO RUNTIME-SYNC-SERVICE -
RuntimeSyncServiceImpl.loadLatestVersionIfAvailable() : Found a newer
version 750
|
MP 從 version.properties 載入最新的合約設定版本。 |
hybrid-runtime Apigee-Timer-6 INFO RUNTIME-SYNC-SERVICE -
RuntimeSyncServiceImpl.updateToVersion() : Attempting to update to a newer version 750
|
管理員端程式會更新至較新的設定合約版本。 |
hybrid-runtime Apigee-Timer-6 INFO RUNTIME-SYNC-SERVICE -
RuntimeSyncServiceImpl.updateToVersion() : Switched to newer version 751 from version 750
|
MP 從 version.properties 載入最新的合約設定版本。 |
部署錯誤
下列執行階段錯誤與快取代理程式部署作業有關：
| 記錄項目 | 意義 |
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
|
在 Cassandra 中未佈建 Keyspace cache_orgname_hybrid。 |
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
|
在 Cassandra 中未佈建 Keyspace kms_orgname_hybrid。 |
訊息處理工具部署錯誤記錄
在訊息處理器記錄中尋找下列部署錯誤項目：
| 記錄項目 | 說明 |
|---|---|
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 |
鍵空間 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 |
在 Cassandra 中未佈建 Keyspace kms_orgname_hybrid。 |
訊息處理工具錯誤代碼
訊息處理工具的錯誤代碼開頭為 runtime.sync.error-name。例如：
| 記錄項目 | 意義 |
runtime.sync.ContractLoadFailedMessage: Error loading spec file
|
原因：無效的結構定義、毀損的合約規格檔案或無效的合約，都可能導致這項錯誤。上述任何問題都可能導致訊息處理工具無法載入規格檔案。 解決方法：請確認合約規格檔案可供使用、檔案系統未損毀，或結構定義/合約有效。 |