Google Cloud-Agent für SAP auf einer Compute Engine-VM-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-VM-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 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 3.5 (aktuell) des Google Cloud-Agents für SAP auf einem Bare Metal Solution-Server finden Sie unter Google Cloud-Agent für SAP auf einem Bare Metal Solution-Server.

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 die neueste Version des Google Cloud-Agents 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 die neueste Version des Google Cloud-Agents 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 VM-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 Host-VM-Instanz:

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

Wenn Sie SAP-Anwendungen auf einer VM-Instanz ausführen, die keine externe IP-Adresse hat, müssen Sie den privaten Google-Zugriff im Subnetz der VM 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

Wählen Sie Ihr Betriebssystem aus und führen Sie die folgenden Schritte aus, um den Google Cloud-Agent für SAP auf Ihrer VM-Instanz zu installieren.

Linux

So installieren Sie den Agent auf einer VM-Instanz:

  1. Stellen Sie eine SSH-Verbindung zu Ihrer Host-VM her.
  2. Installieren Sie den Agent im Terminal mit dem Befehl, der für Ihr Betriebssystem spezifisch ist:
    • Empfohlen: So installieren Sie Version 3.5 (aktuell) des Agents:

      RHEL

      sudo tee /etc/yum.repos.d/google-cloud-sap-agent.repo << EOM
      [google-cloud-sap-agent]
      name=Google Cloud Agent for SAP
      baseurl=https://packages.cloud.google.com/yum/repos/google-cloud-sap-agent-el$(cat /etc/redhat-release | cut -d . -f 1 | tr -d -c 0-9)-x86_64
      enabled=1
      gpgcheck=1
      repo_gpgcheck=0
      gpgkey=https://packages.cloud.google.com/yum/doc/yum-key.gpg https://packages.cloud.google.com/yum/doc/rpm-package-key.gpg
      EOM
      sudo yum install google-cloud-sap-agent

      SLES15

      sudo zypper addrepo --refresh https://packages.cloud.google.com/yum/repos/google-cloud-sap-agent-sles15-x86_64 google-cloud-sap-agent
      sudo zypper install google-cloud-sap-agent

      SLES 12

      sudo zypper addrepo --refresh https://packages.cloud.google.com/yum/repos/google-cloud-sap-agent-sles12-x86_64 google-cloud-sap-agent
      sudo zypper install google-cloud-sap-agent
    • Um eine bestimmte Version des Agents zu installieren:

      RHEL

      sudo tee /etc/yum.repos.d/google-cloud-sap-agent.repo << EOM
      [google-cloud-sap-agent]
      name=Google Cloud Agent for SAP
      baseurl=https://packages.cloud.google.com/yum/repos/google-cloud-sap-agent-el$(cat /etc/redhat-release | cut -d . -f 1 | tr -d -c 0-9)-x86_64
      enabled=1
      gpgcheck=1
      repo_gpgcheck=0
      gpgkey=https://packages.cloud.google.com/yum/doc/yum-key.gpg https://packages.cloud.google.com/yum/doc/rpm-package-key.gpg
      EOM
      sudo yum install google-cloud-sap-agent-VERSION_NUMBER.x86_64

      SLES15

      sudo zypper addrepo --refresh https://packages.cloud.google.com/yum/repos/google-cloud-sap-agent-sles15-x86_64 google-cloud-sap-agent
      sudo zypper install google-cloud-sap-agent-VERSION_NUMBER.x86_64

      SLES 12

      sudo zypper addrepo --refresh https://packages.cloud.google.com/yum/repos/google-cloud-sap-agent-sles12-x86_64 google-cloud-sap-agent
      sudo zypper install google-cloud-sap-agent-VERSION_NUMBER.x86_64

      Ersetzen Sie VERSION_NUMBER durch die Versionsnummer des Agents, die Sie installieren möchten, z. B. 3.1-606637668. Informationen zu den Agent-Versionen, die Sie installieren können, finden Sie unter Alle verfügbaren Versionen des Agents auflisten.

      Informationen zum Downgrade des Agents auf eine bestimmte Version finden Sie unter Downgrade des Google Cloud-Agents für SAP ausführen

Windows

