Versión 1: Guía de solución de problemas del agente de Google Cloud para SAP

En esta guía, se muestra cómo resolver problemas de la versión 1 del agente de Google Cloud para SAP.

Logging

Revisa los registros del directorio que son específicos de tu sistema operativo.

Si deseas ver los registros del Agente de Google Cloud para SAP, navega a las siguientes rutas:

Linux

/var/log/google-cloud-sap-agent.log

Windows

C:\Program Files\Google\google-cloud-sap-agent\logs\google-cloud-sap-agent.log

Problemas comunes

Problema: Permisos de IAM insuficientes

Problema: Los registros del Agente de Google Cloud para SAP muestran un error de permisos de IAM insuficiente.

Causa: La cuenta de servicio no tiene los permisos de IAM necesarios para acceder a la API de Cloud Monitoring.

Resolución: En la consola de Google Cloud, en la página de detalles de la instancia de VM, anota el nombre de la cuenta de servicio de la VM. Por ejemplo: sap-example@example-project-123456.iam.gserviceaccount.com En la página principal de IAM y administración, asegúrate de que la cuenta de servicio incluya los siguientes roles de IAM:

Función	Roles de IAM obligatorios
Recopilación de métricas de SAP Host Agent	Visualizador de Compute (`roles/compute.viewer`) Visualizador de Monitoring (`roles/monitoring.viewer`)
Recopilación de métricas de supervisión de procesos	Visualizador de Compute (`roles/compute.viewer`) Escritor de métricas de Monitoring (`roles/monitoring.metricWriter`) Descriptor de acceso a secretos de Secret Manager (`roles/secretmanager.secretAccessor`) (obligatorio cuando usas Secret Manager a fin de autenticar la cuenta de usuario de la base de datos para SAP HANA).
Recopilación de métricas de evaluación de Workload Manager	Visualizador de Compute (`roles/compute.viewer`) Escritor de métricas de Monitoring (`roles/monitoring.metricWriter`) Descriptor de acceso a secretos de Secret Manager (`roles/secretmanager.secretAccessor`) (obligatorio cuando usas Secret Manager a fin de autenticar la cuenta de usuario de la base de datos para SAP HANA).

Si deseas obtener más información sobre la autenticación requerida para el agente de Google Cloud para SAP, consulta Autenticación y acceso.

Para confirmar los permisos que requiere el agente de Cloud Monitoring, consulta la siguiente documentación de Monitoring:

Problema: Permisos de acceso incorrectos para la cuenta de servicio de procesamiento

Problema: Si limitas los permisos de acceso en la instancia de procesamiento de host, los registros del Agente de Google Cloud para SAP pueden mostrar un error de permisos de IAM insuficiente.

Causa: El Agente de Google Cloud para SAP requiere permisos de acceso mínimos a la API de Cloud en la instancia de procesamiento del host. Este error se produce cuando la cuenta de servicio no tiene los permisos de acceso necesarios.

Resolución: Los permisos de acceso son el método heredado de especificar permisos para tu instancia de procesamiento. Compute Engine recomienda configurar las instancias de procesamiento para permitir los permisos de acceso completo a todas las APIs de Cloud y usar solo los permisos de IAM de la cuenta de servicio de procesamiento para controlar el acceso a los recursos de Google Cloud.

Para resolver este problema, se recomienda configurar todo el nivel de acceso cloud-platform en la instancia de procesamiento y, luego, limitar de forma segura el acceso a la API de la cuenta de servicio con roles de IAM. Por ejemplo:

https://www.googleapis.com/auth/cloud-platform

Si limitas los permisos de acceso de la instancia de procesamiento, debes asegurarte de que la instancia de procesamiento del host tenga los siguientes permisos de acceso:

https://www.googleapis.com/auth/source.read_write
https://www.googleapis.com/auth/compute
https://www.googleapis.com/auth/servicecontrol
https://www.googleapis.com/auth/service.management.readonly
https://www.googleapis.com/auth/logging.admin
https://www.googleapis.com/auth/monitoring
https://www.googleapis.com/auth/trace.append
https://www.googleapis.com/auth/devstorage.full_control

Si habilitaste la recopilación de métricas de Process Monitoring o la recopilación de métricas de evaluación de Workload Manager, los permisos de acceso de la instancia de procesamiento del host también deben tener acceso de escritura para publicar datos de métricas en tu proyecto de Google Cloud:

https://www.googleapis.com/auth/monitoring.write

Para cambiar los permisos de acceso, debes detener tu instancia de procesamiento, realizar los cambios y, luego, reiniciar la instancia de procesamiento. Para obtener instrucciones, consulta la documentación de Compute Engine. No es necesario realizar ningún cambio en los permisos de los roles de IAM para este problema.

Problema: SAP Host Agent falta o es incorrecto

Problema: Los registros de agente de Google Cloud para SAP muestran errores faltantes o incorrectos de SAP Host Agent.

Causa: SAP Host Agent o el nivel de parche mínimo requerido para SAP Host Agent no están instalados. Para que el Agente de Google Cloud para SAP funcione, tu sistema SAP debe tener instalado SAP Host Agent y mantener el nivel de parche mínimo que este requiere.

Resolución: Para resolver este problema, instala la versión requerida de SAP Host Agent. A fin de obtener instrucciones para instalar SAP Host Agent, consulta la documentación de SAP.

Para conocer los requisitos de versión para SAP Host Agent, consulta las siguientes notas de SAP:

Linux: nota de SAP 2460297: SAP en Linux en Google Cloud Platform: supervisión mejorada
Windows: Nota de SAP 1409604: Virtualización en Windows para una supervisión mejorada

Problema: Instalación del Agente de Google Cloud para SAP

Problema: La instalación del agente falla cuando se ejecuta el comando de instalación del administrador de paquetes (yum, zypper o googet).

Causa: La instalación del agente falla porque el servidor host que ejecuta el agente se creó sin una dirección IP pública.

Resolución: Para resolver este problema, configura una puerta de enlace NAT que otorgue al servidor host acceso de salida a Internet. Para obtener información sobre cómo configurar una puerta de enlace NAT, consulta la guía de implementación de tu sistema SAP. Por ejemplo, para SAP NetWeaver, consulta lo siguiente:

Problema: Error de conexión rechazada

Problema: Los registros de SAP Host Agent muestran el error de conexión rechazada.

Causa: El Agente de Google Cloud para SAP no se puede iniciar porque el puerto 18181 no está disponible. El agente de Google Cloud para SAP escucha las solicitudes en el puerto 18181. Este puerto debe estar disponible para que el agente se inicie.

Resolución: A fin de resolver este problema, asegúrate de que el puerto 18181 esté disponible para el agente de Google Cloud para SAP. Si otro servicio usa el puerto 18181, es posible que debas reiniciar ese otro servicio o volver a configurarlo para usar otro puerto.

Obtén asistencia para el Agente de Google Cloud para SAP

Si necesitas ayuda para resolver un problema con el Agente de Google Cloud para SAP, recopila la información de diagnóstico requerida y comunícate con el servicio de atención al cliente de Cloud. Si deseas obtener más información, consulta Información de diagnóstico de los agentes de Google Cloud para SAP.