Versión 1: 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 1 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.

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:

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

    Ir a IAM

  2. Selecciona tu proyecto de Google Cloud.

  3. 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.
  4. 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
  5. 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 1 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

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

  2. 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

  1. Usa RDP para conectarte a la instancia de VM.

  2. Como administrador, ejecuta el siguiente comando desde PowerShell:

    $(Get-Service -Name 'google-cloud-sap-agent' -ErrorAction Ignore).Status
    Si el agente está en ejecución, 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:

  1. En el sistema SAP, ingresa la transacción ST06.
  2. 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, tienes la opción de configurar el agente para habilitar la recopilación de métricas de Process Monitoring y métricas de evaluación de Workload Manager. De forma predeterminada, está habilitada la recopilación de solo las métricas de SAP Host Agent.

Las métricas de supervisión de procesos y la recopilación de métricas de evaluación de Workload Manager solo son compatibles con Linux.

Si habilitas las métricas de supervisión de procesos y la recopilación de métricas de evaluación de Workload Manager, la cuenta de servicio de la instancia de VM del host debe incluir el rol de IAM Escritor de métricas de supervisión (roles/monitoring.metricWriter).

Si usas Secret Manager para almacenar la contraseña de la base de datos de SAP HANA, asegúrate de que la cuenta de servicio de la instancia de VM del host tenga el rol Descriptor de acceso a secretos de Secret Manager (roles/secretmanager.secretAccessor).

Los permisos de acceso de la instancia de VM del host deben tener acceso de escritura para publicar datos de métricas en tus proyectos de Google Cloud. Cuando creas una instancia de VM de Compute Engine nueva, se configura de forma automática con el permiso de acceso de escritura, https://www.googleapis.com/auth/monitoring.write.

Configura los roles de IAM necesarios

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

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

    Ir a IAM

  2. Selecciona tu proyecto de Google Cloud.

  3. 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.
  4. Selecciona la función necesaria de la lista de funciones disponibles:

    • Monitoring > Escritor de métricas de Monitoring
    • Secret Manager > Usuario con acceso a secretos de Secret Manager
  5. Haz clic en Agregar o Guardar para aplicar los roles a la cuenta de servicio.

Habilita la recopilación de métricas de supervisión de procesos y de evaluación de Workload Manager

Para habilitar la recopilación de métricas de Process Monitoring y métricas de evaluación de Workload Manager, sigue estos pasos:

  1. Establece una conexión SSH con la VM del host.
  2. Abre el siguiente archivo de configuración:

    /etc/google-cloud-sap-agent/configuration.json
  3. En la sección collection_configuration, configura los siguientes parámetros como true:

    • collect_process_metrics: permite que el agente recopile métricas de supervisión de procesos. Para la recopilación de métricas de la base de datos de SAP HANA, a fin de acceder y consultar la base de datos de SAP HANA, debes configurar parámetros adicionales en la sección hana_metrics_config.
    • collect_workload_validation_metrics: permite que el agente recopile métricas de validación de Workload Manager.

    Para obtener más información sobre los parámetros, consulta la siguiente tabla.

  4. De manera opcional, en cloud_properties, puedes actualizar los valores de parámetros que se configuran automáticamente. Para hacerlo, agrega la sección cloud_properties a tu archivo de configuración y, luego, especifica los parámetros obligatorios y sus valores.

  5. Guarda el archivo de configuración.

  6. Reinicia el agente para que se aplique la configuración nueva.

    sudo systemctl restart google-cloud-sap-agent

Parámetros de configuración

En la siguiente tabla se explican los parámetros de configuración de la versión 1 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.

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

Especifica el nombre de tu instancia de VM de Compute Engine. El agente lo detecta automáticamente después de la instalación.

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

La frecuencia de recopilación de las métricas de Monitoring, en segundos. El valor predeterminado para este parámetro es 5 segundos.

Aunque puedes actualizar la frecuencia de recopilación de las métricas de Monitoring, te recomendamos que uses el valor predeterminado. Si necesitas modificar el valor predeterminado, agrega el parámetro process_metrics_frequency en la sección collection_configuration y proporciona el valor requerido.

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 usar una contraseña de texto sin formato, te recomendamos que uses un secreto en Secret Manager mediante la especificación del nombre del secreto en hana_db_password_secret_name.

No especifiques una contraseña si usas Secret Manager para almacenar las credenciales de usuario de la base de datos. Cuando se especifican hana_db_password y hana_db_password_secret_name en la configuración, se activa un error y el agente no puede conectarse a la base de datos.

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.

Las métricas relacionadas con SAP HANA se recopilan solo si se configura hana_db_password_secret_name o hana_db_password.

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.

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.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.