So installieren Sie den Agent auf einer VM-Instanz:

  1. Stellen Sie eine RDP-Verbindung zur VM-Instanz her.
  2. Als Administrator führen Sie den folgenden Befehl in PowerShell aus:
    googet addrepo google-cloud-sap-agent https://packages.cloud.google.com/yuck/repos/google-cloud-sap-agent-windows
    googet install google-cloud-sap-agent

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:

Linux

  1. Stellen Sie eine SSH-Verbindung zu Ihrer Host-VM 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
    

  3. Führen Sie bei SLES-Images die folgenden Befehle aus, um sicherzustellen, dass Sie die aktuelle Version des Agents von Google Cloud für SAP verwenden.

    sudo zypper remove google-cloud-sap-agent
    sudo zypper addrepo -p 98 --refresh https://packages.cloud.google.com/yum/repos/google-cloud-sap-agent-sles15-\$basearch google-cloud-sap-agent
    sudo zypper install google-cloud-sap-agent

Windows

  1. Stellen Sie eine RDP-Verbindung zur VM-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 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 optional weitere Features des Agents aktivieren. Führen Sie dazu folgende Konfigurationen aus. Standardmäßig ist die Erfassung von SAP-Host-Agent-Messwerten und Arbeitslastmanager-Bewertungsmesswerten aktiviert.

Die folgenden Funktionen werden nur unter Linux unterstützt. Sie werden unter Windows nicht unterstützt.

Standard-Konfigurationsdatei

Das folgende Snippet ist ein Beispiel für die Standardkonfiguration von Version 3.5 (aktuell) des Google Cloud-Agents für SAP:

{
  "provide_sap_host_agent_metrics": true,
  "bare_metal": false,
  "log_level": "INFO",
  "log_to_cloud": true,
  "collection_configuration": {
    "collect_workload_validation_metrics": true,
    "collect_process_metrics": false
  },
  "discovery_configuration": {
    "enable_discovery": true,
    "enable_workload_discovery": true
  },
  "hana_monitoring_configuration": {
    "enabled": false
  }
}

Informationen zu funktionsspezifischen Beispielkonfigurationsdateien finden Sie im Konfigurationsleitfaden für dieses Feature.

Konfigurationsparameter

In der folgenden Tabelle werden die Konfigurationsparameter des Google Cloud-Agents für SAP beschrieben, die auf einer Compute Engine-VM ausgeführt werden, einschließlich der Parameter, die sich auf die Erfassung von Messwerten beziehen. Informationen zu den Konfigurationsparametern, die sich auf das Backint-Feature des Agents beziehen, finden Sie unter Konfigurationsparameter.

Parameter
provide_sap_host_agent_metrics

Boolean

Geben Sie true an, um die Erfassung der vom SAP-Host-Agent erforderlichen Messwerte zu aktivieren. Der Standardwert ist true.
Legen Sie für provide_sap_host_agent_metrics nur false fest, es sei denn, Sie werden vom Cloud Customer Care- oder SAP-Support angeleitet.

bare_metal

Boolean

Wenn der Agent auf einem Bare-Metal-Lösungsserver installiert ist, geben Sie true an. Der Standardwert ist false.

log_level

String

Legen Sie den erforderlichen Wert fest, um die Logging-Ebene des Agents festzulegen. Folgende Logebenen sind verfügbar:

  • DEBUG
  • INFO
  • WARNING
  • ERROR

Standardwert ist INFO. Ändern Sie die Logging-Ebene nur, wenn Sie von Cloud Customer Care angewiesen werden.

log_to_cloud

Boolean

Geben Sie true an, um die Logs des Agents an Cloud Logging weiterzuleiten. Der Standardwert ist true.

cloud_properties.project_id

String

Wenn Ihr SAP-System auf einem Bare-Metal-Lösungsserver ausgeführt wird, geben Sie die Projekt-ID des Google Cloud-Projekts an, das Sie mit der Bare-Metal-Lösung verwenden.

Wenn der Agent auf einer VM-Instanz ausgeführt wird, erkennt der Agent die Projekt-ID standardmäßig automatisch.

cloud_properties.instance_name

String

