Version 1: Google Cloud-Agent für SAP auf einer Compute Engine-Instanz installieren und konfigurieren

Der Google Cloud-Agent für SAP ist für die SAP-Unterstützung von SAP-Systemen erforderlich, die in Google Cloud ausgeführt werden, einschließlich SAP NetWeaver, SAP HANA, SAP ASE, SAP MaxDB und andere.

Wenn Sie den Google Cloud-Agent für SAP auf einer Compute Engine-Instanz installieren, kombiniert der Agent für SAP-Host-Agent-Messwerte die Monitoring-Daten von Cloud Monitoring und den Compute Engine APIs und stellt diese Daten dem SAP-Host-Agent zur Verfügung.

Wenn Sie die folgenden von Google Cloud bereitgestellten Betriebssystem-Images für RHEL oder SLES für SAP verwenden, ist der Agent von Google Cloud für SAP mit den Betriebssystem-Images verpackt:

• RHEL: alle "für SAP"-Images
• SLES: SLES 15 SP4 für SAP und höhere Versionen

Informationen zu den Betriebssystemen, die vom Agent von Google Cloud für SAP unterstützt werden, finden Sie unter Unterstützte Betriebssysteme.

Informationen zum Installieren und Konfigurieren von Version 1 des Google Cloud-Agents für SAP auf einem Bare-Metal-Lösungsserver finden Sie unter Google Cloud-Agent für SAP auf einem Bare-Metal-Lösungsserver installieren.

Installation

Unter Linux installieren Sie den Google Cloud-Agent für SAP mithilfe von Standardbefehlen zur Betriebssystempaketverwaltung: auf RHEL mit dem Befehl yum, auf SLES mit dem Befehl zypper. Der Befehl zur Paketverwaltung führt die folgenden Aufgaben aus:

• Lädt den Google Cloud-Agent für SAP herunter.
• Erstellt den Agent als Linux-systemd-Dienst mit dem Namen google-cloud-sap-agent.
• Aktiviert und startet den Dienst google-cloud-sap-agent.

Unter Windows installieren Sie den Google Cloud-Agent für SAP mit dem GooGet-Befehl zur Paketverwaltung googet. Der Befehl zur Paketverwaltung führt die folgenden Aufgaben aus:

• Lädt den Google Cloud-Agent für SAP herunter.

• Es erstellt einen Windows-Dienst mit dem Namen google-cloud-sap-agent und eine geplante Aufgabe, die jede Minute ausgeführt wird, um zu prüfen, ob der Dienst noch ausgeführt wird, und ihn bei Bedarf neu zu starten.

Voraussetzungen für den Agent

Prüfen Sie vor der Installation des Google Cloud-Agents für SAP, ob die folgenden Voraussetzungen erfüllt sind.

Erforderliche IAM-Rollen festlegen

Das Dienstkonto, das der Google Cloud Agent für SAP verwendet, muss mindestens die Rollen Compute-Betrachter (roles/compute.viewer), Monitoring-Betrachter (roles/monitoring.viewer) und Workload Manager Insights Writer (roles/workloadmanager.insightWriter) enthalten.

So fügen Sie Ihrem Dienstkonto eine erforderliche Rolle hinzu:

1. Öffnen Sie in der Google Cloud Console die Seite IAM.

   IAM aufrufen

2. Wählen Sie Ihr Google Cloud-Projekt aus.

3. Bestimmen Sie das Dienstkonto, dem Sie eine Rolle hinzufügen möchten.

   • Wenn sich das Dienstkonto nicht schon in der Mitgliederliste befindet, sind ihm keine Rollen zugewiesen. Klicken Sie auf Hinzufügen und geben Sie die E-Mail-Adresse des Dienstkontos ein.
   • Wenn sich das Dienstkonto in der Liste der Hauptkonten befindet, sind ihm bereits Rollen zugewiesen. Klicken Sie für das Dienstkonto, das Sie bearbeiten möchten, auf die Schaltfläche Bearbeiten .

4. Wählen Sie die erforderliche Rolle in der Liste der verfügbaren Rollen aus:

   • Compute Engine > Compute-Betrachter
   • Monitoring > Monitoring-Betrachter
   • Arbeitslastmanager > Autor von Arbeitslastmanager-Statistiken

5. Klicken Sie auf Hinzufügen oder Speichern, um dem Dienstkonto die Rollen zuzuweisen.

Zugriff auf Google Cloud APIs aktivieren

Compute Engine empfiehlt, Ihre Compute-Instanzen so zu konfigurieren, dass sie allen Cloud APIs alle Zugriffsbereiche gewähren und dass Sie nur die IAM-Berechtigungen des Instanzdienstkontos verwenden, um den Zugriff auf Google Cloud-Ressourcen zu steuern. Weitere Informationen finden Sie unter VM mit vom Nutzer verwalteten Dienstkonto erstellen.

