Version 1: 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 von Version 1 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 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.

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 einem Server für Bare-Metal-Lösung 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

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

Die Arbeitslastmanager-Bewertungsmesswerte und die Erfassung von Prozessmonitoring-Messwerten werden nur unter Linux unterstützt.

Wenn Sie die die Erfassung von Arbeitslastmanager-Bewertungsmesswerten und Prozessmonitoring-Messwerten aktiviert haben, müssen Sie die folgenden Voraussetzungen erfüllen:

Erstellen Sie ein IAM-Dienstkonto für den Agent, um auf die Google Cloud-Ressourcen zuzugreifen. Weisen Sie dem Dienstkonto die erforderliche IAM-Rolle zu. Weitere Informationen finden Sie im Artikel Dienstkonto einrichten.
Installieren Sie auf dem 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 unter 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 Monitoring-Messwert-Autor (roles/monitoring.metricWriter) enthalten.

So erstellen Sie ein Dienstkonto:

Create a service account:
1. In the Google Cloud console, go to the Create service account page.
  Go to Create service account
2. Select your project.
3. In the Service account name field, enter a name. The Google Cloud console fills in the Service account ID field based on this name.
  
  In the Service account description field, enter a description. For example, Service account for quickstart.
4. Click Create and continue.
5. Grant the Monitoring > Monitoring Metric Writer role to the service account.
  
  To grant the role, find the Select a role list, then select Monitoring > Monitoring Metric Writer.
  
  Note: The Role field affects which resources the service account can access in your project. You can revoke these roles or grant additional roles later.
6. Click Continue.
7. Click Done to finish creating the service account.
  
  Do not close your browser window. You will use it in the next step.
Create a service account key:
1. In the Google Cloud console, click the email address for the service account that you created.
2. Click Keys.
3. Click Add key, and then click Create new key.
4. Click Create. A JSON key file is downloaded to your computer.
5. Click Close.

Laden Sie die JSON-Schlüsseldatei an einen sicheren Speicherort auf dem Bare-Metal-Lösungsserver hoch, auf den der Agent zugreifen kann.

Prozessmonitoring-Messwerte und Arbeitslastmanager-Bewertungsmesswerte aktivieren

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

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

Öffnen Sie die folgende Konfigurationsdatei:

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

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.
Speichern Sie die Konfigurationsdatei.
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.

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_id`	`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.
`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` Geben Sie die Erfassungshäufigkeit der Prozess-Monitoring-Messwerte in Sekunden an. Der Standardwert für diesen Parameter ist `5` Sekunden. Sie können die Erfassungshäufigkeit der Messwerte für die Prozessüberwachung zwar aktualisieren, es wird jedoch empfohlen, den Standardwert zu verwenden. Wenn Sie den Standardwert ändern müssen, fügen Sie den Parameter `process_metrics_frequency` im Abschnitt `collection_configuration` hinzu und geben Sie den erforderlichen Wert an.
`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: `hana_db_password_secret_name`, für das Sie ein in Secret Manager gespeichertes Secret angeben. `hdbuserstore_key`, für das Sie einen `hdbuserstore`-Schlüssel angeben.
`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. Wichtig: Das Secret und die Host-VM-Instanz müssen im selben Google Cloud-Projekt vorhanden sein. 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` Zum Authentifizieren des SAP HANA-Nutzers, den Sie für `hana_db_user` angeben, geben Sie einen `hdbuserstore`-Schlüssel an, den Sie für diesen Nutzer erstellt haben. Wenn Sie einen `hdbuserstore`-Schlüssel für die Authentifizierung verwenden möchten, müssen Sie die folgenden Bedingungen erfüllen: Die SAP-Tools `hdbsql` und `hdduserstore` 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.
`collection_configuration.hana_metrics_config.sid`	`String` Geben Sie die SID Ihrer SAP HANA-Instanz an.
`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_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` Zum Authentifizieren des SAP HANA-Nutzers, den Sie für `hana_db_user` angeben, geben Sie einen `hdbuserstore`-Schlüssel an, den Sie für diesen Nutzer erstellt haben. Wenn Sie einen `hdbuserstore`-Schlüssel für die Authentifizierung verwenden möchten, müssen Sie die folgenden Bedingungen erfüllen: Die SAP-Tools `hdbsql` und `hdduserstore` 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. 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.

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

Wenn Sie den Agent auf einem Bare-Metal-Lösungsserver installieren, müssen Sie die erforderlichen Attribute in die Konfigurationsdatei einfügen. Das folgende Beispiel zeigt eine fertige Konfigurationsdatei zum Installieren des Agents auf einem Bare-Metal-Lösungsserver.

{
  "provide_sap_host_agent_metrics": true,
  "bare_metal": true,
  "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"
    }
  },
  "cloud_properties": {
    "project_id": "my-project",
    "instance_id": "bms-machine-1",
    "image": "rhel-8",
    "region": "us-central1"
  }
}

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:

Google Cloud Console

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

Zu Monitoring
Klicken Sie im Navigationsbereich von Monitoring auf Dashboards.
Klicken Sie auf den Tab Beispielbibliothek.
Geben Sie im Feld Filter Agent for SAP ein, um die agent-spezifischen benutzerdefinierten Dashboards zu filtern.
(Optional) Klicken Sie auf Vorschau, um Details zu einem Dashboard oder eine Vorschau des Inhalts anzuzeigen.
Wählen Sie das Dashboard aus, das Sie installieren möchten.
Klicken Sie auf Importieren und dann auf Bestätigen.

Das Dashboard wird den verfügbaren Dashboards in Ihrem Google Cloud-Projekt hinzugefügt. Folgen Sie der Anleitung unter Installierte Dashboards aufrufen, um Ihr Dashboard anzeigen zu lassen.

Google Cloud CLI

Cloud Shell öffnen

Cloud Shell öffnen

Klonen Sie in Cloud Shell das Repository oder laden Sie es herunter:

git clone https://github.com/GoogleCloudPlatform/monitoring-dashboard-samples/

Installieren Sie in Cloud Shell das erforderliche Dashboard mithilfe der entsprechenden JSON-Datei:
```
gcloud monitoring dashboards create --config-from-file=CONFIG_FROM_FILE
```
Ersetzen Sie CONFIG_FROM_FILE durch den Pfad zur JSON-Datei, die die Dashboard-Konfiguration enthält. Dashboard-Konfigurationsdateien können sich unter dem Pfad monitoring-dashboard-samples/dashboards/google-cloud-agent-for-sap befinden.

Das Dashboard wird den verfügbaren Dashboards in Ihrem Google Cloud-Projekt hinzugefügt. Folgen Sie der Anleitung unter Installierte Dashboards aufrufen, um Ihr Dashboard anzeigen zu lassen.

Installierte Dashboards aufrufen

So rufen Sie die installierten Dashboards auf:

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

Zu Monitoring
Klicken Sie im Navigationsbereich von Monitoring auf Dashboards.
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.

Screenshot zeigt das benutzerdefinierte Dashboard 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 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.