Geben Sie den Namen Ihrer Compute Engine-VM-Instanz an. Der Agent erkennt dies bei der Installation automatisch.

cloud_properties.region

String

Wenn Ihr SAP-System auf einem Bare-Metal-Lösungsserver ausgeführt wird, geben Sie die Region des Bare-Metal-Lösungsservers an.

Wenn der Agent auf einer VM-Instanz ausgeführt wird, verwendet der Agent standardmäßig die Region der VM-Instanz, auf der der Agent installiert ist.

cloud_properties.zone

String

Wenn der Agent auf einer VM-Instanz ausgeführt wird, verwendet der Agent standardmäßig die Zone der VM-Instanz, auf der der Agent installiert ist.

cloud_properties.image

String

Geben Sie den Namen des Betriebssystem-Images der Instanz an.

Wenn der Agent auf einer VM-Instanz ausgeführt wird, erkennt der Agent standardmäßig das Betriebssystem-Image der VM-Instanz, auf der der Agent installiert ist.

cloud_properties.numeric_project_id

String

Die numerische ID des Google Cloud-Projekts, in dem das SAP-System ausgeführt wird.

Wenn der Agent auf einer VM-Instanz ausgeführt wird, erkennt der Agent die numerische Projekt-ID standardmäßig automatisch.

discovery_configuration.enable_workload_discovery

Boolean

Geben Sie true an, damit der Agent die Namen und Versionen der SAP-Produkte erfassen kann, die auf dem Host ausgeführt werden. Der Standardwert ist true.

Weitere Informationen finden Sie in der Codebasis des Agents im GitHub-Repository google-cloud-sap-agent unter GoogleCloudPlatform/sapagent.

discovery_configuration.enable_discovery

Boolean

Geben Sie true an, um die Informationen, die der Agent zu den auf dem Host ausgeführten SAP-Produkten erfasst, an Cloud Logging zu senden. Der Standardwert ist true.

Wenn Sie den Wert false angeben, speichert der Agent die erfassten Informationen auf dem Host und sendet sie nicht an Cloud Logging.

collection_configuration.collect_process_metrics

Boolean

Geben Sie true an, um die Erfassung von Prozessmonitoring-Messwerten zu aktivieren. Der Standardwert ist false.
Dieser Parameter gilt nur für Linux.

Wenn Sie die Erfassung der Prozessmesswerte für SAP HANA aktivieren, müssen Sie zusätzliche Parameter einrichten, die unter hana_metrics_config aufgeführt sind.

collection_configuration.process_metrics_frequency

Int

Ab Version 2.6 bestimmt dieser Parameter die Erfassungshäufigkeit der schnell wechselnden Prozessmonitoring-Messwerte in Sekunden. Schnell wechselnde Prozessmonitoring-Messwerte sind sap/hana/availability, sap/hana/ha/availability und sap/nw/availability.

Der Standardwert für diesen Parameter ist 5 Sekunden. Wir empfehlen, diesen Standardwert zu verwenden.

Alle anderen (langsam wechselnden) Prozessmonitoring-Messwerte werden mit einer Standardhäufigkeit von 30 Sekunden erfasst. Wenn Sie die Erfassungshäufigkeit der langsam wechselnden Prozessmonitoring-Messwerte ändern möchten, verwenden Sie den Parameter Attribut slow_process_metrics_frequency.

collection_configuration.slow_process_metrics_frequency

Int

Geben Sie die Erfassungshäufigkeit der langsam wechselnden Prozessmonitoring-Messwerte in Sekunden an.

Der Standardwert für diesen Parameter ist 30 Sekunden.

collection_configuration.process_metrics_to_skip

Array

Geben Sie die Prozessmonitoring-Messwerte an, die der Agent nicht erfassen soll. Dieser Parameter akzeptiert einen durch Kommas getrennten Wert von Prozessmonitoring-Messwertnamen. Beispiel: "process_metrics_to_skip": ["/sap/nw/abap/sessions", "/sap/nw/abap/rfc"].

collection_configuration.hana_metrics_config.hana_db_user

String

Geben Sie das Datenbanknutzerkonto an, das der Agent zum Abfragen von SAP HANA verwendet. Standardwert ist SYSTEM.

