Google Cloud-Agent für SAP auf einem Bare-Metal-Lösungsserver installieren und konfigurieren

Der Google Cloud-Agent für SAP ist für die SAP-Unterstützung von SAP-Systemen erforderlich, die auf einem Bare-Metal-Lösungsserver ausgeführt werden.

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 zum Ausführen von SAP auf Bare Metal Solution-Servern verfügbar sind, finden Sie unter:

Informationen zu SAP HANA finden Sie unter Zertifizierte Betriebssysteme.
Informationen zu SAP NetWeaver finden Sie unter Zertifizierte Betriebssysteme.

Informationen zum Installieren und Konfigurieren der Version 3.2 (aktuell) des Google Cloud-Agents für SAP auf einer Compute Engine-VM-Instanz finden Sie unter Google Cloud-Agent für SAP auf einer Compute Engine-VM-Instanz installieren.

Installation

Sie installieren den Google Cloud-Agent für SAP mithilfe von Standardbefehlen zur Betriebssystempaketverwaltung: in RHEL mit dem Befehl yum, auf dem 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.

Agent installieren

So installieren Sie den Google Cloud-Agent für SAP auf einem Bare-Metal-Lösungsserver:

Stellen Sie eine SSH-Verbindung zu Ihrem Bare-Metal-Lösungsserver her.

Installieren Sie den Agent im Terminal mit dem Befehl, der für Ihr Betriebssystem spezifisch ist:

Empfohlen: So installieren Sie Version 3.2 (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)-\\$basearch
   enabled=1
   gpgcheck=1
   repo_gpgcheck=1
   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

SLES

sudo zypper addrepo --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

SLES 12

sudo zypper addrepo --refresh https://packages.cloud.google.com/yum/repos/google-cloud-sap-agent-sles12-\\$basearch 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)-\\$basearch
   enabled=1
   gpgcheck=1
   repo_gpgcheck=1
   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

SLES

sudo zypper addrepo --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-VERSION_NUMBER.x86_64

SLES 12

sudo zypper addrepo --refresh https://packages.cloud.google.com/yum/repos/google-cloud-sap-agent-sles12-\\$basearch 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.

Öffnen Sie die folgende Konfigurationsdatei:
```
/etc/google-cloud-sap-agent/configuration.json
```
Alternativ können Sie diese Konfiguration auch mit Befehlen ausführen. Weitere Informationen finden Sie unter Konfigurationsbefehle für den Google Cloud-Agent für SAP.
Ändern Sie die folgenden Parameter oder fügen Sie sie der Konfigurationsdatei hinzu:
- Im ersten Abschnitt gehen Sie so vor:
  - Setzen Sie bare_metal auf true.
- Fügen Sie den Abschnitt cloud_properties hinzu und geben Sie die folgenden Parameter an:
  - project_id: Geben Sie Ihr Google Cloud-Projekt an.
  - instance_name: Geben Sie den Namen Ihres Bare-Metal-Lösungsservers an.
  - region: geben Sie die Region Ihres Bare-Metal-Lösungsservers an
Speichern Sie die Konfigurationsdatei.

Starten Sie den Agent neu:

sudo systemctl restart google-cloud-sap-agent

Weitere Informationen zu den Konfigurationsparametern finden Sie unter Konfigurationsparameter und Beispielkonfiguration.

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

Stellen Sie eine SSH-Verbindung zu Ihrem Bare-Metal-Lösungsserver her.

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

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:

Geben Sie in Ihrem SAP-System Transaktion ST06 ein.
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.

Vorbereitung

Damit der Agent in einer Bare-Metal-Lösungsumgebung auf Google Cloud-Ressourcen zugreifen kann, müssen Sie die folgenden Voraussetzungen erfüllen:

Erstellen Sie ein IAM-Dienstkonto für den Agent, damit dieser auf die Google Cloud-Ressourcen zugreifen kann, und weisen Sie dem Dienstkonto dann die erforderlichen IAM-Rollen zu. Weitere Informationen finden Sie im Artikel Dienstkonto einrichten.
Installieren Sie auf Ihrem Bare-Metal-Lösungsserver die gcloud CLI. Weitere Informationen finden Sie im Artikel gcloud CLI installieren.
Autorisieren Sie die gcloud CLI für den Zugriff Google Cloud. Weitere Informationen finden Sie im Artikel gcloud CLI autorisieren.
Verbindung zu Google Cloud APIs herstellen. Weitere Informationen finden Sie im Artikel Privaten Google-Zugriff für lokale Hosts konfigurieren.

Dienstkonto einrichten

Damit der Agent über eine Bare-Metal-Lösungsumgebung auf Google Cloud-Ressourcen zugreifen kann, müssen Sie ein IAM-Dienstkonto einrichten.

