Guía de operaciones del agente de supervisión de Google Cloud para SAP NetWeaver

En esta guía, se abordan las consideraciones operativas y los procedimientos para ejecutar el agente de supervisión de SAP NetWeaver en VMs de Compute Engine y servidores de soluciones Bare Metal.

Comprende el ciclo de vida del agente de supervisión

Cuando administras las operaciones de supervisión, es útil comprender lo que hace el agente de supervisión para SAP NetWeaver. En general, funciona de la siguiente manera:

  • Debes instalar el agente de supervisión para SAP NetWeaver en cada VM de Compute Engine o servidor de la solución Bare Metal que aloja sistemas SAP. El agente de supervisión se ejecuta como un servicio de Windows o un servicio de Linux.
  • En las VMs de Compute Engine, Cloud Monitoring tiene un agente local que recopila métricas, eventos y metadatos de Google Cloud. Compute Engine también proporciona las APIs que proveen funciones de supervisión.
  • En las VMs de Compute Engine, el agente de supervisión para SAP NetWeaver combina 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.
  • SAP Host Agent analiza al agente de supervisión para SAP NetWeaver en busca de sus datos almacenados en caché a través de HTTP. Agrega las métricas, 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.
  • Puedes ver los datos del agente de supervisión para SAP NetWeaver si ejecutas un comando en una ventana de la terminal.

Acceso a la API de Cloud para el agente de supervisión para SAP NetWeaver

Cuando el agente de supervisión para SAP NetWeaver se ejecuta en una VM de Compute Engine, lee datos de Monitoring.

El acceso a las API de Monitoring se puede controlar a través de los permisos de IAM otorgados a la cuenta de servicio de VM del host, a través de los permisos de acceso a la API de Google Cloud que se otorgaron a la VM o a través de ambas opciones.

Compute Engine recomienda usar solo los permisos de IAM de la cuenta de servicio de VM para controlar el acceso a los recursos de Google Cloud y configurar los permisos de acceso de VM para permitir el acceso completo a todas las API de Cloud. Para obtener más información, consulta las Prácticas recomendadas.

El agente de supervisión para SAP NetWeaver usa la cuenta de servicio de su VM host para recuperar las métricas de Cloud Monitoring. En consecuencia, el agente de supervisión requiere que la VM host tenga una cuenta de servicio y que esta cuenta incluya el permiso monitoring.timeSeries.list, que se incluye en la función de visualizador predefinida de Monitoring.

Si limitas el acceso a las API de Cloud, el agente de supervisión para SAP NetWeaver requiere los siguientes permisos mínimos de acceso a la API de Cloud en la instancia de VM del host:

  • Compute Engine: solo lectura
  • API de Stackdriver Monitoring: Solo lectura

Si ejecutas SAP NetWeaver en una VM que no tiene una dirección IP externa, debes habilitar el acceso a las API y los servicios de Google Cloud para el agente de supervisión para SAP NetWeaver.

Si quieres habilitar el acceso privado a Google desde una VM de Compute Engine en una subred, consulta Configura el acceso privado a Google.

Si estás ejecutando SAP NetWeaver en un servidor con una extensión regional de solución Bare Metal, el agente de supervisión para SAP NetWeaver no requiere acceso a las APIs de Google Cloud.

Verifica que el agente de supervisión para SAP NetWeaver esté en ejecución

El agente de supervisión para SAP NetWeaver es un servidor HTTP local.

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

Linux

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

  2. Ejecuta el siguiente comando: 

    sudo systemctl status google-sapnetweavermonitoring-agent

    Si el agente de supervisión para SAP NetWeaver funciona de manera correcta, el resultado contiene active (running). Por ejemplo: 

    google-sapnetweavermonitoring-agent.service - Google Cloud monitoring agent for SAP NetWeaver
Loaded: loaded (/usr/lib/systemd/system/google-sapnetweavermonitoring-agent.service; enabled; vendor preset: disabled)
Active:  active (running)  since Thu 2021-09-02 07:21:42 UTC; 742ms ago
Main PID: 10723 (java)
Tasks: 26 (limit: 512)
CGroup: /system.slice/google-sapnetweavermonitoring-agent.service
       └─10723 /usr/sap/google-sapnetweavermonitoring-agent/jre/bin/java -Xms32m -Xmx64m -cp /usr/sap/google-sapnetweavermonitoring-age...

Windows

  1. Usa RDP para conectarte a la instancia de VM que deseas supervisar.

  2. Ejecuta el siguiente comando: 

    Get-Service -Name google-sapnetweavermonitoring-agent

    Si el agente de supervisión para SAP NetWeaver funciona de manera correcta, la columna Status muestra Running. Por ejemplo: 

        Status   Name               DisplayName
    ------   ----               -----------
    Running  google-sapnetwe... Google Cloud monitoring agent for S...

Para verificar las métricas recopiladas, consulta Visualiza las métricas supervisadas.

Si el agente de supervisión para SAP NetWeaver no está en ejecución, consulta la sección sobre Cómo reiniciar el agente de supervisión para SAP NetWeaver.

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