collection_configuration.hana_metrics_config.hana_db_password

String

Geben Sie das Nur-Text-Passwort für das Datenbank-Nutzerkonto an, das der Agent zum Abfragen von SAP HANA verwendet.

Anstatt ein Nur-Text-Passwort anzugeben, empfehlen wir eine der folgenden Optionen:

collection_configuration.hana_metrics_config.hana_db_password_secret_name

String

Um das Passwort für das Datenbank-Nutzerkonto, das der Agent zum Abfragen von SAP HANA verwendet, sicher bereitzustellen, geben Sie den Namen des Secrets an, das die Sicherheitsanmeldedaten für das Datenbanknutzerkonto enthält.

Der Agent erfasst die SAP HANA-bezogenen Messwerte nur, wenn Sie entweder hana_db_password_secret_name, hdbuserstore_key oder hana_db_password angeben.

collection_configuration.hana_metrics_config.hdbuserstore_key

String

Wenn Sie eine sichere Verbindung zu einem SAP HANA-System herstellen möchten, geben Sie den Schlüssel Secure Nutzerspeicher (hdbuserstore) an, den Sie für dieses System erstellt haben.

Prüfen Sie Folgendes, um einen hdbuserstore-Schlüssel für die Authentifizierung zu verwenden:

  • Die SAP-Tools hdbsql und hdbuserstore sind auf der Compute-Instanz installiert, die den Agent hostet.
  • Der Schlüssel hdbuserstore entspricht einer bestimmten SAP HANA-Instanz. Sie können keine Schlüssel verwenden, die Hostnamen mehrerer SAP HANA-Instanzen enthalten.
  • Der SIDadm-Nutzer kann die SAP HANA-Datenbank mit diesem Schlüssel abfragen. Hier bezieht sich SID auf den Wert, den Sie für den Parameter sid angegeben haben. Dies können Sie verifizieren, indem Sie den folgenden Befehl als SIDadm-Nutzer ausführen:
    hdbsql -U HDB_USERSTORE_KEY "SELECT * FROM DUMMY"

Dieser Konfigurationsparameter wird ab Version 3.3 des Agents unterstützt.

collection_configuration.hana_metrics_config.sid

String

Geben Sie die SID Ihrer SAP HANA-Instanz an. Informationen zur Verwendung eines HANA-Userstore-Schlüssels finden Sie im Abschnitt hdbuserstore_key.

collection_configuration.collect_workload_validation_metrics

Boolean

Geben Sie true an, um die Erfassung von Arbeitslastmanager-Bewertungsmesswerten zu aktivieren. Ab Version 3.2 ist der Standardwert true.
Dieser Parameter gilt nur für Linux.

collection_configuration.workload_validation_metrics_frequency

Int

Die Erfassungshäufigkeit der Arbeitslastmanager-Bewertungsmesswerte in Sekunden. Der Standardwert beträgt 300 Sekunden.

Wenn Sie die Erfassungshäufigkeit der Arbeitslastmanager-Messwerte ändern müssen, fügen Sie den Parameter workload_validation_metrics_frequency im Abschnitt collection_configuration hinzu und geben Sie den erforderlichen Wert an.

collection_configuration.workload_validation_collection_definition.fetch_latest_config

Boolean

Optional. Der Standardwert ist true. Dadurch kann der Agent die neuesten Arbeitslastmanager-Bewertungsmesswerte erfassen, ohne dass Sie den Agent aktualisieren müssen. Wenn Sie dieses Verhalten deaktivieren möchten, geben Sie diesen Parameter in Ihrer Konfigurationsdatei an und legen Sie als Wert false fest.

collection_configuration.workload_validation_db_metrics_config.hana_db_user

String

Geben Sie das Nutzerkonto an, das zum Abfragen der SAP HANA-Instanz verwendet wird. Das Nutzerkonto muss die Leseberechtigung für die SAP HANA-Datenbank haben.

collection_configuration.workload_validation_db_metrics_config.hana_db_password_secret_name

String

Geben Sie den Namen des Secrets im Secret Manager an, in dem das Passwort des Nutzerkontos gespeichert ist.

