Versión 1: 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 1 del agente de Google Cloud para SAP en instancias de VM de Compute Engine, instancias Bare Metal 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 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 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 se está ejecutando el agente, el estado muestra Running.

Si el agente de Google Cloud para SAP no está en ejecución, reinicia el agente.

Verifica que SAP Host Agent 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 supervisadas

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

Para ver las métricas supervisadas de SAP Host Agent, 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>

Verifica las métricas de Process Monitoring y las métricas de evaluación de Workload Manager

Después de actualizar la configuración, debes verificar que las métricas de Process Monitoring y las métricas de evaluación de Workload Manager estén disponibles. Puedes acceder a las métricas y a la información que recopila el agente de Google Cloud para SAP en Cloud Monitoring.

Para verificar las métricas en Monitoring, sigue estos pasos:

  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 procesamiento del host.

  2. Ejecuta el siguiente comando: 

    sudo systemctl restart google-cloud-sap-agent

Windows

  1. Establece una conexión RDP con la instancia de procesamiento 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 el agente de supervisión para SAP NetWeaver

Si instalas el agente de Google Cloud para SAP, se detectan de forma automática las versiones anteriores del agente de supervisión para SAP NetWeaver, se inhabilitan y, luego, se quita el agente del servidor host durante la instalación.

Si se detecta el agente de supervisión para SAP NetWeaver y se encuentra un archivo de configuración existente durante la instalación, el proceso de instalación migra automáticamente las configuraciones existentes al agente de Google Cloud para SAP.

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 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.5 (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 procesamiento del host.

  2. Ejecuta el siguiente comando: 

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

SLES

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

  2. Ejecuta el siguiente comando: 

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

Windows

  1. Establece una conexión RDP con la instancia de procesamiento 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.5 (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 procesamiento del host.

  2. Ejecuta el siguiente comando: 

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

SLES

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

  2. Ejecuta el siguiente comando: 

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

Windows

  1. Establece una conexión RDP con la instancia de procesamiento del host.

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

    googet install google-cloud-sap-agent

Revierte a una versión anterior

Si es necesario, puedes revertir el agente de Google Cloud para la versión 1 de SAP al agente de supervisión para la versión 2 de SAP NetWeaver.

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

RHEL

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

  2. Ejecuta el siguiente comando: 

    sudo yum remove google-cloud-sap-agent

  3. Instala el agente de supervisión para SAP NetWeaver versión 2. Si deseas obtener instrucciones para instalar el agente de supervisión para SAP NetWeaver, consulta la Guía de instalación de tu agente de supervisión para SAP NetWeaver.

SLES

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

  2. Ejecuta el siguiente comando: 

    sudo zypper remove google-cloud-sap-agent

  3. Instala el agente de supervisión para SAP NetWeaver versión 2. Si deseas obtener instrucciones a fin de instalar el agente de supervisión para SAP NetWeaver, consulta la Guía de instalación de tu agente de supervisión para SAP NetWeaver.

Windows

  1. Establece una conexión RDP con la instancia de procesamiento del host.

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

    googet remove google-cloud-sap-agent

  3. Instala el agente de supervisión para SAP NetWeaver versión 2. Si deseas obtener instrucciones para instalar el agente de supervisión para SAP NetWeaver, consulta la Guía de instalación de tu agente de supervisión para SAP NetWeaver.

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

Verás los registros que generaron las instancias de agente que se ejecutan en todas tus instancias de Compute Engine 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 tu instancia de Compute Engine 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.