Version 2: Betriebsanleitung für den Google Cloud-Agent für SAP

In diesem Leitfaden werden operative Überlegungen und Verfahren zum Ausführen der Version 2 des Google Cloud-Agents für SAP auf Compute Engine-VM-Instanzen und Bare-Metal-Lösungsservern behandelt.

Informationen zum Lebenszyklus eines Agents

Beim Verwalten der Vorgänge des Google Cloud-Agents für SAP ist es hilfreich, wenn Sie wissen, was der Agent tut. Im Allgemeinen funktioniert er so:

  • Sie müssen den Agent von Google Cloud für SAP auf jeder Compute Engine-VM-Instanz oder jedem Bare-Metal-Lösungsserver installieren, der SAP-Systeme hostet. Der Agent wird als Linux- oder Windows-Dienst ausgeführt.
  • Auf Compute Engine-VM-Instanzen kombiniert der Agent Monitoringdaten aus Monitoring und den Compute Engine APIs.
  • Auf Bare-Metal-Lösungsservern greift der Agent für die Erfassung nur von SAP-Host-Agent-Messwerten nicht auf die Google Cloud APIs zu.
  • Der SAP-Host-Agent fragt den Google Cloud-Agent für SAP über HTTP nach seinen im Cache gespeicherten Daten ab. Er fasst die Messwerte des SAP-Host-Agents zusammen, meldet sie und speichert sie in der SAP NetWeaver-Datenbank.
  • In der SAP-Transaktion ST06 oder der saposcol-Befehlszeile werden die aggregierten SAP-Host-Agent-Messwerte angezeigt.
  • Sie können die SAP Host Agent-Messwerte aus dem Google Cloud-Agent für SAP aufrufen. Führen Sie dazu einen Befehl in einem Terminalfenster aus.

Prüfen Sie, ob der Agent ausgeführt wird.

Nachdem Sie den Agent installiert oder neu gestartet haben, können Sie überprüfen, ob der Agent wie erwartet ausgeführt wird.

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

Linux

  1. Stellen Sie eine SSH-Verbindung zu Ihrem Bare-Metal-Lösungsserver oder Ihrer Compute Engine-Instanz her.

  2. Führen Sie dazu diesen Befehl aus: 

    systemctl status google-cloud-sap-agent

    Wenn der Agent ordnungsgemäß funktioniert, enthält die Ausgabe active (running). Beispiel: 

    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. Stellen Sie eine RDP-Verbindung zur Compute Engine-Instanz her.

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

    $(Get-Service -Name 'google-cloud-sap-agent' -ErrorAction Ignore).Status
     Wenn der Agent ausgeführt wird, wird der Status Running angezeigt.

Wenn der Google Cloud-Agent für SAP nicht ausgeführt wird, starten Sie den Agent neu.

Version des Agents prüfen

Nachdem Sie den Google Cloud-Agent für SAP installiert oder neu gestartet haben, können Sie die Version des Agents prüfen.

Führen Sie folgende Schritte aus, um die Version Ihres Agents zu prüfen:

Linux

Für RHEL führen Sie die folgenden Schritte aus:

  1. Stellen Sie eine SSH-Verbindung zum Hostcomputer her.
  2. Führen Sie dazu diesen Befehl aus: 
    yum info google-cloud-sap-agent

Für SLES führen Sie die folgenden Schritte aus:

  1. Stellen Sie eine SSH-Verbindung zum Hostcomputer her.
  2. Führen Sie dazu diesen Befehl aus: 
    zypper info google-cloud-sap-agent

Windows

  1. Stellen Sie eine RDP-Verbindung zum Hostcomputer her.
  2. Als Administrator führen Sie den folgenden Befehl in PowerShell aus: 
    googet installed google-cloud-sap-agent

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

Messwerte für den SAP-Host-Agent aufrufen

Nachdem Sie die Konfiguration des Google Cloud-Agent für SAP installiert oder aktualisiert haben, können Sie die überwachten Messwerte des SAP-Host-Agents aufrufen.

So rufen Sie die Messwerte des SAP-Host-Agents auf, die vom Google Cloud-Agent für SAP erfasst wurden:

