Usa los registros del entorno de ejecución para diagnosticar problemas con los Pods de apigee-runtime
. Cada Pod de entorno de ejecución contiene un procesador de mensajes, que es responsable de procesar el tráfico del proxy de API, la ejecución de políticas, el enrutamiento de solicitudes y mucho más.
Usa registros del entorno de ejecución
Los registros son una buena forma de solucionar problemas de la instalación. Consulta Registros para obtener más detalles.
Usa el comando de registros
Puedes ver los registros del sistema del entorno de ejecución con el comando kubectl logs
. Por ejemplo:
kubectl logs -f -n hybrid apigee-runtime-apigee-gcp-prod1-test-blue-hd77q
Visualiza registros en el sistema de archivos
Puedes encontrar los archivos de registro de procesador de mensajes en el sistema de archivos del Pod apigee-runtime
. Para ver los archivos, abre una shell en un pod apigee-runtime
:
kubectl exec -it -n namespace apigee-runtime-pod-name bash
Por ejemplo:
kubectl exec -it -n hybrid apigee-runtime-apigee-gcp-prod1-test-blue-cnj5x bash
Una vez que la shell del pod esté abierta, podrás encontrar los registros del procesador de mensajes híbridos en /opt/apigee/var/log/apigee-runtime/config.log
.
Información de la versión del contrato
En la siguiente tabla, se describen brevemente las entradas de registro relacionadas con la carga del contrato desde el plano de administración:
Entrada de registro | Significado |
hybrid-runtime Apigee-Timer-9 INFO RUNTIME-SYNC-SERVICE -
RuntimeSyncServiceImpl.updateToVersion() : Switched to newer version
750 from version null
|
El MP pasó a una versión más reciente del contrato de configuración. |
hybrid-runtime Apigee-Timer-6 INFO RUNTIME-SYNC-SERVICE -
RuntimeSyncServiceImpl.loadLatestVersionIfAvailable() : Found a newer
version 750
|
El MP cargó la última versión de la configuración del contrato desde version.properties . |
hybrid-runtime Apigee-Timer-6 INFO RUNTIME-SYNC-SERVICE -
RuntimeSyncServiceImpl.updateToVersion() : Attempting to update to a newer version 750
|
El MP se está actualizando a una nueva versión del contrato de configuración. |
hybrid-runtime Apigee-Timer-6 INFO RUNTIME-SYNC-SERVICE -
RuntimeSyncServiceImpl.updateToVersion() : Switched to newer version 751 from version 750
|
El MP cargó la última versión de la configuración del contrato desde version.properties . |
Errores en la implementación
Los siguientes errores del entorno de ejecución se relacionan con las implementaciones 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
|
El espacio de claves cache_orgname_hybrid no está aprovisionado en 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
|
El espacio de claves kms_orgname_hybrid no está aprovisionado en Cassandra. |
Registros de errores de implementación del procesador de mensajes
Busca las siguientes entradas de error de implementación en los registros del procesador de mensajes:
Entrada de registros | Descripción |
---|---|
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 |
El espacio de claves kms_orgname_hybrid no está aprovisionado en Cassandra. |
Códigos de error del procesador de mensajes
Los códigos de error del procesador de mensajes comienzan con runtime.sync.error-name
.
Por ejemplo:
Entrada de registro | Significado |
runtime.sync.ContractLoadFailedMessage: Error loading spec file
|
Motivo: el error puede deberse a un esquema no válido, a un archivo de especificación de contrato dañado o a un contrato no válido. Cualquiera de estos problemas puede impedir que el procesador de mensajes cargue el archivo de especificaciones.
Solución: Asegúrate de que el archivo de especificaciones del contrato esté disponible, que el sistema de archivos no esté dañado o que el esquema o el contrato sea válido. |