Instala y configura el agente de Google Cloud para SAP en una instancia de VM de Compute Engine

El Agente de Google Cloud para SAP es necesario para la asistencia de SAP de los sistemas SAP que se ejecutan en Google Cloud, incluidos SAP NetWeaver, SAP HANA, SAP ASE, SAP MaxDB y otros.

Cuando instalas el Agente de Google Cloud para SAP en una instancia de VM de Compute Engine, en el caso de las métricas de SAP Host Agent, el agente combina los datos de supervisión de Cloud Monitoring y las APIs de Compute Engine y proporciona esos datos a SAP Host Agent.

Si usas las siguientes imágenes de SO de RHEL o SLES “para SAP” que proporciona Google Cloud, el agente de Google Cloud para SAP se empaqueta con las imágenes de SO:

RHEL: todas las imágenes “para SAP”
SLES: SLES 15 SP4 para SAP y versiones posteriores

Para obtener información sobre los sistemas operativos compatibles con el agente de Google Cloud para SAP, consulta Sistemas operativos compatibles.

Si deseas instalar y configurar la versión 2 del agente de Google Cloud para SAP en un servidor de solución Bare Metal, consulta Instala el agente de Google Cloud para SAP en un servidor de solución Bare Metal.

Descripción general de instalación

En Linux, debes instalar el Agente de Google Cloud para SAP mediante los comandos de administración de paquetes del sistema operativo estándar: en RHEL, el comando yum; en SLES, el comando zypper. El comando de administración de paquetes completa las siguientes tareas:

Descarga el agente de Google Cloud para SAP.
Crea el agente como un servicio systemd de Linux, llamado google-cloud-sap-agent.
Habilita e inicia el servicio, google-cloud-sap-agent.

En Windows, debes instalar el agente de Google Cloud para SAP mediante el comando de administración de paquetes de GooGet, googet. El comando de administración de paquetes completa las siguientes tareas:

Descarga el agente de Google Cloud para SAP.
Crea un servicio de Windows llamado google-cloud-sap-agent y una tarea programada que se ejecuta cada minuto para comprobar si el servicio aún se ejecuta y, si es necesario, reiniciarlo.

Advertencia: No detengas de forma manual el servicio de Windows ni borres la tarea programada.

Requisitos previos para el agente

Antes de instalar el agente de Google Cloud para SAP, debes asegurarte de que se cumplan los siguientes requisitos previos.

Configura los roles de IAM necesarios

Como mínimo, la cuenta de servicio que usa el Agente de Google Cloud para SAP debe incluir los roles de Visualizador de Compute (roles/compute.viewer), Visualizador de Monitoring (roles/monitoring.viewer) y Escritor de estadísticas del Administrador de cargas de trabajo (roles/workloadmanager.insightWriter).

Para agregar un rol necesario a tu cuenta de servicio, sigue estos pasos:

En la consola de Google Cloud, ve a la página IAM.

Ir a IAM
Selecciona tu proyecto de Google Cloud.
Identifica la cuenta de servicio a la que le quieres agregar un rol.
- Si la cuenta de servicio no se encuentra aún en la lista de principales, no tiene ningún rol asignado. Haz clic en Agregar e ingresa la dirección de correo electrónico de la cuenta de servicio.
- Si la cuenta de servicio ya se encuentra en la lista de principales es porque tiene roles existentes. Haz clic en el botón Editar de la cuenta de servicio que deseas editar.
Selecciona el rol necesario de la lista de funciones disponibles:
- Compute Engine > Visualizador de Compute
- Monitoring > Visualizador de Monitoring
- Administrador de cargas de trabajo > Escritor de estadísticas del administrador de cargas de trabajo
Haz clic en Agregar o Guardar para aplicar los roles a la cuenta de servicio.

Habilita el acceso a las APIs de Google Cloud

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 para controlar el acceso a los recursos de Google Cloud. Para obtener más información, consulta Crea una VM que use una cuenta de servicio administrada por el usuario.