Wenn Sie den Zugriff auf die Cloud APIs beschränken, benötigt der Google Cloud-Agent für SAP die folgenden Mindestbereiche für den API-Zugriff auf der Compute Engine-Hostinstanz:

• Cloud Platform: Aktiviert
• Compute Engine: Schreibgeschützt
• Stackdriver Monitoring API: Schreibgeschützt

Wenn Sie SAP-Anwendungen auf einer Compute-Instanz ausführen, die keine externe IP-Adresse hat, müssen Sie den privaten Google-Zugriff im Subnetz der Compute-Instanz aktivieren, damit der Google Cloud-Agent für SAP auf Google APIs und Dienste zugreifen kann. Informationen zum Aktivieren des privaten Google-Zugriffs in einem Subnetz finden Sie unter Privaten Google-Zugriff konfigurieren.

Agent installieren

Wir empfehlen, die neueste Version des Google Cloud-Agents für SAP zu installieren, die weitere Features unterstützt. Eine Anleitung finden Sie unter Google Cloud-Agent für SAP auf einer Compute Engine-Instanz installieren und konfigurieren.

Wenden Sie sich an Cloud Customer Care, um Version 1 des Google Cloud-Agents für SAP zu installieren.

Nachdem Sie den Google Cloud-Agent für SAP und den SAP-Host-Agent installiert haben, validieren Sie die Installation des Google Cloud-Agents für SAP wie unter Installation des Agents prüfen beschrieben.

Installation des Agents prüfen

Wählen Sie Ihr Betriebssystem aus und führen Sie die folgenden Schritte aus, um zu prüfen, ob der Agent ausgeführt wird:

Wenn der Agent nicht ausgeführt wird, starten Sie den Agent neu.

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

Google Cloud-Agent für SAP unter Linux konfigurieren

Nachdem Sie den Google Cloud-Agent für SAP installiert haben, können Sie den Agent optional so konfigurieren, dass die Erfassung von Prozessmonitoring-Messwerten und Arbeitslastmanager-Bewertungsmesswerten aktiviert ist. Standardmäßig ist nur die Erfassung von SAP-Host-Agent-Messwerten aktiviert.

Das Erfassen von Prozessmonitoring-Messwerte und Arbeitslastmanager-Bewertungsmesswerte wird nur unter Linux unterstützt.

Wenn Sie die Erfassung von Messwerten für das Prozessmonitoring und die Workload Manager-Bewertungsmesswerte aktivieren, muss das Dienstkonto der Compute-Instanz des Hosts die IAM-Rolle Monitoring-Messwert-Autor (roles/monitoring.metricWriter) enthalten.

Wenn Sie Secret Manager zum Speichern des SAP HANA-Datenbankpassworts verwenden, achten Sie darauf, dass das Dienstkonto der Host-Compute-Instanz die IAM-Rolle Zugriffsperson für Secret Manager-Secret (roles/secretmanager.secretAccessor) hat.

Die Zugriffsbereiche der Host-Compute-Instanz müssen Schreibzugriff haben, um Messwertdaten in Ihren Google Cloud-Projekten zu veröffentlichen. Wenn Sie eine neue Compute Engine-Recheninstanz erstellen, wird diese automatisch mit dem Schreibzugriffsbereich https://www.googleapis.com/auth/monitoring.write konfiguriert.

Erforderliche IAM-Rollen festlegen

So fügen Sie Ihrem Dienstkonto eine erforderliche Rolle hinzu:

1. Öffnen Sie in der Google Cloud Console die Seite IAM.

   IAM aufrufen

2. Wählen Sie Ihr Google Cloud-Projekt aus.

3. Bestimmen Sie das Dienstkonto, dem Sie eine Rolle hinzufügen möchten.

   • Wenn sich das Dienstkonto nicht schon in der Mitgliederliste befindet, sind ihm keine Rollen zugewiesen. Klicken Sie auf Hinzufügen und geben Sie die E-Mail-Adresse des Dienstkontos ein.
   • Wenn sich das Dienstkonto in der Liste der Hauptkonten befindet, sind ihm bereits Rollen zugewiesen. Klicken Sie für das Dienstkonto, das Sie bearbeiten möchten, auf die Schaltfläche Bearbeiten .

4. Wählen Sie die erforderliche Rolle in der Liste der verfügbaren Rollen aus:

   • Monitoring > Monitoring-Messwert-Autor
   • Secret Manager > Zugriffsperson für Secret Manager-Secret

5. Klicken Sie auf Hinzufügen oder Speichern, um dem Dienstkonto die Rollen zuzuweisen.

Prozessmonitoring-Messwerte und Arbeitslastmanager-Bewertungsmesswerte aktivieren

So aktivieren Sie die Prozessmonitoring-Messwerte und die Arbeitslastmanager-Bewertungsmesswerte:

1. Stellen Sie eine SSH-Verbindung zu Ihrer Compute-Instanz her.

2. Öffnen Sie die folgende Konfigurationsdatei:

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

