Betriebsanleitung für Google Cloud-Monitoring-Agent für SAP NetWeaver

In dieser Anleitung werden betriebliche Überlegungen und Verfahren zum Ausführen des Monitoring-Agents für SAP NetWeaver auf Compute Engine-VMs und Bare-Metal-Lösungsservern behandelt.

Informationen zum Lebenszyklus des Monitoring-Agents

Beim Verwalten von Monitoringvorgängen ist es hilfreich, wenn Sie wissen, was der Monitoring-Agent für SAP NetWeaver tut. Im Allgemeinen funktioniert er so:

  • Sie müssen den Monitoring-Agent für SAP NetWeaver auf jeder Compute Engine-VM oder jedem Bare-Metal-Lösungsserver installieren, der SAP-Systeme hostet. Der Monitoring-Agent wird als Windows- oder Linux-Dienst ausgeführt.
  • Auf Compute Engine-VMs verfügt Cloud Monitoring über einen lokalen Agent, der Messwerte, Ereignisse und Metadaten aus Google Cloud erfasst. Compute Engine bietet auch APIs, die Monitoringfunktionen bereitstellen.
  • Auf Compute Engine-VMs kombiniert der Monitoring-Agent für SAP NetWeaver Monitoring-Daten aus Monitoring und den Compute Engine APIs. Auf Bare-Metal-Lösungsservern greift der Agent nicht auf die Google Cloud APIs zu.
  • Der SAP-Host-Agent fragt den Monitoring-Agent für SAP NetWeaver über HTTP nach seinen im Cache gespeicherten Daten ab. Er fasst die Messwerte zusammen, meldet sie und speichert sie in der SAP NetWeaver-Datenbank.
  • In der SAP-Transaktion ST06 oder der saposcol-Befehlszeile werden die aggregierten Messwerte angezeigt.
  • Sie können die Daten des Monitoring-Agents für SAP NetWeaver aufrufen, indem Sie einen Befehl in einem Terminalfenster ausführen.

Cloud API-Zugriff für den Monitoring-Agent für SAP NetWeaver

Wenn der Monitoring-Agent für SAP NetWeaver auf einer Compute Engine-VM ausgeführt wird, liest er Daten aus Monitoring.

Der Zugriff auf die Monitoring APIs kann durch IAM-Berechtigungen gesteuert werden, die dem Host-VM-Dienstkonto gewährt werden, durch die Google Cloud API-Zugriffsbereiche, die der VM zugewiesen sind, oder durch beides.

Compute Engine empfiehlt, nur die IAM-Berechtigungen des VM-Dienstkontos zu verwenden, um den Zugriff auf Google Cloud-Ressourcen zu steuern, und die VM-Zugriffsbereiche festzulegen, um vollständigen Zugriff auf alle Cloud APIs zu ermöglichen. Weitere Informationen finden Sie unter Best Practices.

Der Monitoring-Agent für SAP NetWeaver verwendet das Dienstkonto seiner Host-VM, um Cloud Monitoring-Messwerte abzurufen. Der Monitoring-Agent erfordert daher, dass die Host-VM über ein Dienstkonto verfügt und dass das Dienstkonto die Berechtigung monitoring.timeSeries.list enthält, die in der vordefinierten Monitoring-Betrachterrolle enthalten ist.

Wenn Sie den Zugriff auf die Cloud APIs beschränken, benötigt der Monitoring-Agent für SAP NetWeaver die folgenden Cloud API-Mindestzugriffsbereiche auf der Host-VM-Instanz:

  • Compute Engine: Schreibgeschützt
  • Stackdriver Monitoring API: Schreibgeschützt

Wenn Sie SAP NetWeaver auf einer VM ausführen, die keine externe IP-Adresse hat, müssen Sie den Zugriff auf die Google Cloud APIs und -Dienste für den Monitoring-Agent für SAP NetWeaver aktivieren.

Informationen zum Aktivieren des privaten Google-Zugriffs über eine Compute Engine-VM in einem Subnetz finden Sie unter Privaten Google-Zugriff konfigurieren.

Wenn Sie SAP NetWeaver auf einem Server in der Regionserweiterung der Bare-Metal-Lösung ausführen, benötigt der Monitoring-Agent für SAP NetWeaver keinen Zugriff auf die Google Cloud APIs.

Prüfen, ob der Monitoring-Agent für SAP NetWeaver ausgeführt wird

Der Monitoring-Agent für SAP NetWeaver ist ein lokaler HTTP-Server.

So prüfen Sie, ob der Monitoring-Agent ausgeführt wird:

Linux

  1. Stellen Sie eine SSH-Verbindung zu Ihrer Host-VM her.

  2. Führen Sie dazu diesen Befehl aus: 

    sudo systemctl status google-sapnetweavermonitoring-agent

    Wenn der Monitoring-Agent für SAP NetWeaver ordnungsgemäß funktioniert, enthält die Ausgabe active (running). Beispiel: 

    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. Stellen Sie über RDP eine Verbindung zu der VM-Instanz her, die Sie beobachten möchten.

  2. Führen Sie dazu diesen Befehl aus: 

    Get-Service -Name google-sapnetweavermonitoring-agent

    Wenn der Monitoring-Agent für SAP NetWeaver ordnungsgemäß funktioniert, wird in der Spalte Status der Eintrag Running angezeigt. Beispiel: 

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