Si limitas el acceso a las APIs de Cloud, el Agente de Google Cloud para SAP requiere los siguientes permisos mínimos de acceso a las APIs de Cloud en la instancia de VM del host:

Cloud Platform: Habilitado
Compute Engine: solo lectura
API de Stackdriver Monitoring: solo lectura

Si ejecutas aplicaciones de SAP en una instancia de VM que no tiene una dirección IP externa, debes habilitar el Acceso privado a Google en la subred de la VM para que el Agente de Google Cloud para SAP pueda acceder a los servicios y las APIs de Google. Para habilitar el acceso privado a Google en una subred, consulta Configura el acceso privado a Google.

Instala el agente

Te recomendamos que instales la última versión del agente de Google Cloud para SAP, que admite más funciones. Si deseas obtener instrucciones, consulta Instala y configura el agente de Google Cloud para SAP en una instancia de VM de Compute Engine.

Si deseas instalar la versión 2 del agente de Google Cloud para SAP, comunícate con el servicio de Atención al cliente de Cloud.

Después de instalar el Agente de Google Cloud para SAP y SAP Host Agent, valida la instalación del Agente de Google Cloud para SAP, como se describe en Valida la instalación del agente.

Valida la instalación del agente

Para verificar que el agente esté en ejecución, selecciona tu sistema operativo y, luego, sigue estos pasos:

Linux

Establece una conexión SSH con la instancia de VM del host.

Ejecuta el siguiente comando:

systemctl status google-cloud-sap-agent

Si el agente funciona de forma correcta, el resultado contendrá active (running). Por ejemplo:

google-cloud-sap-agent.service - Google Cloud Agent for SAP
Loaded: loaded (/usr/lib/systemd/system/google-cloud-sap-agent.service; enabled; vendor preset: disabled)
Active:  active (running)  since Fri 2022-12-02 07:21:42 UTC; 4 days ago
Main PID: 1337673 (google-cloud-sa)
Tasks: 9 (limit: 100427)
Memory: 22.4 M (max: 1.0G limit: 1.0G)
CGroup: /system.slice/google-cloud-sap-agent.service
       └─1337673 /usr/bin/google-cloud-sap-agent

Windows

Usa RDP para conectarte a la instancia de VM.
Como administrador, ejecuta el siguiente comando desde PowerShell:
```
$(Get-Service -Name 'google-cloud-sap-agent' -ErrorAction Ignore).Status
```
Si se está ejecutando el agente, el estado muestra Running.

Si el agente no está en ejecución, reinicia el agente.

Verifica que el agente de host SAP reciba métricas

Para verificar que el Agente de Google Cloud para SAP recopile las métricas de infraestructura y que se envíen de forma correcta al agente de host SAP, sigue estos pasos:

En el sistema SAP, ingresa la transacción ST06.
En el panel de descripción general, revisa la disponibilidad y el contenido de los siguientes campos para verificar la configuración completa y correcta de la infraestructura de supervisión de SAP y Google:
- Proveedor de servicios en la nube: Google Cloud Platform
- Acceso de supervisión mejorada: TRUE
- Detalles de supervisión mejorada: ACTIVE

Configura el agente de Google Cloud para SAP en Linux

Después de instalar el agente de Google Cloud para SAP, de forma opcional, puedes habilitar otras funciones del agente si realizas las siguientes configuraciones. De forma predeterminada, está habilitada la recopilación de solo las métricas de SAP Host Agent.

Archivo de configuración predeterminada

El siguiente fragmento es un ejemplo de la configuración predeterminada de la versión 2 del agente de Google Cloud para SAP:

{
  "provide_sap_host_agent_metrics": true,
  "bare_metal": ,
  "log_level": "INFO",
  "log_to_cloud": true,
  "collection_configuration": {
    "collect_workload_validation_metrics": false,
    "collect_process_metrics": false,
    "sap_system_discovery": true
  },
  "hana_monitoring_configuration": {
    "enabled": false
  }
}

Parámetros de configuración

En la siguiente tabla, se explican los parámetros de configuración de la versión 2 del agente de Google Cloud para SAP.