Configuración predeterminada

{
  "provide_sap_host_agent_metrics": true,
  "log_level": "INFO",
  "log_to_cloud": true,
  "collection_configuration": {
    "collect_workload_validation_metrics": false,
    "collect_process_metrics": false
  }
}

Configuración de ejemplo

Para instalar el agente en una instancia de VM de Compute Engine, todos los parámetros y valores de configuración son opcionales. Si el archivo de configuración no se modifica, se usa la configuración predeterminada. En el siguiente ejemplo, se muestra un archivo de configuración completo para instalar el agente en una instancia de VM de Compute Engine.

{
  "provide_sap_host_agent_metrics": true,
  "bare_metal": false,
  "log_level": "INFO",
  "log_to_cloud": true,
  "collection_configuration": {
    "collect_workload_validation_metrics": false,
    "collect_process_metrics": true,
    "hana_metrics_config": {
      "hana_db_user": "user",
      "hana_db_password_secret_name": "secret-name"
      }
    }
}

Visualiza las métricas recopiladas

Para visualizar las métricas de supervisión de procesos que recopila el agente, puedes usar los siguientes paneles personalizados que proporciona Google Cloud:

  • Descripción general del agente de SAP - HANA En este panel, se proporcionan gráficos que muestran la descripción general del estado de las siguientes métricas: disponibilidad de SAP HANA, disponibilidad de SAP HANA con alta disponibilidad, replicación de SAP HANA con alta disponibilidad, estado del servicio de SAP HANA, clúster con alta disponibilidad: estado del nodo y clúster con alta disponibilidad: estado de recursos para instancias de SAP.

    El archivo JSON para este panel es sap-agent-status-overview.json.

  • Métricas sin procesar del agente de SAP - HANA: en este panel, se proporcionan gráficos que muestran valores de métricas sin procesar para las siguientes métricas: disponibilidad de SAP HANA, disponibilidad de SAP HANA con alta disponibilidad, replicación de SAP HANA con alta disponibilidad, estado del servicio de SAP HANA, clúster con alta disponibilidad: estado del nodo y clúster de alta disponibilidad: estado de recursos para instancias de SAP.

    El archivo JSON para este panel es sap-agent-raw-metrics.json.

Instala paneles

Para instalar un panel personalizado, sigue estos pasos:

Consola de Google Cloud

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

    Ir a Monitoring

  2. En el panel de navegación de Monitoring, haz clic en Paneles.

  3. Haz clic en la pestaña Biblioteca de muestra.

    Se muestra la pestaña de la biblioteca de muestra seleccionada.

  4. Para filtrar los paneles personalizados específicos del agente, en el campo Filtro, escribe Agent for SAP.

  5. (Opcional) Para ver los detalles sobre un panel o la vista previa de su contenido, haz clic en Vista previa.

  6. Selecciona el panel que deseas instalar.

  7. Haz clic en Importar y, luego, en Confirmar.

    El panel se agrega a los paneles disponibles en tu proyecto de Google Cloud. Para ver tu panel, sigue las instrucciones en Visualiza el panel instalado.

Google Cloud CLI

  1. Abre Cloud Shell:

    Abra Cloud Shell

  2. En Cloud Shell, clona o descarga el repositorio:

    git clone https://github.com/GoogleCloudPlatform/monitoring-dashboard-samples/

  3. En Cloud Shell, instala el panel necesario con el archivo JSON correspondiente:

    gcloud monitoring dashboards create --config-from-file=CONFIG_FROM_FILE

    Reemplaza CONFIG_FROM_FILE por la ruta de acceso al archivo JSON que contiene la configuración del panel. Los archivos de configuración del panel se pueden ubicar en la ruta: monitoring-dashboard-samples/dashboards/google-cloud-agent-for-sap.

    El panel se agrega a los paneles disponibles en tu proyecto de Google Cloud. Para ver tu panel, sigue las instrucciones en Visualiza el panel instalado.

Visualiza los paneles instalados

Para ver los paneles instalados, sigue estos pasos:

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

    Ir a Monitoring

  2. En el panel de navegación de Monitoring, haz clic en Paneles.

  3. Haz clic en el nombre del panel de la lista.

Si tienes muchos paneles, puedes filtrar los paneles personalizados o el nombre del panel nuevo. Si deseas obtener información para filtrar esta lista, consulta Visualiza paneles personalizados.

La siguiente imagen es un ejemplo que muestra una parte del panel personalizado para las métricas de SAP HANA en Monitoring.

La captura de pantalla muestra el panel personalizado para las métricas de SAP HANA en Monitoring

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.