Das vom Agent verwendete Dienstkonto muss mindestens die Rolle Autor von Arbeitslastmanager-Statistiken (roles/workloadmanager.insightWriter) enthalten.

So erstellen Sie ein Dienstkonto:

Erstellen Sie ein Dienstkonto:
1. Wechseln Sie in der Google Cloud Console zur Seite Dienstkonto erstellen.
  Zur Seite „Dienstkonto erstellen“
2. Wählen Sie Ihr Projekt aus.
3. Geben Sie im Feld Dienstkontoname einen Namen ein. Die Google Cloud Console füllt das Feld Dienstkonto-ID anhand dieses Namens aus.
  
  Geben Sie im Feld Dienstkontobeschreibung eine Beschreibung ein. Beispiel: Service account for quickstart.
4. Klicken Sie auf Erstellen und fortfahren.
5. Weisen Sie dem Dienstkonto die Rolle Workload Manager > Workload Manager Insights Writer zu.
  
  Wenn Sie die Rolle zuweisen möchten, suchen Sie die Liste Rolle auswählen und wählen Sie Workload Manager > Workload Manager Insights Writer aus.
  
  Hinweis: Das Feld Rolle hat Einfluss darauf, auf welche Ressourcen in Ihrem Projekt das Dienstkonto zugreifen kann. Sie können diese Rollen später widerrufen oder zusätzliche Rollen erteilen. In Produktionsumgebungen sollten Sie die Inhaber-, Bearbeiter- und Betrachterrolle nicht zuweisen. Gewähren Sie stattdessen eine vordefinierte Rolle oder eine benutzerdefinierte Rolle, die Ihren Anforderungen entspricht.
6. Klicken Sie auf Weiter.
7. Klicken Sie auf Fertig, um das Erstellen des Dienstkontos abzuschließen.
  
  Schließen Sie das Browserfenster nicht. Sie verwenden es in der nächsten Aufgabe.
Erstellen Sie einen Dienstkontoschlüssel:
1. Klicken Sie in der Google Cloud Console auf die E-Mail-Adresse des von Ihnen erstellten Dienstkontos.
2. Klicken Sie auf Schlüssel.
3. Klicken Sie auf Schlüssel hinzufügen und dann auf Neuen Schlüssel erstellen.
4. Klicken Sie auf Erstellen. Daraufhin wird eine JSON-Schlüsseldatei auf Ihren Computer heruntergeladen.
5. Klicken Sie auf Schließen.

Nachdem Sie das Dienstkonto erstellt haben, laden Sie die JSON-Schlüsseldatei an einen sicheren Speicherort auf dem Bare-Metal-Lösungsserver hoch, auf den der Agent zugreifen kann.

Features aktivieren

Nachdem Sie ein Dienstkonto für Ihre Bare-Metal-Lösung eingerichtet und ihm die erforderlichen Rollen zugewiesen haben, können Sie andere Features des Agents von Google Cloud für SAP aktivieren. Führen Sie dazu folgende Konfigurationen aus:

Standard-Konfigurationsdatei

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

{
  "provide_sap_host_agent_metrics": true,
  "bare_metal": true,
  "log_level": "INFO",
  "log_to_cloud": true,
  "collection_configuration": {
    "collect_workload_validation_metrics": true,
    "collect_process_metrics": false
  },
  "discovery_configuration": {
    "enable_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 Agents von Google für SAP beschrieben, die auf einem Bare-Metal-Lösungsserver ausgeführt werden. Dazu gehören auch die Parameter für die Erfassung von Messwerten. 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 des Servers für Bare-Metal-Lösung an, auf dem Sie den Agent installiert haben.
`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 von Prozessmesswerten 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 zu verwenden, empfehlen wir die Verwendung eines Secrets in Secret Manager durch Angabe des Secret-Namens in `hana_db_password_secret_name`. Geben Sie kein Passwort an, wenn Sie die Anmeldedaten für die Datenbanknutzer mit Secret Manager speichern. Wenn sowohl `hana_db_password` als auch `hana_db_password_secret_name` in der Konfiguration angegeben sind, wird ein Fehler ausgelöst und der Agent kann keine Verbindung zur Datenbank herstellen.
`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. SAP HANA-bezogene Messwerte werden nur erfasst, wenn entweder `hana_db_password_secret_name` oder `hana_db_password` festgelegt ist. Wichtig: Das Secret und die Host-VM-Instanz müssen im selben Google Cloud-Projekt vorhanden sein.
`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. Wir empfehlen, die Standarderfassungshäufigkeit nicht zu ändern, da sich dies auf das gesamte Feature selbst auswirken kann. 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.
`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.
`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. Zum Aktivieren der 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. Wenn Sie beide Parameter verwenden, wird der Parameter `password` verwendet.
`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.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.