Parámetros
`provide_sap_host_agent_metrics`	`Boolean` Para habilitar la recopilación de las métricas que requiere SAP Host Agent, especifica `true`. La ruta predeterminada es `true`. No establezcas `provide_sap_host_agent_metrics` en `false`, a menos que te dirijan el servicio de atención al cliente de Cloud o el de asistencia de SAP.
`bare_metal`	`Boolean` Cuando el agente se instale en un servidor de solución Bare Metal, especifica `true`. La ruta predeterminada es `false`.
`log_level`	`String` Para establecer el nivel de registro del agente, establece el valor requerido. Los niveles de registro disponibles son los siguientes: `DEBUG` `INFO` `WARNING` `ERROR` El valor predeterminado es `INFO`. No cambies el nivel de registro, a menos que te dirija el servicio de atención al cliente de Cloud.
`log_to_cloud`	`Boolean` Para redireccionar los registros del agente a Cloud Logging, especifica `true`. El valor predeterminado es `true`.
`sap_system_discovery`	`Boolean` Para habilitar el descubrimiento del sistema SAP, especifica `true`. El valor predeterminado es `true`.
`cloud_properties.project_id`	`String` Si tu sistema SAP se ejecuta en un servidor de la solución Bare Metal, especifica el ID del proyecto de Google Cloud que usas con la solución Bare Metal. Cuando el agente se ejecuta en una instancia de VM, de forma predeterminada, detecta el ID del proyecto automáticamente.
`cloud_properties.instance_name`	`String` Si el sistema SAP se ejecuta en una instancia de VM de Compute Engine, especifica el nombre de esa instancia de VM. El agente detecta automáticamente el nombre de la instancia de VM durante la instalación. Si tu sistema SAP se ejecuta en un servidor de la solución Bare Metal, especifica el nombre de ese servidor.
`cloud_properties.region`	`String` Si tu sistema SAP se ejecuta en un servidor de la solución Bare Metal, especifica la región del servidor de la solución Bare Metal. Cuando el agente se ejecuta en una instancia de VM, de forma predeterminada, usa la región de la instancia de VM en la que está instalado el agente.
`cloud_properties.zone`	`String` Cuando el agente se ejecuta en una instancia de VM, de forma predeterminada, usa la zona de la instancia de VM en la que está instalado el agente.
`cloud_properties.image`	`String` Especifica el nombre de la imagen de SO de la instancia. Cuando el agente se ejecuta en una instancia de VM, de forma predeterminada, detecta el imagen de SO de la instancia de VM en la que está instalado el agente.
`cloud_properties.numeric_project_id`	`String` El ID numérico del proyecto de Google Cloud en el que se ejecuta el sistema SAP. Cuando el agente se ejecuta en una instancia de VM, de forma predeterminada, detecta el ID del proyecto numérico automáticamente.
`collection_configuration.collect_process_metrics`	`Boolean` Para habilitar la recopilación de métricas de supervisión, especifica `true`. La ruta predeterminada es `false`. Este parámetro solo se aplica a Linux. Si habilitas la recopilación de métricas de procesos para SAP HANA, debes configurar los parámetros adicionales que se enumeran en `hana_metrics_config`.
`collection_configuration.process_metrics_frequency`	`Int` A partir de la versión 2.6, este parámetro determina la frecuencia de recopilación de las métricas de Process Monitoring que cambian rápidamente, en segundos. Las métricas de Process Monitoring que cambian rápidamente son: `sap/hana/availability`, `sap/hana/ha/availability` y `sap/nw/availability`. El valor predeterminado para este parámetro es `5` segundos. Te recomendamos usar este valor predeterminado. Todas las demás métricas (de cambio lento) de Monitoring se recopilan con una frecuencia predeterminada de 30 segundos. Para cambiar la frecuencia de recopilación de las métricas de Process Monitoring que cambian lentamente, usa el parámetro `slow_process_metrics_frequency`.
`collection_configuration.slow_process_metrics_frequency`	`Int` Especifica la frecuencia de recopilación de las métricas de Process Monitoring que cambian lentamente, en segundos. El valor predeterminado para este parámetro es `30` segundos.
`collection_configuration.process_metrics_to_skip`	`Array` Especifica las métricas de Process Monitoring que no quieres que recopile el agente. Este parámetro acepta un valor separado por comas de los nombres de las métricas de Process Monitoring. Por ejemplo: `"process_metrics_to_skip": ["/sap/nw/abap/sessions", "/sap/nw/abap/rfc"]`.
`collection_configuration.hana_metrics_config.hana_db_user`	`String` Especifica la cuenta de usuario de la base de datos que el agente usa para consultar SAP HANA. El valor predeterminado es `SYSTEM`.
`collection_configuration.hana_metrics_config.hana_db_password`	`String` Especifica la contraseña de texto sin formato para la cuenta de usuario de la base de datos que el agente usa a fin de consultar SAP HANA. En lugar de especificar una contraseña de texto sin formato, te recomendamos que uses una de las siguientes opciones: `hana_db_password_secret_name`, para el que especificas un objeto Secret almacenado en Secret Manager.
`collection_configuration.hana_metrics_config.hana_db_password_secret_name`	`String` A fin de proporcionar de forma segura la contraseña de la cuenta de usuario de la base de datos que el agente usa para consultar SAP HANA, especifica el nombre del secreto que contiene las credenciales de seguridad de la cuenta de usuario de la base de datos. Importante: El secreto y la instancia de VM del host deben existir en el mismo proyecto de Google Cloud. El agente recopila las métricas relacionadas con SAP HANA solo cuando especificas `hana_db_password_secret_name`, o `hana_db_password`.
`collection_configuration.hana_metrics_config.sid`	`String` Especifica el SID de tu instancia de SAP HANA. Si usas una clave de HANA Userstore, consulta la sección hdbuserstore_key.
`collection_configuration.collect_workload_validation_metrics`	`Boolean` Para habilitar la recopilación de métricas de evaluación de Workload Manager, especifica `true`. A partir de la versión 3.2, el valor predeterminado es `true`. Este parámetro solo se aplica a Linux.
`collection_configuration.workload_validation_metrics_frequency`	`Int` La frecuencia de recopilación de las métricas de evaluación de Workload Manager, en segundos. El valor predeterminado es `300` segundos. Te recomendamos que no modifiques la frecuencia de recopilación predeterminada, ya que podría afectar a toda la función. Si necesitas modificar la frecuencia de recopilación de las métricas del Administrador de cargas de trabajo, agrega el parámetro `workload_validation_metrics_frequency` en la sección `collection_configuration` y proporciona el valor requerido.
`collection_configuration.workload_validation_db_metrics_config.hana_db_user`	`String` Especifica la cuenta de usuario que se usa para consultar la instancia de SAP HANA. La cuenta de usuario debe tener el permiso de lectura para la base de datos de SAP HANA.
`collection_configuration.workload_validation_db_metrics_config.hana_db_password_secret_name`	`String` Especifica el nombre del secreto en Secret Manager que almacena la contraseña de la cuenta de usuario.
`collection_configuration.workload_validation_db_metrics_config.sid`	`String` Especifica el SID de tu instancia de SAP HANA.
`collection_configuration.workload_validation_db_metrics_config.hostname`	`String` Especifica el identificador de la máquina, ya sea local o remoto, que aloja la instancia de SAP HANA. Los siguientes son los valores admitidos: Si el host es una máquina local, especifica la cadena `localhost` o la dirección IP de bucle invertido del host local, como `127.0.0.1`. Si el host es una máquina remota, especifica su dirección IP interna o externa.
`collection_configuration.workload_validation_db_metrics_config.port`	`String` Especifica el puerto en el que la instancia de SAP HANA acepta consultas. Para la primera o única instancia de base de datos de usuario, el puerto es `3NN15`, en el que `NN` es el número de instancia de la instancia de SAP HANA.
`collection_configuration.workload_validation_db_metrics_frequency`	`Int` La frecuencia de recopilación de las métricas de la base de datos de SAP HANA, en segundos, para la evaluación de Workload Manager. El valor predeterminado es `3600` segundos. Si bien puedes actualizar la frecuencia de recopilación de las métricas de la base de datos de SAP HANA, te recomendamos que uses el valor predeterminado. Si necesitas modificar el valor predeterminado, agrega el parámetro `workload_validation_db_metrics_frequency` en la sección `collection_configuration` y proporciona el valor requerido. Asegúrate de no establecer una frecuencia de recopilación mayor que `3600` segundos.
`hana_monitoring_configuration.enabled`	`Boolean` Opcional. Si deseas habilitar el agente de Google Cloud para SAP a fin de recopilar las métricas de supervisión de SAP HANA, especifica `true`. El valor predeterminado es `false`. Los siguientes parámetros secundarios solo se aplican cuando especificas `hana_monitoring_configuration.enabled: true`.
`hana_monitoring_configuration.sample_interval_sec`	`Int` Opcional. Especifica el intervalo de muestra, en segundos, que determina la frecuencia con la que el agente de Google Cloud para SAP consulta tus instancias de SAP HANA para recopilar las métricas de supervisión de SAP HANA. El valor predeterminado es 300 segundos. Para cada consulta definida en el archivo de configuración del agente de Google Cloud para SAP, puedes reemplazar el intervalo de muestra global si especificas el intervalo requerido en el parámetro `sample_interval_sec`. Los intervalos de muestra deben ser de 5 segundos o más.
`hana_monitoring_configuration.query_timeout_sec`	`Int` Opcional. Especifica el tiempo de espera para cada consulta realizada a las instancias de SAP HANA. El valor predeterminado es 300 segundos.
`hana_monitoring_configuration.execution_threads`	`Int` Opcional. Especifica la cantidad de subprocesos que se usan para enviar consultas a las instancias de SAP HANA. Cada consulta se ejecuta en su propio subproceso. El valor predeterminado es 10.
`hana_monitoring_configuration.hana_instances.name`	`String` Especifica el identificador de nombre para tu instancia de SAP HANA.
`hana_monitoring_configuration.hana_instances.sid`	`String` Especifica el SID de tu instancia de SAP HANA. Esta cadena se agrega como una etiqueta a todas las métricas resultantes de la consulta de tus instancias de SAP HANA.
`hana_monitoring_configuration.hana_instances.host`	`String` Especifica el identificador de la máquina, ya sea local o remoto, que aloja la instancia de SAP HANA. Los siguientes son los valores admitidos: Si el host es una máquina local, especifica la cadena `localhost` o la dirección IP de bucle invertido del host local, como `127.0.0.1`. Si el host es una máquina remota, especifica su dirección IP interna o externa.
`hana_monitoring_configuration.hana_instances.port`	`String` Especifica el puerto en el que la instancia de SAP HANA acepta consultas. Para la primera o única instancia de base de datos de usuario, el puerto es `3NN15`, en el que `NN` es el número de instancia de la instancia de SAP HANA.
`hana_monitoring_configuration.hana_instances.user`	`String` Especifica la cuenta de usuario que se usa para consultar la instancia de SAP HANA. Asegúrate de que este usuario tenga el privilegio para leer las vistas de supervisión en tu base de datos de SAP HANA. Si no se otorga este privilegio, las métricas de supervisión de SAP HANA relacionadas con las vistas de supervisión no contienen datos.
`hana_monitoring_configuration.hana_instances.password`	`String` Opcional. Especifica la contraseña, como texto sin formato, que autentica la cuenta de usuario para consultar la instancia de SAP HANA. Para la autenticación, debes especificar una de las siguientes opciones: La contraseña de texto sin formato al parámetro `password`. (Recomendado) Si usas Secret Manager para almacenar la contraseña como un secreto, debes especificar el nombre del secreto correspondiente al parámetro `secret_name`.
`hana_monitoring_configuration.hana_instances.secret_name`	`String` Opcional. Especifica el nombre del secreto en Secret Manager que almacena la contraseña de la cuenta de usuario.
`hana_monitoring_configuration.hana_instances.enable_ssl`	`Boolean` Opcional. Especifica si SSL está habilitado en tu instancia de SAP HANA. El valor predeterminado es `false`.
`hana_monitoring_configuration.hana_instances.host_name_in_certificate`	`String` Si especificas `enable_ssl: true` para una instancia de SAP HANA, debes especificar el nombre de host que se configura en el certificado SSL.
`hana_monitoring_configuration.hana_instances.tls_root_ca_file`	`String` Si especificas `enable_ssl: true` para una instancia de SAP HANA, debes especificar la ruta de acceso de tu certificado de seguridad.
`hana_monitoring_configuration.queries.enabled`	`Boolean` Opcional. A fin de habilitar una consulta en SQL para todas tus instancias de SAP HANA, especifica el valor `true` del parámetro `enabled` de esa consulta de SQL.
`hana_monitoring_configuration.queries.name`	`String` Si definiste consultas personalizadas en tu archivo de configuración, debes especificar un nombre único para cada consulta personalizada. El nombre de la consulta debe ser único, ya que se usa para compilar la URL predeterminada de la métrica en Monitoring.
`hana_monitoring_configuration.queries.sql`	`String` Especifica la instrucción de SQL que el agente emite a tus instancias de SAP HANA. La instrucción de SQL debe cumplir con la sintaxis de SQL definida por SAP en SAP HANA SQL and System Views Reference.
`hana_monitoring_configuration.queries.sample_interval_sec`	`Int` Opcional. Especifica el intervalo de muestra para la consulta de SQL. Esto anula el intervalo de muestra global. El valor debe ser de 5 segundos o más.
`hana_monitoring_configuration.queries.columns.name`	`String` Especifica un nombre que identifique de forma única cada columna. El nombre de columna debe ser único porque se usa para compilar la URL predeterminada de la métrica en Monitoring.
`hana_monitoring_configuration.queries.columns.metric_type`	`String` Para el manejo mediante Monitoring, especifica uno de los siguientes tipos de métricas: `METRIC_LABEL`, `METRIC_GAUGE` o `METRIC_CUMULATIVE`. Las métricas de tipo `METRIC_LABEL` se agregan como etiquetas a todas las métricas `METRIC_GAUGE` y `METRIC_CUMULATIVE` que se envían a Monitoring.
`hana_monitoring_configuration.queries.columns.value_type`	`String` Para el control de Monitoring, especifica un tipo de datos que sea compatible con el tipo de métrica. Los tipos de datos compatibles son los siguientes: `VALUE_BOOL`, `VALUE_INT64`, `VALUE_STRING` o `VALUE_DOUBLE`. Para obtener más información, consulta Combinación compatible.
`hana_monitoring_configuration.queries.columns.name_override`	`String` Opcional. Para el manejo mediante Monitoring, especifica la ruta de acceso que deseas mostrar en la URL de la métrica en lugar de los nombres de columna y consulta. Por ejemplo: URL predeterminada de la métrica: `workload.googleapis.com/sap/hanamonitoring/QUERY_NAME/COLUMN_NAME` URL de la métrica con ruta de acceso personalizada: `workload.googleapis.com/sap/hanamonitoring/CUSTOM_PATH`

Soluciona problemas

Si deseas obtener información sobre el diagnóstico y la resolución de problemas que puedes encontrar cuando instalas y configuras el agente de Google Cloud para SAP, consulta Guía de solución de problemas del Agente de Google Cloud para SAP.

Obtenga asistencia

Si necesitas ayuda para resolver problemas con el agente de Google Cloud para SAP, recopila toda la información de diagnóstico disponible y comunícate con Atención al cliente de Cloud. Si deseas obtener más información para comunicarte con el equipo de Atención al cliente de Cloud, consulta Obtén asistencia para SAP en Google Cloud.