Alternativ können Sie den Konfigurationsparameter hdbuserstore_key angeben, um den angegebenen SAP HANA-Nutzer zu authentifizieren.

collection_configuration.workload_validation_db_metrics_config.hdbuserstore_key

String

Wenn Sie eine sichere Verbindung zu einem SAP HANA-System herstellen möchten, geben Sie den Schlüssel Secure Nutzerspeicher (hdbuserstore) an, den Sie für dieses System erstellt haben.

Prüfen Sie Folgendes, um einen hdbuserstore-Schlüssel für die Authentifizierung zu verwenden:

  • Die SAP-Tools hdbsql und hdbuserstore sind auf der Compute-Instanz installiert, die den Agent hostet.
  • Der Schlüssel hdbuserstore entspricht einer bestimmten SAP HANA-Instanz. Sie können keine Schlüssel verwenden, die Hostnamen mehrerer SAP HANA-Instanzen enthalten.
  • Der SIDadm-Nutzer kann die SAP HANA-Datenbank mit diesem Schlüssel abfragen. Hier bezieht sich SID auf den Wert, den Sie für den Parameter sid angegeben haben. Dies können Sie verifizieren, indem Sie den folgenden Befehl als SIDadm-Nutzer ausführen:
    hdbsql -U HDB_USERSTORE_KEY "SELECT * FROM DUMMY"

Dieser Konfigurationsparameter wird ab Version 3.3 des Agents unterstützt.

Wenn Sie hdbuserstore_key angeben, können Sie die Angabe der Parameter hostname und port überspringen.

collection_configuration.workload_validation_db_metrics_config.sid

String

Geben Sie die SID Ihrer SAP HANA-Instanz an.

collection_configuration.workload_validation_db_metrics_config.hostname

String

Geben Sie die Kennzeichnung der Maschine an, entweder lokal oder remote, die Ihre SAP HANA-Instanz hostet. Folgende Werte werden unterstützt:

  • Wenn der Host ein lokaler Computer ist, geben Sie den String localhost oder die localhost-Loopback-IP-Adresse wie 127.0.0.1 ein.
  • Wenn der Host ein Remote-Computer ist, geben Sie seine interne oder externe IP-Adresse an.
collection_configuration.workload_validation_db_metrics_config.port

String

Geben Sie den Port an, über den die SAP HANA-Instanz Abfragen akzeptiert. Bei der ersten oder einzigen Mandantendatenbankinstanz ist der Port 3NN15, wobei NN die Instanznummer der SAP HANA-Instanz ist.

collection_configuration.workload_validation_db_metrics_frequency

Int

Die Erfassungshäufigkeit der SAP HANA-Datenbankmesswerte in Sekunden für die Arbeitslastmanager-Bewertung. Die Standardeinstellung beträgt 3600 Sekunden.

Sie können zwar die Erfassungshäufigkeit der SAP HANA-Datenbankmesswerte aktualisieren, wir empfehlen jedoch, den Standardwert zu verwenden. Wenn Sie den Standardwert ändern müssen, fügen Sie den Parameter workload_validation_db_metrics_frequency im Abschnitt collection_configuration hinzu und geben Sie den erforderlichen Wert an. Achten Sie darauf, dass Sie die Erfassungshäufigkeit auf maximal 3600 Sekunden festlegen.

hana_monitoring_configuration.enabled

Boolean

Optional. Geben Sie true an, um den Google Cloud-Agent für SAP zum Erfassen der SAP HANA-Monitoring-Messwerte zu aktivieren. Der Standardwert ist false.

Die folgenden untergeordneten Parameter gelten nur, wenn Sie hana_monitoring_configuration.enabled: true angeben.
hana_monitoring_configuration.sample_interval_sec

Int

Optional. Geben Sie das Abtastintervall in Sekunden an, das die Häufigkeit bestimmt, mit der der Google Cloud-Agent für SAP Ihre SAP HANA-Instanzen abfragt, um die SAP HANA-Monitoring-Messwerte zu erfassen. Der Standardwert beträgt 300 Sekunden.

