Versión 2: Guía de operaciones del agente de Google Cloud para SAP

En esta guía se abordan las consideraciones operativas y los procedimientos para ejecutar la versión 2 del agente de Google Cloud para SAP en instancias de VM de Compute Engine y servidores de la solución Bare Metal.

Comprende el ciclo de vida del agente

Cuando administras las operaciones del agente de Google Cloud para SAP, es útil comprender lo que hace el agente. En general, funciona de la siguiente manera:

  • Debes instalar el agente de Google Cloud para SAP en cada instancia de VM de Compute Engine o servidor de solución Bare Metal que aloja sistemas SAP. El agente se ejecuta como un servicio de Linux o Windows.
  • En las instancias de VM de Compute Engine, el agente combina los datos de supervisión de Monitoring y las APIs de Compute Engine.
  • En los servidores de la solución Bare Metal, el agente no accede a las APIs de Google Cloud para recopilar solo las métricas de SAP Host Agent.
  • SAP Host Agent solicita al agente de Google Cloud para SAP sus datos almacenados en caché a través de HTTP. Agrega las métricas de SAP Host Agent, las informa y las almacena en la base de datos de SAP NetWeaver.
  • La transacción ST06 de SAP o la interfaz de línea de comandos saposcol muestran las métricas agregadas de SAP Host Agent.
  • Puedes ver las métricas de SAP Host Agent del agente de Google Cloud para SAP si ejecutas un comando en una ventana de la terminal.

Verifica que el agente esté en ejecución

Después de instalar o reiniciar el agente, puedes verificar que el agente se ejecute como se espera.

Para verificar si el agente está en ejecución, sigue estos pasos:

Linux

  1. Establece una conexión SSH con tu servidor de la solución Bare Metal o instancia de VM.

  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 de Google Cloud para SAP no está en ejecución, reinicia el agente.

Verifica la versión del agente

Después de instalar o reiniciar el agente de Google Cloud para SAP, puedes verificar la versión del agente.

Para ver la versión de tu agente, completa los siguientes pasos:

Linux

Para RHEL, sigue estos pasos:

  1. Usa SSH para conectarte a la máquina anfitrión.
  2. Ejecuta el siguiente comando:
    yum info google-cloud-sap-agent

Para SLES, sigue estos pasos:

  1. Usa SSH para conectarte a la máquina anfitrión.
  2. Ejecuta el siguiente comando:
    zypper info google-cloud-sap-agent

Windows

  1. Usa RDP para conectarte a la máquina anfitrión.
  2. Como administrador, ejecuta el siguiente comando desde PowerShell: 
    googet installed google-cloud-sap-agent

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

Visualiza las métricas de SAP Host Agent

Después de instalar o actualizar la configuración del agente de Google Cloud para SAP, puedes ver las métricas recopiladas de SAP Host Agent.

Si deseas ver las métricas de SAP Host Agent que recopila el agente de Google Cloud para SAP, sigue estos pasos:

Linux

  1. Establece una conexión SSH con la instancia de VM del host del servidor de la solución Bare Metal.

  2. Ejecuta el siguiente comando: 

    curl http://localhost:18181

    Si las métricas están disponibles, deberías recibir un resultado XML que contenga información sobre tu sistema. Por ejemplo:

    <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
  <metrics>
  <metric category="cpu" context="vm" type="double" unit="Percent" last-refresh="1670422670" refresh-interval="60">
  <name>VM Processing Power Consumption</name>
  <value>0.0</value>
  </metric>

Windows

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

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

    (Invoke-WebRequest -Uri 'http://localhost:18181').RawContent

    Si las métricas están disponibles, deberías ver un resultado de XML que contenga información sobre tu sistema. Por ejemplo:

    <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
  <metrics>
  <metric category="cpu" context="vm" type="double" unit="Percent" last-refresh="1670422528" refresh-interval="60">
  <name>VM Processing Power Consumption</name>
  <value>10.0</value>
  </metric>

Visualiza las otras métricas

Después de actualizar la configuración del agente de Google Cloud para SAP con el fin de recopilar 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, debes verlas para verificar que el agente esté recopilando las métricas como se esperaba.

Si completas estos pasos, puedes ver las métricas y la información que recopila el agente de Google Cloud para SAP en Cloud Monitoring:

  1. En la consola de Google Cloud, ve a la página Explorador de métricas de Cloud Monitoring.

    Ir al Explorador de métricas

  2. Selecciona la pestaña Configuración.

  3. Expande el menú Seleccionar una métrica.

  4. En el menú Recursos activos, selecciona Instancia de VM.

  5. En el menú Categoría de métrica, selecciona sap.

  6. En el menú Métrica, selecciona metric: workload.googleapis.com/sap/service/active o cualquiera de las métricas nuevas para representar.

  7. Haz clic en Aplicar.

