ランタイムログを使用して、apigee-runtime Pod の問題を診断します。各ランタイム Pod には、API プロキシ トラフィックの処理、ポリシーの実行、リクエストのルーティングなどを行う Message Processor が含まれています。
ランタイムログの使用
ログは、インストールで発生した問題のトラブルシューティングに役立ちます。詳細については、ロギングをご覧ください。
ログコマンドを使用する
kubectl logs コマンドを使用して、ランタイムのシステムログを表示できます。例:
kubectl logs -f -n hybrid apigee-runtime-apigee-gcp-prod1-test-blue-hd77q
ファイル システムでログを表示する
Message Processor のログファイルは apigee-runtime Pod のファイル システムにあります。ファイルを表示するには、apigee-runtime Pod でシェルを開きます。
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 の下にハイブリッド Message Processor のログが表示されます。
契約バージョンの情報
次の表に、管理プレーンからの契約の読み込みに関連するログエントリの概要を示します。
| ログのエントリ | 意味 |
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
|
MP が新しいバージョンの構成契約に更新されます。 |
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
|
キースペース cache_orgname_hybrid は Cassandra でプロビジョニングされていません。 |
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
|
キースペース kms_orgname_hybrid は Cassandra でプロビジョニングされていません。 |
Message Processor のデプロイエラー ログ
Message Processor のログで、次のデプロイエラー エントリを探します。
| ログのエントリ | 説明 |
|---|---|
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 |
キースペース kms_orgname_hybrid は Cassandra でプロビジョニングされていません。
|
Message Processor のエラーコード
Message Processor のエラーコードは runtime.sync.error-name で始まります。例:
| ログのエントリ | 意味 |
runtime.sync.ContractLoadFailedMessage: Error loading spec file
|
理由: 無効なスキーマ、契約仕様ファイルの破損、または無効な契約が、エラーの原因である可能性があります。これらの問題のいずれかにより、Message Processor が仕様ファイルを読み込めない可能性があります。 対策: 契約仕様ファイルが使用可能であること、ファイル システムが破損していないこと、スキーマ / 契約が有効であることを確認します。 |