Linux

  1. Stellen Sie eine SSH-Verbindung zu Ihrer Compute Engine-Hostinstanz oder Ihrem Bare-Metal-Lösungsserver her.

  2. Führen Sie dazu diesen Befehl aus: 

    curl http://localhost:18181

    Wenn die Messwerte verfügbar sind, sollten Sie eine XML-Ausgabe mit Informationen über Ihr System erhalten. Beispiel:

    <?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. Stellen Sie eine RDP-Verbindung zur Compute Engine-Instanz her.

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

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

    Wenn die Messwerte verfügbar sind, sollte eine XML-Ausgabe mit Informationen zu Ihrem System angezeigt werden. Beispiel:

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

Weitere Messwerte ansehen

Nachdem Sie die Konfiguration des Google Cloud-Agents für SAP aktualisiert haben, um die Prozess-Monitoring-Messwerte, Arbeitslastmanager-Bewertungsmesswerte oder die SAP HANA-Monitoringmesswerte zu erfassen, sollten Sie diese aufrufen, um zu überprüfen, ob der Agent die Messwerte wie erwartet erfasst.

Mit den folgenden Schritten können Sie die Messwerte und Informationen aufrufen, die vom Google Cloud-Agent für SAP in Cloud Monitoring erfasst wurden:

  1. Rufen Sie in der Google Cloud Console die Monitoring-Seite Metrics Explorer auf.

    Zu Metrics Explorer

  2. Wählen Sie den Tab Konfiguration aus.

  3. Maximieren Sie das Menü Messwert auswählen.

  4. Wählen Sie im Menü Ressourcen die Option VM-Instanz aus.

  5. Wählen Sie im Menü Messwertkategorie die Option SAP aus.

  6. Wählen Sie im Menü Messwert einen metric: workload.googleapis.com/sap/service/active oder einen der neuen Messwerte aus, die als Diagramm angezeigt werden sollen.

  7. Klicken Sie auf Anwenden.

Sie sollten nun ein Diagramm mit den Zeitachsenmesswerten sehen.

Agent neu starten

Wenn der Google Cloud-Agent für SAP nicht mehr funktioniert oder Sie seine Konfiguration aktualisieren, starten Sie den Agent neu.

Wählen Sie Ihr Betriebssystem aus und folgen Sie dann den Schritten:

Linux

  1. Stellen Sie eine SSH-Verbindung zu Ihrer Host-VM-Instanz oder Ihrem Bare-Metal-Lösung-Server her.

  2. Führen Sie dazu diesen Befehl aus: 

    sudo systemctl restart google-cloud-sap-agent

Windows

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

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

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

Von anderen Google Cloud-Agents auf Google Cloud-Agent für SAP aktualisieren

Wenn Sie den Google Cloud-Agent für SAP installieren, werden frühere Versionen des Monitoring-Agents für SAP NetWeaver und des Monitoring-Agents für SAP HANA automatisch erkannt, deaktiviert und dann während der Installation von den Hostcomputern entfernt.

Wenn diese Google Cloud-Agents erkannt werden, werden die Konfigurationen in ihren Konfigurationsdateien während der Installation auch zum Google Cloud-Agent für SAP migriert. Zu Sicherungs- und Referenzzwecken wird die Konfiguration des Monitoring-Agents für SAP HANA in die folgende Datei kopiert:

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

Eine Anleitung zum Installieren und Konfigurieren des Google Cloud-Agents für SAP finden Sie in der Installations- und Konfigurationsanleitung für den Google Cloud-Agent für SAP.

SSL-fähige Instanzen aktualisieren