Deberías ver un gráfico con los valores de la métrica de series temporales.

Reinicia el agente

Si el agente de Google Cloud para SAP deja de funcionar o actualizas su configuración, reinicia el agente.

Selecciona tu sistema operativo y, luego, sigue estos pasos:

Linux

  1. Establece una conexión SSH con la instancia de VM del host del servidor de la solución Bare Metal.

  2. Ejecuta el siguiente comando:

    sudo systemctl restart google-cloud-sap-agent

Windows

  1. Establece una conexión RDP con la VM del host.

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

    Restart-Service -Name 'google-cloud-sap-agent' -Force

Actualiza al agente de Google Cloud para SAP desde otros agentes de Google Cloud

Cuando se instala el agente de Google Cloud para SAP, se detectan de forma automática las versiones anteriores del agente de supervisión para SAP NetWeaver y el agente de supervisión para SAP HANA, los inhabilita y, luego, los quita de tus máquinas anfitrión durante la instalación.

Si se detectan estos agentes de Google Cloud, las opciones de configuración en sus archivos de configuración también se migran al agente de Google Cloud para SAP durante su instalación. Con fines de copia de seguridad y referencia, la configuración del agente de supervisión para SAP HANA se copia en el siguiente archivo:

/etc/google-cloud-sap-agent/backup-of-hanamonitoring-configuration.yaml

Si deseas obtener instrucciones para instalar y configurar el agente de Google Cloud para SAP, consulta la Guía de instalación y configuración del agente de Google Cloud para SAP.

Actualiza instancias habilitadas para SSL

Si configuraste el agente de supervisión para SAP HANA a fin de usar certificados SSL para comunicarse con tus instancias de SAP HANA, cuando instales el agente de Google Cloud para SAP, toda la configuración de supervisión de SAP HANA, excepto la configuración de SSL, se migra al agente de Google Cloud para SAP. En ese caso, debes usar el agente de Google Cloud para SAP a fin de supervisar tus instancias de SAP HANA, debes completar los siguientes pasos:

  1. Establece una conexión SSH con la instancia de VM del host del servidor de la solución Bare Metal.

  2. Abre el archivo de configuración del agente de Google Cloud para SAP:

    /etc/google-cloud-sap-agent/configuration.json

  3. En la sección hana_monitoring_configuration, configura el parámetro enabled como true.

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

  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

  7. Verifica que el agente recopile las métricas de supervisión de SAP HANA. Para obtener instrucciones, consulta Visualiza las otras métricas.

  8. Desinstala el agente de supervisión para SAP HANA.

Si tienes problemas de conexión con tus instancias de SAP HANA después de esta actualización, puedes ver los registros del agente en Logging y usar la guía de solución de problemas para resolver el problema.

Actualiza el agente de Google Cloud para SAP

En esta sección, se proporcionan pasos para verificar si hay una versión actualizada del agente de Google Cloud para SAP disponible y cómo puedes actualizar a la versión 3.3 (más reciente) del agente de Google Cloud para SAP.

Si necesitas actualizar a una versión del agente que no sea la más reciente, comunícate con el servicio de Atención al cliente de Cloud.

Comprueba actualizaciones

Selecciona tu sistema operativo y, luego, sigue estos pasos:

RHEL

  1. Establece una conexión SSH con la instancia de VM del host del servidor de la solución Bare Metal.

  2. Ejecuta el siguiente comando:

    sudo yum check-update google-cloud-sap-agent

SLES

  1. Establece una conexión SSH con la instancia de VM del host del servidor de la solución Bare Metal.

  2. Ejecuta el siguiente comando:

    sudo zypper list-updates -r google-cloud-sap-agent

Windows

  1. Establece una conexión RDP con la VM del host.

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

    googet latest google-cloud-sap-agent

Instala una actualización

Si quieres actualizar la instancia del agente de Google Cloud para SAP a la versión 3.3 (más reciente), selecciona tu sistema operativo y, luego, sigue los pasos.

Si necesitas instalar una versión del agente que no sea la más reciente, comunícate con el servicio de Atención al cliente de Cloud.

RHEL

  1. Establece una conexión SSH con la instancia de VM del host del servidor de la solución Bare Metal.

  2. Ejecuta el siguiente comando:

    sudo yum --nogpgcheck update google-cloud-sap-agent