Für jede in der Konfigurationsdatei des Google Cloud-Agents für SAP definierte Abfrage können Sie das globale Abtastintervall überschreiben. Geben Sie dazu das erforderliche Intervall für den Parameter sample_interval_sec an. Abtastintervalle müssen 5 Sekunden oder länger sein.

hana_monitoring_configuration.query_timeout_sec

Int

Optional. Geben Sie das Zeitlimit für jede Abfrage an die SAP HANA-Instanzen an. Der Standardwert beträgt 300 Sekunden.

hana_monitoring_configuration.execution_threads

Int

Optional. Geben Sie die Anzahl der Threads an, die zum Senden von Abfragen an die SAP HANA-Instanzen verwendet werden. Jede Abfrage wird in einem eigenen Thread ausgeführt. Der Standardwert ist 10.

hana_monitoring_configuration.hana_instances.name

String

Geben Sie die Namenskennzeichnung für Ihre SAP HANA-Instanz an.

hana_monitoring_configuration.hana_instances.sid

String

Geben Sie die SID Ihrer SAP HANA-Instanz an. Dieser String wird allen Messwerten, die sich aus der Abfrage Ihrer SAP HANA-Instanzen ergeben, als Label hinzugefügt.

hana_monitoring_configuration.hana_instances.host

String

Geben Sie die Kennzeichnung der Maschine an, entweder lokal oder remote, die Ihre SAP HANA-Instanz hostet. Folgende Werte werden unterstützt:

  • Wenn der Host ein lokaler Computer ist, geben Sie den String localhost oder die localhost-Loopback-IP-Adresse wie 127.0.0.1 ein.
  • Wenn der Host ein Remote-Computer ist, geben Sie seine interne oder externe IP-Adresse an.
hana_monitoring_configuration.hana_instances.port

String

Geben Sie den Port an, über den die SAP HANA-Instanz Abfragen akzeptiert. Bei der ersten oder einzigen Mandantendatenbankinstanz ist der Port 3NN15, wobei NN die Instanznummer der SAP HANA-Instanz ist.

hana_monitoring_configuration.hana_instances.user

String

Geben Sie das Nutzerkonto an, das zum Abfragen der SAP HANA-Instanz verwendet wird.

Achten Sie darauf, dass dieser Nutzer die Berechtigung zum Lesen der Monitoring-Ansichten in Ihrer SAP HANA-Datenbank hat. Wenn dieses Berechtigung nicht gewährt wird, enthalten die SAP HANA-Monitoring-Messwerte, die sich auf die Monitoring-Ansichten beziehen, keine Daten.

hana_monitoring_configuration.hana_instances.password

String

Optional. Geben Sie das Passwort (als Nur-Text) an, mit dem das Nutzerkonto für die Abfrage der SAP HANA-Instanz authentifiziert wird.

Für die Authentifizierung müssen Sie eine der folgenden Optionen angeben:

  • Das Klartextpasswort für den Parameter password.
  • (Empfohlen) Wenn Sie das Passwort mit Secret Manager als Secret speichern, müssen Sie den entsprechenden Secret-Namen im Parameter secret_name angeben.
  • (Empfohlen) Einen hdbuserstore-Schlüssel für den Parameter hdbuserstore_key.
hana_monitoring_configuration.hana_instances.secret_name

String

Optional. Geben Sie den Namen des Secrets im Secret Manager an, in dem das Passwort des Nutzerkontos gespeichert ist.

hana_monitoring_configuration.hana_instances.hdbuserstore_key

String

Wenn Sie eine sichere Verbindung zu einem SAP HANA-System herstellen möchten, geben Sie den Schlüssel Secure Nutzerspeicher (hdbuserstore) an, den Sie für dieses System erstellt haben.

Prüfen Sie Folgendes, um einen hdbuserstore-Schlüssel für die Authentifizierung zu verwenden:

  • Die SAP-Tools hdbsql und hdbuserstore sind auf der Compute-Instanz installiert, die den Agent hostet.
  • Der Schlüssel hdbuserstore entspricht einer bestimmten SAP HANA-Instanz. Sie können keine Schlüssel verwenden, die Hostnamen mehrerer SAP HANA-Instanzen enthalten.
  • Der SIDadm-Nutzer kann die SAP HANA-Datenbank mit diesem Schlüssel abfragen. Hier bezieht sich SID auf den Wert, den Sie für den Parameter sid angegeben haben. Dies können Sie verifizieren, indem Sie den folgenden Befehl als SIDadm-Nutzer ausführen:
    hdbsql -U HDB_USERSTORE_KEY "SELECT * FROM DUMMY"

