Versión 2: 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 2 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 habituales

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:

Característica	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).
Recopilación de métricas de supervisión de SAP HANA	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 VM

Problema: Si limitas los permisos de acceso en la instancia de VM 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 VM 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 VM. Compute Engine recomienda configurar las instancias de VM 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 la instancia de VM 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 VM 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 VM, debes asegurarte de que la instancia de VM 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 las métricas de Process Monitoring, las métricas de evaluación de Workload Manager o las métricas de supervisión de SAP HANA, los permisos de acceso de la instancia de VM del host también deben tener acceso de escritura para publicar datos de métrica a tu proyecto de Google Cloud:

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

Para cambiar los permisos de acceso, debes detener tu instancia de VM, realizar los cambios y, luego, reiniciar la instancia de VM. 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: Recopilación de las métricas de supervisión de SAP HANA con errores

Problema: Mientras actualizas del agente de supervisión para SAP HANA, después de instalar el agente de Google Cloud para SAP, verás un mensaje de error similar al siguiente:

tls: failed to verify certificate: x509: certificate relies on legacy Common Name field, use SANs instead

Causa: El agente de Google Cloud para SAP no puede iniciar la recopilación de las métricas de supervisión de SAP HANA porque las instancias de SAP HANA de destino usan certificados SSL que se especifican con Common Name (CN).

Resolución: Para resolver este problema, realiza los siguientes pasos:

Para las instancias de SAP HANA que deseas supervisar mediante el agente de Google Cloud para SAP, debes cambiar y usar un certificado SSL de Subject Alternate Name (SAN) en lugar de los certificados SSL que se especifican con Common Name (CN).
Establece una conexión SSH con la instancia de VM del host del servidor de la solución Bare Metal.
Abre el archivo de configuración del agente de Google Cloud para SAP:
```
/etc/google-cloud-sap-agent/configuration.json
```
En la sección hana_monitoring_configuration, configura el parámetro enabled como true.
En la sección hana_monitoring_configuration.hana_instances, realiza lo siguiente para cada instancia de SAP HANA que usa el protocolo TLS/SSL a fin de lograr una comunicación segura:
1. Especifica el parámetro enable_ssl y establece su valor en true.
2. Especifica el parámetro host_name_in_certificate y establece el nombre de host de SAP HANA, como se especifica en el certificado TLS/SSL, como su valor.
3. Especifica el parámetro tls_root_ca_file y establece la ruta de acceso, en la que se almacena el certificado TLS/SSL, como su valor.
Guarda el archivo de configuración.
Reinicia el agente de Google Cloud para SAP a fin de que se aplique la nueva configuración:
```
sudo systemctl restart google-cloud-sap-agent
```
Verifica que el agente recopile las métricas de supervisión de SAP HANA. Para obtener instrucciones, consulta Visualiza las otras métricas.
Desinstala el agente de supervisión para SAP HANA.

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.

Problema: Para las imágenes de SO SLES 15 SP4 para SAP y versiones posteriores, el agente de Google Cloud para SAP no se está ejecutando.

Problema: Cuando usas imágenes de SO de SLES “para SAP”, el agente de Google Cloud para SAP está preinstalado. Sin embargo, en el caso de las imágenes de SO SLES 15 SP4 para SAP y versiones posteriores, el agente preinstalado para SAP no se inicia por sí solo.

Para verificar que el agente esté en ejecución o no, realiza los siguientes pasos:

Conéctate a la instancia de VM del host o al servidor de la solución Bare Metal.

Ejecuta el siguiente comando:

systemctl status google-cloud-sap-agent

Si el agente no está en ejecución, el resultado contiene inactive (dead). Por ejemplo:

google-cloud-sap-agent.service - Google Cloud Agent for SAP
 Loaded: loaded (/usr/lib/systemd/system/google-cloud-sap-agent.service; disabled; vendor preset: disabled)
 Active: inactive (dead)

Causa: El agente para SAP no se inicia por sí solo debido a un problema con el empaquetado del SO.

Resolución: Para resolver el problema, realiza los siguientes pasos:

Conéctate a la instancia de VM del host o al servidor de la solución Bare Metal.

Ejecuta los siguientes comandos:

sudo sed -i 's~ /usr/sap~ -/usr/sap~g' /usr/lib/systemd/system/google-cloud-sap-agent.service
sudo systemctl restart google-cloud-sap-agent

Verifica que el agente esté en ejecución:

systemctl status google-cloud-sap-agent

Deberías ver un resultado similar al siguiente:

google-cloud-sap-agent.service - Google Cloud Agent for SAP
  Loaded: loaded (/usr/lib/systemd/system/google-cloud-sap-agent.service; disabled; vendor preset: disabled)
  Active: active (running) since Wed 2023-07-12 03:07:23 UTC; 7s ago
Main PID: 6117 (google_cloud_sa)
   Tasks: 6
  Memory: 8.8M (max: 1.0G limit: 1.0G available: 1015.1M)
  CGroup: /system.slice/google-cloud-sap-agent.service
           └─ 6117 /usr/bin/google_cloud_sap_agent startdaemon

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 Versión 2: Información de diagnóstico del agente de Google Cloud para SAP.