Use os registos de tempo de execução para ajudar a diagnosticar problemas com os pods apigee-runtime. Cada pod de tempo de execução contém um processador de mensagens, que é responsável por processar o tráfego do proxy de API, executar políticas, encaminhar pedidos e muito mais.
Usar registos do tempo de execução
Os registos são uma boa forma de resolver problemas com a instalação. Consulte a secção Registo para ver detalhes.
Use o comando logs
Pode ver os registos do sistema de tempo de execução através do comando kubectl logs. Por exemplo:
kubectl logs -f -n hybrid apigee-runtime-apigee-gcp-prod1-test-blue-hd77q
Ver registos no sistema de ficheiros
Pode encontrar os ficheiros de registo do processador de mensagens no sistema de ficheiros do apigee-runtimepod. Para ver os ficheiros, abra uma shell num pod do apigee-runtime:
kubectl exec -it -n namespace apigee-runtime-pod-name bash
Por exemplo:
kubectl exec -it -n hybrid apigee-runtime-apigee-gcp-prod1-test-blue-cnj5x bash
Assim que tiver o shell do pod aberto, pode encontrar os registos do processador de mensagens híbrido em
/opt/apigee/var/log/apigee-runtime/config.log.
Informações da versão do contrato
A tabela seguinte descreve brevemente as entradas do registo relacionadas com o carregamento do contrato a partir do plano de gestão:
| Entrada de registo | 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 de configuração do contrato mais recente 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á a ser 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 de configuração do contrato mais recente de version.properties.
|
Erros de implementação
Os seguintes erros de tempo de execução estão relacionados com implementações de proxy:
| Entrada de registo | 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á aprovisionado 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á aprovisionado no Cassandra.
|
Registos de erros de implementação do processador de mensagens
Procure as seguintes entradas de erro de implementação nos registos do processador de mensagens:
| Entrada do registo | 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 está aprovisionado no Cassandra.
|
Códigos de erro do processador de mensagens
Os códigos de erro do processador de mensagens começam por runtime.sync.error-name.
Por exemplo:
| Entrada do registo | Significado |
runtime.sync.ContractLoadFailedMessage: Error loading spec file
|
Motivo: o erro pode dever-se a um esquema inválido, a um ficheiro de especificação de contrato danificado ou a um contrato inválido. Qualquer um destes problemas pode impedir o processador de mensagens de carregar o ficheiro de especificação.
Solução: certifique-se de que o ficheiro de especificação do contrato está disponível, que o sistema de ficheiros não está danificado ou que o esquema/contrato é válido. |