Use os registros do ambiente de execução para ajudar a diagnosticar problemas com os pods apigee-runtime
. Cada
pod do ambiente de execução contém um processador de mensagens, responsável pelo processamento do tráfego de proxy da API,
execução de políticas, solicitações de roteamento e muito mais.
Como usar registros do ambiente de execução
Os registros são uma boa maneira de resolver problemas com a instalação. Consulte Como gerar registros para mais detalhes.
Usar o comando de registro
É possível ver os registros do sistema do ambiente de execução usando o comando kubectl logs
. Exemplo:
kubectl logs -f -n hybrid apigee-runtime-apigee-gcp-prod1-test-blue-hd77q
Como visualizar registros no sistema de arquivos
Você pode encontrar os arquivos de registro do processador de mensagens no sistema de arquivos
do pod apigee-runtime
. Para ver os arquivos, abra um shell em um pod apigee-runtime
:
kubectl exec -it -n namespace apigee-runtime-pod-name bash
Exemplo:
kubectl exec -it -n hybrid apigee-runtime-apigee-gcp-prod1-test-blue-cnj5x bash
Depois de abrir o shell do pod, você encontra os registros do processador de mensagens híbrido em
/opt/apigee/var/log/apigee-runtime/config.log
.
Informações da versão do contrato
A tabela a seguir descreve brevemente as entradas de registro relacionadas ao carregamento do contrato do plano de gerenciamento:
Entrada de registro | Significado |
hybrid-runtime Apigee-Timer-9 INFO RUNTIME-SYNC-SERVICE -
RuntimeSyncServiceImpl.updateToVersion() : Switched to newer version
750 from version null
|
O MP mudou para uma versão mais recente do contrato de configuração. |
hybrid-runtime Apigee-Timer-6 INFO RUNTIME-SYNC-SERVICE -
RuntimeSyncServiceImpl.loadLatestVersionIfAvailable() : Found a newer
version 750
|
O MP carregou a versão mais recente da configuração do contrato de version.properties .
|
hybrid-runtime Apigee-Timer-6 INFO RUNTIME-SYNC-SERVICE -
RuntimeSyncServiceImpl.updateToVersion() : Attempting to update to a newer version 750
|
O MP está sendo atualizado para uma versão mais recente do contrato de configuração. |
hybrid-runtime Apigee-Timer-6 INFO RUNTIME-SYNC-SERVICE -
RuntimeSyncServiceImpl.updateToVersion() : Switched to newer version 751 from version 750
|
O MP carregou a versão mais recente da configuração do contrato de version.properties .
|
Erros de implantação
Os seguintes erros do ambiente de execução estão relacionados a implantações de proxy:
Entrada de registro | Significado |
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
|
O keyspace cache_orgname_hybrid não está provisionado no 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
|
O keyspace kms_orgname_hybrid não está provisionado no Cassandra.
|
Registros de erro de implantação do processador de mensagens
Procure as seguintes entradas de erro de implantação nos registros do processador de mensagens:
Entrada de registro | Descrição |
---|---|
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 |
Keyspace 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 |
O keyspace kms_orgname_hybrid não é provisionado no Cassandra.
|
Códigos de erro do processador de mensagens
Os códigos de erro para o processador de mensagens começam com runtime.sync.error-name
.
Exemplo:
Entrada de registro | Significado |
runtime.sync.ContractLoadFailedMessage: Error loading spec file
|
Motivo: o erro pode ser causado por um esquema inválido, arquivo de especificação
de contrato corrompido ou
contrato inválido. Qualquer um desses problemas pode impedir que o processador de mensagens carregue o arquivo de
especificação.
Ação corretiva: verifique se o arquivo de especificação de contrato está disponível, o sistema de arquivos não está corrompido ou o esquema/contrato é válido. |