Wenn Sie den Monitoring-Agent für SAP HANA so konfiguriert haben, dass er SSL-Zertifikate für die Kommunikation mit Ihren SAP HANA-Instanzen verwendet, müssen Sie bei der Installation des Google Cloud-Agents für SAP die gesamte SAP HANA-Monitoring-Konfiguration mit Ausnahme des SSL-Zertifikats ausführen. Die Konfiguration wird zum Google Cloud-Agent für SAP migriert. In einem solchen Fall müssen Sie die folgenden Schritte ausführen, um den Google Cloud-Agent für SAP zum Monitoring Ihrer SAP HANA-Instanzen zu verwenden:

  1. Stellen Sie eine SSH-Verbindung zu Ihrer Host-VM-Instanz oder Ihrem Bare-Metal-Lösung-Server her.

  2. Öffnen Sie die Konfigurationsdatei des Google Cloud-Agents für SAP:

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

  3. Legen Sie im Abschnitt hana_monitoring_configuration den Parameter enabled auf true fest.

  4. Führen Sie im Abschnitt hana_monitoring_configuration.hana_instances für jede SAP HANA-Instanz, die das TLS-/SSL-Protokoll für eine sichere Kommunikation verwendet, die folgenden Schritte aus:

    1. Geben Sie den Parameter enable_ssl an und legen Sie als Wert true fest.

    2. Geben Sie den Parameter host_name_in_certificate an und legen Sie den SAP HANA-Hostnamen, wie im TLS-/SSL-Zertifikat angegeben, als Wert fest.

    3. Geben Sie den Parameter tls_root_ca_file an und legen Sie den Pfad, unter dem das TLS/SSL-Zertifikat gespeichert ist, als Wert fest.

  5. Speichern Sie die Konfigurationsdatei.

  6. Starten Sie den Agent neu, damit die neuen Einstellungen wirksam werden:

    sudo systemctl restart google-cloud-sap-agent

  7. Prüfen Sie, ob der Agent die SAP HANA-Monitoringmesswerte erfasst. Eine Anleitung finden Sie unter Andere Messwerte ansehen.

  8. Monitoring-Agent für SAP HANA deinstallieren

Wenn nach diesem Upgrade Verbindungsprobleme mit Ihren SAP HANA-Instanzen auftreten, können Sie die Logs des Agents in Logging aufrufen und die Anleitung zur Behebung des Problems verwenden.

Google Cloud-Agent für SAP aktualisieren

Dieser Abschnitt enthält Schritte zum Prüfen, ob eine aktualisierte Version des Google Cloud-Agents für SAP verfügbar ist, und wie Sie auf Version 3.6 (aktuell) des Google Cloud-Agents für SAP aktualisieren können.

Wenn Sie auf eine Version des Agents aktualisieren müssen, die nicht die neueste ist, wenden Sie sich an Cloud Customer Care.

Auf Aktualisierungen überprüfen

Wählen Sie Ihr Betriebssystem aus und folgen Sie dann den Schritten:

RHEL

  1. Stellen Sie eine SSH-Verbindung zu Ihrer Host-VM-Instanz oder Ihrem Bare-Metal-Lösung-Server her.

  2. Führen Sie dazu diesen Befehl aus: 

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

SLES

  1. Stellen Sie eine SSH-Verbindung zu Ihrer Host-VM-Instanz oder Ihrem Bare-Metal-Lösung-Server her.

  2. Führen Sie dazu diesen Befehl aus: 

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

Windows

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

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

    googet latest google-cloud-sap-agent

Update installieren

Wählen Sie Ihr Betriebssystem aus und führen Sie dann die Schritte aus, um die Instanz von Google Cloud-Agent für SAP auf Version 3.6 (aktuell) zu aktualisieren.

Wenn Sie eine neue Version des Agents installieren müssen, wenden Sie sich an Cloud Customer Care.

RHEL

  1. Stellen Sie eine SSH-Verbindung zu Ihrer Host-VM-Instanz oder Ihrem Bare-Metal-Lösung-Server her.

  2. Führen Sie dazu diesen Befehl aus: 

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

SLES

  1. Stellen Sie eine SSH-Verbindung zu Ihrer Host-VM-Instanz oder Ihrem Bare-Metal-Lösung-Server her.

  2. Führen Sie dazu diesen Befehl aus: 

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

Windows

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

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

    googet install google-cloud-sap-agent

Rollback zur Verwendung des Monitoring-Agents für SAP HANA

Wenn Sie ein Rollback auf die Verwendung des Monitoring-Agents für SAP HANA ausführen und die SAP HANA-Monitoring-Funktion des Agents von Google Cloud für SAP nicht mehr verwenden möchten, führen Sie die folgenden Schritte aus:

RHEL

  1. Stellen Sie eine SSH-Verbindung zu Ihrer Host-VM-Instanz oder Ihrem Bare-Metal-Lösung-Server her.

  2. Um die Erfassung doppelter Messwerte zu verhindern, deaktivieren Sie die Erfassung von SAP HANA-Monitoring-Messwerten durch den Agent von Google Cloud für SAP:

    1. Öffnen Sie die Konfigurationsdatei des Google Cloud-Agents für SAP:

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

    2. Legen Sie im Abschnitt hana_monitoring_configuration den Parameter enabled auf false fest.

    3. Speichern Sie die Konfigurationsdatei.

    4. Starten Sie den Agent neu, damit die neuen Einstellungen wirksam werden:

      sudo systemctl restart google-cloud-sap-agent

  3. Kopieren Sie die Konfiguration des Monitoring-Agents für SAP HANA aus der folgenden Datei:

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

  4. Monitoring-Agent für SAP HANA Version 2 installieren Eine Installationsanleitung finden Sie in der Installations- und Betriebsanleitung für den Monitoring-Agent für SAP HANA V2.0.

  5. Fügen Sie in der folgenden Datei die Konfiguration des Monitoring-Agents für SAP HANA ein, die Sie in einem vorherigen Schritt kopiert haben:

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

  6. Starten Sie den Monitoring-Agent für SAP HANA neu:

    sudo systemctl start google-saphanamonitoring-agent

SLES

  1. Stellen Sie eine SSH-Verbindung zu Ihrer Host-VM-Instanz oder Ihrem Bare-Metal-Lösung-Server her.

  2. Um die Erfassung doppelter Messwerte zu verhindern, deaktivieren Sie die Erfassung von SAP HANA-Monitoring-Messwerten durch den Agent von Google Cloud für SAP:

    1. Öffnen Sie die Konfigurationsdatei des Google Cloud-Agents für SAP:

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

    2. Legen Sie im Abschnitt hana_monitoring_configuration den Parameter enabled auf false fest.

    3. Speichern Sie die Konfigurationsdatei.

    4. Starten Sie den Agent neu, damit die neuen Einstellungen wirksam werden:

      sudo systemctl restart google-cloud-sap-agent

  3. Kopieren Sie die Konfiguration des Monitoring-Agents für SAP HANA aus der folgenden Datei:

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

  4. Monitoring-Agent für SAP HANA Version 2 installieren Eine Installationsanleitung finden Sie in der Installations- und Betriebsanleitung für den Monitoring-Agent für SAP HANA V2.0.

  5. Fügen Sie in der folgenden Datei die Konfiguration des Monitoring-Agents für SAP HANA ein, die Sie in einem vorherigen Schritt kopiert haben:

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

  6. Starten Sie den Monitoring-Agent für SAP HANA neu:

    sudo systemctl start google-saphanamonitoring-agent

Logs des Agents in Cloud Logging ansehen

Standardmäßig werden die Logs für den Agent von Google Cloud für SAP von Ihren VM-Instanzen und Bare-Metal-Lösungsservern zu Cloud Logging umgeleitet.

So rufen Sie die Logs des Agents in Logging auf:

  1. Rufen Sie in der Google Cloud Console die Seite Log-Explorer auf.

    Zum Log-Explorer

  2. Rufen Sie den Bereich Abfrage auf.

  3. Wählen Sie im Drop-down-Menü Ressourcen die Option Global aus und klicken Sie dann auf Übernehmen.

  4. Geben Sie im Abfrageeditor google-cloud-sap-agent ein.

  5. Klicken Sie auf Abfrage ausführen.

Sie sollten die Logs sehen, die von den Agent-Instanzen generiert wurden, die auf allen VM-Instanzen oder Bare-Metal-Lösungsservern ausgeführt werden. Um die Logs von einer bestimmten Maschine zu filtern, verwenden Sie die in der Benutzeroberfläche verfügbaren Filter.

Sie können diese Standardweiterleitung der Agent-Logs deaktivieren. Führen Sie dazu die folgenden Schritte aus:

  1. Stellen Sie eine SSH-Verbindung zu Ihrer Host-VM-Instanz des Bare-Metal-Lösung-Servers her.

  2. Öffnen Sie die folgende Konfigurationsdatei:

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

  3. Aktualisieren Sie für den Parameter log_to_cloud den Wert auf false.

  4. Speichern Sie die Konfigurationsdatei.

  5. Starten Sie den Agent neu, damit diese Änderung wirksam wird.