Dieser Konfigurationsparameter wird ab Version 3.3 des Agents unterstützt.

Wenn Sie hdbuserstore_key angeben, können Sie die Angabe der Parameter host und port überspringen.

hana_monitoring_configuration.hana_instances.enable_ssl

Boolean

Optional. Gibt an, ob SSL in Ihrer SAP HANA-Instanz aktiviert ist. Der Standardwert ist false.

hana_monitoring_configuration.hana_instances.host_name_in_certificate

String

Wenn Sie für eine SAP HANA-Instanz enable_ssl: true angeben, müssen Sie den Hostnamen angeben, der im SSL-Zertifikat festgelegt ist.

hana_monitoring_configuration.hana_instances.tls_root_ca_file

String

Wenn Sie für eine SAP HANA-Instanz enable_ssl: true angeben, müssen Sie den Pfad für Ihr Sicherheitszertifikat angeben.

hana_monitoring_configuration.queries.enabled

Boolean

Optional. Um eine SQL-Abfrage für alle Ihre SAP HANA-Instanzen zu aktivieren, geben Sie den Wert true für das Attribut enabled für diese SQL-Abfrage an.

hana_monitoring_configuration.queries.name

String

Wenn Sie in Ihrer Konfigurationsdatei benutzerdefinierte Abfragen definiert haben, müssen Sie für jede benutzerdefinierte Abfrage einen eindeutigen Namen angeben.

Der Abfragename muss eindeutig sein, da er zum Erstellen der Standard-URL des Messwerts in Monitoring verwendet wird.

hana_monitoring_configuration.queries.sql

String

Geben Sie die SQL-Anweisung an, die der Agent an Ihre SAP HANA-Instanzen ausgibt.

Die SQL-Anweisung muss der von SAP definierten SQL- und Systemansichten-Referenz zur SAP-Syntax entsprechen.
hana_monitoring_configuration.queries.sample_interval_sec

Int

Optional. Geben Sie das Abtastintervall für die SQL-Abfrage an. Dadurch wird das globale Abtastintervall überschrieben. Der Wert muss mindestens 5 Sekunden lang sein.

hana_monitoring_configuration.queries.columns.name

String

Geben Sie einen Namen an, der jede Spalte eindeutig identifiziert.

Der Spaltenname muss eindeutig sein, da er zum Erstellen der Standard-URL des Messwerts in Monitoring verwendet wird.

hana_monitoring_configuration.queries.columns.metric_type

String

Geben Sie für die Verarbeitung durch Monitoring einen der folgenden Messwerttypen an: METRIC_LABEL, METRIC_GAUGE oder METRIC_CUMULATIVE.

Messwerte vom Typ METRIC_LABEL werden als Labels an alle Messwerte METRIC_GAUGE und METRIC_CUMULATIVE angehängt, die an Monitoring gesendet werden.

hana_monitoring_configuration.queries.columns.value_type

String

Geben Sie für die Verarbeitung durch Monitoring einen Datentyp an, der vom Messwerttyp unterstützt wird.

Folgende Datentypen werden unterstützt: VALUE_BOOL, VALUE_INT64, VALUE_STRING oder VALUE_DOUBLE. Weitere Informationen finden Sie unter Unterstützte Kombination.

hana_monitoring_configuration.queries.columns.name_override

String

Optional. Geben Sie für die Verarbeitung durch Monitoring den Pfad an, der in der Messwert-URL anstelle der Abfrage- und Spaltennamen angezeigt werden soll. Beispiel:

  • Standard-URL des Messwerts: workload.googleapis.com/sap/hanamonitoring/QUERY_NAME/COLUMN_NAME
  • Messwert-URL mit benutzerdefiniertem Pfad: workload.googleapis.com/sap/hanamonitoring/CUSTOM_PATH

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 kontaktieren

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.