3. Legen Sie im Abschnitt collection_configuration die folgenden Parameter auf true fest:

   • collect_process_metrics: Ermöglicht dem Agent, Prozessmonitoring-Messwerte zu erfassen. Für die Erfassung von SAP HANA-Datenbankmesswerten müssen Sie für den Datenbankzugriff und die Abfrage der SAP HANA-Datenbank zusätzliche Parameter im Abschnitt hana_metrics_config einrichten.
   • collect_workload_validation_metrics: Ermöglicht dem Agent, Arbeitslastmanager-Bewertungsmesswerte zu erfassen.

   Weitere Informationen zu den Parametern finden Sie in der folgenden Tabelle.

4. Optional können Sie unter cloud_properties die automatisch festgelegten Parameterwerte aktualisieren. Fügen Sie dazu den Abschnitt cloud_properties zur Konfigurationsdatei hinzu und geben Sie die erforderlichen Parameter und deren Werte an.

5. Speichern Sie die Konfigurationsdatei.

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

   sudo systemctl restart google-cloud-sap-agent

Konfigurationsparameter

In der folgenden Tabelle werden die Konfigurationsparameter von Version 1 des Google Cloud-Agents für SAP erläutert.

Standardkonfiguration

{
  "provide_sap_host_agent_metrics": true,
  "log_level": "INFO",
  "log_to_cloud": true,
  "collection_configuration": {
    "collect_workload_validation_metrics": false,
    "collect_process_metrics": false
  }
}

Konfigurationsbeispiel

Für die Installation des Agents auf einer Compute Engine-Instanz sind alle Konfigurationsparameter und -werte optional. Wenn die Konfigurationsdatei nicht geändert wird, wird die Standardkonfiguration verwendet. Das folgende Beispiel zeigt eine fertige Konfigurationsdatei zum Installieren des Agents auf einer Compute-Instanz.

{
  "provide_sap_host_agent_metrics": true,
  "bare_metal": false,
  "log_level": "INFO",
  "log_to_cloud": true,
  "collection_configuration": {
    "collect_workload_validation_metrics": false,
    "collect_process_metrics": true,
    "hana_metrics_config": {
      "hana_db_user": "user",
      "hana_db_password_secret_name": "secret-name"
      }
    }
}

Erfasste Messwerte anzeigen

Um die vom Agent erfassten Prozessmonitoring-Messwerte zu visualisieren, können Sie die folgenden benutzerdefinierten Dashboards verwenden, die Google Cloud bereitstellt:

• Agent für SAP-HANA Übersicht: Dieses Dashboard enthält Diagramme mit einer Statusübersicht für die folgenden Messwerte: SAP HANA-Verfügbarkeit, SAP HANA-HA-Verfügbarkeit, SAP HANA-HA-Replikation, SAP HANA-Dienststatus, HA-Cluster – Knotenstatus und HA-Cluster – Ressourcenstatus für SAP-Instanzen.

  Die JSON-Datei für dieses Dashboard ist sap-agent-status-overview.json.

• Agent für SAP-HANA-Rohdaten: Dieses Dashboard enthält Diagramme mit unverarbeiteten Daten für die folgenden Messwerte: SAP HANA-Verfügbarkeit, SAP HANA HA-Verfügbarkeit, SAP HANA HA-Replikation, SAP HANA-Dienststatus, HA-Cluster – Knotenstatus und HA-Cluster – Ressourcenstatus für SAP-Instanzen.

  Die JSON-Datei für dieses Dashboard ist sap-agent-raw-metrics.json.

Dashboards installieren

So installieren Sie ein benutzerdefiniertes Dashboard:

Installierte Dashboards aufrufen

So rufen Sie die installierten Dashboards auf:

1. Rufen Sie in der Google Cloud Console die Seite Monitoring auf:

   Zu Monitoring

2. Klicken Sie im Navigationsbereich von Monitoring auf Dashboards.

3. Klicken Sie in der Liste auf den Namen des Dashboards.

Wenn Sie viele Dashboards haben, können Sie nach benutzerdefinierten Dashboards oder nach dem Namen des neuen Dashboards filtern. Informationen zum Filtern dieser Liste finden Sie im Artikel Benutzerdefinierte Dashboards anzeigen.

Die folgende Abbildung zeigt ein Teil eines benutzerdefinierten Dashboards für SAP HANA-Messwerte in Monitoring.

Fehlerbehebung

Informationen zum Diagnostizieren und Beheben von Problemen, die beim Installieren und Konfigurieren des Google Cloud-Agent für SAP auftreten können, finden Sie in den Tipps zur Fehlerbehebung für den Google Cloud-Agent für SAP.

Support anfordern

Wenn Sie Hilfe bei der Behebung von Problemen mit dem Google Cloud-Agent für SAP benötigen, erfassen Sie alle verfügbaren Diagnoseinformationen und wenden Sie sich an Cloud Customer Care. Informationen zur Kontaktaufnahme mit Customer Care finden Sie unter Support für SAP in Google Cloud.