Puedes ver las métricas supervisadas si envías una consulta al servidor. Lleva a cabo los pasos siguientes:

Linux

  1. Usa SSH para conectarte a la máquina anfitrión que debes supervisar.

  2. En el símbolo del sistema, ingresa el siguiente comando:

    curl http://localhost:18181

Windows

  1. Usa RDP para conectarte a la máquina anfitrión que debes supervisar.

  2. En un navegador web, visita la siguiente URL:

    http://localhost:18181

En el siguiente ejemplo, se muestran las primeras líneas del resultado de XML del agente de supervisión para SAP NetWeaver.

VM de Compute Engine 

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<metrics>
<metric category="config" context="vm" type="string" unit="none"
  last-refresh="1614389614" refresh-interval="0"><name>Data
  Provider Version</name><value>1.1.1.0</value>
</metric>
<metric category="config" context="host" type="string" unit="none"
last-refresh="1614389614" refresh-interval="0">
  <name>Cloud Provider</name><value>Google Cloud
  Platform</value>
</metric>
<metric category="config" context="vm" type="string" unit="none"
last-refresh="1614389614" refresh-interval="0">
  <name>Instance Type</name><value>n2-standard-16</value>
</metric>
<metric category="config" context="host" type="string" unit="none"
last-refresh="1614389614" refresh-interval="0">
  <name>Virtualization Solution</name><value>KVM</value>
</metric>
...
</metrics>

Servidor de solución Bare Metal

El agente de supervisión para SAP NetWeaver se configuró correctamente para una máquina anfitrión de la solución Bare Metal si el valor de Instance Type muestra bms-nn y el valor Hardware Model es Google Cloud Bare Metal, como se muestra en el siguiente ejemplo.

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<metrics>
<metric category="config" context="vm" type="string" unit="none"
last-refresh="1614391024" refresh-interval="0"><name>Data
Provider Version</name><value>1.1.1.0</value>
</metric><metric category="config" context="host" type="string"
unit="none" last-refresh="1614391024" refresh-interval="0">
<name>Cloud Provider</name><value>Google Cloud
Platform</value></metric><metric category="config"
context="vm" type="string" unit="none" last-refresh="1614391024"
refresh-interval="0"><name>Instance Type</name>
<value>bms-16.0</value></metric><metric
category="config" context="host" type="string" unit="none"
last-refresh="1614391024" refresh-interval="0"><name>Virtualization
Solution</name><value>N/A</value></metric><metric
category="config" context="host" type="string" unit="none"
last-refresh="1614391024" refresh-interval="0"><name>Hardware Manufacturer</name><value>Google</value></metric>
<metric category="config" context="host" type="string" unit="none"
last-refresh="1614391024" refresh-interval="0"><name>Hardware
Model</name><value>Google Cloud Bare Metal</value>
</metric>
...
</metrics>

Reinicia el agente de supervisión para SAP NetWeaver

Si el agente de supervisión para SAP NetWeaver deja de funcionar, reinicia el agente de supervisión.

Selecciona tu sistema operativo:

Linux

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

  2. Ejecuta el siguiente comando: 

    systemctl restart google-sapnetweavermonitoring-agent

Windows

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

  2. Ejecuta el siguiente comando: 

    Restart-Service -Force google-sapnetweavermonitoring-agent

Actualiza el agente de supervisión para SAP NetWeaver

A fin de asegurarte de tener la última versión del agente de supervisión para SAP NetWeaver, verifica si hay actualizaciones periódicamente.

Comprueba actualizaciones

Selecciona tu sistema operativo:

RHEL

Para verificar las actualizaciones del agente de supervisión mediante el administrador de paquetes, haz lo siguiente:

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

  2. Ejecuta el siguiente comando: 

    sudo yum check-update google-sapnetweavermonitoring-agent

SLES

Para verificar las actualizaciones del agente de supervisión mediante el administrador de paquetes, haz lo siguiente:

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

  2. Ejecuta el siguiente comando: 

    sudo zypper list-updates -r google-sapnetweavermonitoring-agent

Windows

Para comprobar las actualizaciones del agente de supervisión, haz lo siguiente:

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

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

    C:\Program Files\Google\google-sapnetweavermonitoring-agent\bin\updatecheck.ps1

Instala una actualización

Selecciona tu sistema operativo:

RHEL

Para instalar el agente de supervisión mediante el administrador de paquetes, haz lo siguiente:

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

  2. Ejecuta el siguiente comando: 

    sudo yum --nogpgcheck update google-sapnetweavermonitoring-agent

SLES

Para instalar el agente de supervisión mediante el administrador de paquetes, haz lo siguiente:

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

  2. Ejecuta el siguiente comando: 

    sudo zypper --no-gpg-checks update google-sapnetweavermonitoring-agent

Windows

Para instalar el agente de supervisión, haz lo siguiente:

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

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

    . { Invoke-WebRequest -useb https://storage.googleapis.com/cloudsapdeploy/netweaver-agent-windows/install.ps1 } | iex