SLES

  1. Establece una conexión SSH con la instancia de VM del host del servidor de la solución Bare Metal.

  2. Ejecuta el siguiente comando:

    sudo zypper --no-gpg-checks update google-cloud-sap-agent

Windows

  1. Establece una conexión RDP con la VM del host.

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

    googet install google-cloud-sap-agent

Revierte al uso del agente de supervisión para SAP HANA

Si deseas revertir al uso del agente de supervisión para SAP HANA y dejar de usar la función de supervisión de SAP HANA del agente de Google Cloud para SAP, sigue estos pasos:

RHEL

  1. Establece una conexión SSH con la instancia de VM del host del servidor de la solución Bare Metal.

  2. Para evitar la recopilación de métricas duplicadas, inhabilita la recopilación de métricas de supervisión de SAP HANA del agente de Google Cloud para SAP:

    1. Abre el archivo de configuración del agente de Google Cloud para SAP:

      /etc/google-cloud-sap-agent/configuration.json

    2. En la sección hana_monitoring_configuration, configura el parámetro enabled como false.

    3. Guarda el archivo de configuración.

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

      sudo systemctl restart google-cloud-sap-agent

  3. Copia la configuración del agente de supervisión para SAP HANA desde el siguiente archivo:

    /etc/google-cloud-sap-agent/backup-of-hanamonitoring-configuration.yaml

  4. Instala el agente de supervisión para SAP HANA versión 2. Si deseas obtener instrucciones de instalación, consulta la guía de instalación y operación del agente de supervisión para SAP HANA V2.0.

  5. En el siguiente archivo, pega la configuración del agente de supervisión para SAP HANA que copiaste en un paso anterior:

    /usr/sap/google-saphanamonitoring-agent/conf/configuration.yaml

  6. Reinicia el agente de supervisión para SAP HANA:

    sudo systemctl start google-saphanamonitoring-agent

SLES

  1. Establece una conexión SSH con la instancia de VM del host del servidor de la solución Bare Metal.

  2. Para evitar la recopilación de métricas duplicadas, inhabilita la recopilación de métricas de supervisión de SAP HANA del agente de Google Cloud para SAP:

    1. Abre el archivo de configuración del agente de Google Cloud para SAP:

      /etc/google-cloud-sap-agent/configuration.json

    2. En la sección hana_monitoring_configuration, configura el parámetro enabled como false.

    3. Guarda el archivo de configuración.

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

      sudo systemctl restart google-cloud-sap-agent

  3. Copia la configuración del agente de supervisión para SAP HANA desde el siguiente archivo:

    /etc/google-cloud-sap-agent/backup-of-hanamonitoring-configuration.yaml

  4. Instala el agente de supervisión para SAP HANA versión 2. Si deseas obtener instrucciones de instalación, consulta la guía de instalación y operación del agente de supervisión para SAP HANA V2.0.

  5. En el siguiente archivo, pega la configuración del agente de supervisión para SAP HANA que copiaste en un paso anterior:

    /usr/sap/google-saphanamonitoring-agent/conf/configuration.yaml

  6. Reinicia el agente de supervisión para SAP HANA:

    sudo systemctl start google-saphanamonitoring-agent

Visualiza los registros del agente en Cloud Logging

De forma predeterminada, los registros para el agente de Google Cloud para SAP se redireccionan de tus instancias de VM y los servidores de la solución Bare Metal a Cloud Logging.

Para ver los registros del agente en Logging, sigue estos pasos:

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

    Ir al Explorador de registros

  2. Ve al panel Consulta.

  3. En el menú desplegable Recursos, selecciona Global y, luego, haz clic en Aplicar.

  4. En el Editor de consultas, ingresa google-cloud-sap-agent.

  5. Haz clic en Ejecutar consulta.

Deberías ver los registros que generaron las instancias de agente que se ejecutan en todas tus instancias de VM o servidores de la solución Bare Metal. Para filtrar los registros de una máquina específica, usa los filtros disponibles en la interfaz.

Puedes inhabilitar este redireccionamiento predeterminado de los registros del agente. Para hacerlo, sigue estos pasos:

  1. Establece una conexión SSH con la instancia de VM del host del servidor de la solución Bare Metal.

  2. Abre el siguiente archivo de configuración:

    /etc/google-cloud-sap-agent/configuration.json

  3. Para el parámetro log_to_cloud, actualiza el valor a false.

  4. Guarda el archivo de configuración.

  5. Reinicia el agente para que se aplique este cambio.