apigee-runtime Pod の問題を診断する際は、ランタイムログを利用できます。各ランタイム Pod には、API プロキシ トラフィックの処理、ポリシーの実行、リクエストのルーティングなどを行う Message Processor が含まれています。
ランタイムログの使用
ログは、インストールに関する問題のトラブルシューティングに役立ちます。詳しくは、ロギングに関する記事をご覧ください。
logs コマンドを使用する
kubectl logs コマンドを使用して、ランタイムのシステムログを表示できます。次に例を示します。
kubectl logs -f -n apigee apigee-runtime-apigee-gcp-prod1-test-blue-hd77q
契約バージョンの情報
次の表に、管理プレーンからの契約の読み込みに関連するログエントリの概要を示します。
| ログエントリ | 意味 |
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 が仕様ファイルを読み込めない可能性があります。 対策: 契約仕様ファイルが使用可能であること、ファイル システムが破損していないこと、スキーマ / 契約が有効であることを確認します。 |