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

Warnung: Der Support für den Google Cloud-Monitoring-Agent für SAP NetWeaver endete am 14. Februar 2024.

Wenn Sie den Monitoring-Agent für SAP NetWeaver verwenden, empfehlen wir, so schnell wie möglich den Nachfolger Google Cloud-Agent für SAP zu installieren. Der Agent für SAP kombiniert den Monitoring-Agent für SAP NetWeaver mit neuen Features wie Prozessmonitoring und Arbeitslastmanager-Bewertung.

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). Beispiele:

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

       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.

Hinweis: Der Monitoring-Agent für SAP NetWeaver ist nur ein lokaler HTTP-Server. Sie erfordert keinen externen Netzwerkzugriff.

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