Zum Prüfen der erfassten Messwerten finden Sie unter Überwachte Messwerte aufrufen.

Wenn der Monitoring-Agent für SAP NetWeaver nicht ausgeführt wird, finden Sie weitere Informationen unter Monitoring-Agent für SAP NetWeaver neu starten.

Prüfen, ob der SAP-Host-Agent Messwerte empfängt

Führen Sie die folgenden Schritte aus, um zu prüfen, ob die Infrastrukturmesswerte vom Agent von Google Cloud für SAP erfasst und korrekt an den SAP-Host-Agent gesendet werden:

  1. Geben Sie in Ihrem SAP-System Transaktion ST06 ein.

  2. Kontrollieren Sie im Übersichtsbereich die Verfügbarkeit und den Inhalt der folgenden Felder, um die korrekte End-to-End-Einrichtung der SAP- und Google-Monitoring-Infrastruktur zu überprüfen:

    • Cloud-Anbieter: Google Cloud Platform
    • Zugriff für erweitertes Monitoring: TRUE
    • Details für erweitertes Monitoring: ACTIVE

Überwachte Messwerte aufrufen

Sie können die überwachten Messwerte aufrufen, indem Sie den Server abfragen. Gehen Sie so vor:

Linux

  1. Verwenden Sie SSH, um eine Verbindung zum Hostcomputer herzustellen, den Sie beobachten möchten.

  2. Geben Sie bei der Eingabeaufforderung den folgenden Befehl ein:

    curl http://localhost:18181

Windows

  1. Stellen Sie eine RDP-Verbindung zu dem Hostcomputer her, den Sie beobachten möchten.

  2. Rufen Sie in einem Webbrowser die folgende URL auf:

    http://localhost:18181

Das folgende Beispiel zeigt die ersten Zeilen der XML-Ausgabe des Monitoring-Agents für SAP NetWeaver.

Compute Engine-VM 

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

Bare Metal Solution-Server

Der Monitoring-Agent für SAP NetWeaver ist ordnungsgemäß für eine Hostcomputer der Bare-Metal-Lösung konfiguriert, wenn der Wert Instance Type bms-nn zeigt und der Wert Hardware Model Google Cloud Bare Metal ist, wie im folgenden Beispiel gezeigt.

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

Starten Sie den Monitoring-Agent für SAP NetWeaver neu.

Wenn der Monitoring-Agent für SAP NetWeaver nicht mehr funktioniert, starten Sie den Monitoring-Agent neu.

Wählen Sie Ihr Betriebssystem aus:

Linux

  1. Stellen Sie eine SSH-Verbindung zu Ihrer Host-VM her.

  2. Führen Sie dazu folgenden Befehl aus: 

    systemctl restart google-sapnetweavermonitoring-agent

Windows

  1. Stellen Sie eine RDP-Verbindung zu Ihrer Host-VM her.

  2. Führen Sie dazu folgenden Befehl aus: 

    Restart-Service -Force google-sapnetweavermonitoring-agent

Monitoring-Agent für SAP NetWeaver aktualisieren

Um sicherzustellen, dass Sie die neueste Version des Monitoring-Agents für SAP NetWeaver verwenden, sollten Sie regelmäßig nach Updates suchen.

Auf Aktualisierungen überprüfen

Wählen Sie Ihr Betriebssystem aus:

RHEL

So prüfen Sie, ob die Monitoring-Agent-Updates mit dem Paketmanager ausgeführt werden:

  1. Stellen Sie eine SSH-Verbindung zu Ihrer Host-VM her.

  2. Führen Sie dazu folgenden Befehl aus: 

    sudo yum check-update google-sapnetweavermonitoring-agent

SLES

So prüfen Sie, ob die Monitoring-Agent-Updates mit dem Paketmanager ausgeführt werden:

  1. Stellen Sie eine SSH-Verbindung zu Ihrer Host-VM her.

  2. Führen Sie dazu folgenden Befehl aus: 

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

Windows

So prüfen Sie, ob Updates für den Monitoring-Agent vorhanden sind:

  1. Stellen Sie eine RDP-Verbindung zu Ihrer Host-VM her.

  2. Als Administrator führen Sie den folgenden Befehl in PowerShell aus: 

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

Update installieren

Wählen Sie Ihr Betriebssystem aus:

RHEL

So installieren Sie den Monitoring-Agent mit dem Paketmanager:

  1. Stellen Sie eine SSH-Verbindung zu Ihrer Host-VM her.

  2. Führen Sie dazu folgenden Befehl aus: 

    sudo yum --nogpgcheck update google-sapnetweavermonitoring-agent

SLES

So installieren Sie den Monitoring-Agent mit dem Paketmanager:

  1. Stellen Sie eine SSH-Verbindung zu Ihrer Host-VM her.

  2. Führen Sie dazu folgenden Befehl aus: 

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

Windows

So installieren Sie den Monitoring-Agent:

  1. Stellen Sie eine RDP-Verbindung zu Ihrer Host-VM her.

  2. Als Administrator führen Sie den folgenden Befehl in PowerShell aus: 

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