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 2 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 Namengoogle-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 2 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
- Cloud-Anbieter:
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 er Prozess-Monitoring-Messwerte, Arbeitslastmanager-Bewertungsmesswerte und SAP HANA-Monitoring-Messwerte erfasst. Standardmäßig ist nur die Erfassung von SAP-Host-Agent-Messwerten aktiviert.
Vorbereitung
Wenn Sie diese Features für die Agent-Instanz aktivieren möchten, die auf Ihrem Bare-Metal-Lösungsserver ausgeführt wird, müssen Sie folgende 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 Monitoring-Messwert-Autor (roles/monitoring.metricWriter
) enthalten.
So erstellen Sie ein Dienstkonto:
-
Create a service account:
-
In the Google Cloud console, go to the Create service account page.
Go to Create service account - Select your project.
-
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
. - Click Create and continue.
-
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.
- Click Continue.
-
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:
- In the Google Cloud console, click the email address for the service account that you created.
- Click Keys.
- Click Add key, and then click Create new key.
- Click Create. A JSON key file is downloaded to your computer.
- Click Close.
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:
- Erfassung von Prozessmonitoring-Messwerten konfigurieren
- Erfassung von Arbeitslastmanager-Bewertungsmesswerten konfigurieren
- Erfassung von SAP HANA-Monitoring-Messwerten konfigurieren
Standard-Konfigurationsdatei
Das folgende Snippet ist ein Beispiel für die Standardkonfiguration von Version 2 des Google Cloud-Agents für SAP:
{ "provide_sap_host_agent_metrics": true, "bare_metal": , "log_level": "INFO", "log_to_cloud": true, "collection_configuration": { "collect_workload_validation_metrics": false, "collect_process_metrics": false, "sap_system_discovery": true }, "hana_monitoring_configuration": { "enabled": false } }
Konfigurationsparameter
In der folgenden Tabelle werden die Konfigurationsparameter von Version 2 des Google Cloud-Agents für SAP erläutert.
Parameter | |
---|---|
provide_sap_host_agent_metrics |
Geben Sie |
bare_metal |
Wenn der Agent auf einem Bare-Metal-Lösungsserver installiert ist, geben Sie |
log_level |
Legen Sie den erforderlichen Wert fest, um die Logging-Ebene des Agents festzulegen. Folgende Logebenen sind verfügbar:
Standardwert ist |
log_to_cloud |
Geben Sie |
sap_system_discovery |
Geben Sie |
cloud_properties.project_id |
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. |
cloud_properties.instance_name
|
Geben Sie den Namen des Servers für Bare-Metal-Lösung an, auf dem Sie den Agent installiert haben. Geben Sie in Agent-Version 2.5 oder früher den Servernamen der Bare-Metal-Lösung für das Attribut |
cloud_properties.region |
Wenn Ihr SAP-System auf einem Bare-Metal-Lösungsserver ausgeführt wird, geben Sie die Region des Bare-Metal-Lösungsservers an. |
cloud_properties.zone |
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 |
Geben Sie den Namen des Betriebssystem-Images der Instanz an. |
cloud_properties.numeric_project_id |
Die numerische ID des Google Cloud-Projekts, in dem das SAP-System ausgeführt wird. |
collection_configuration.collect_process_metrics |
Geben Sie |
collection_configuration.process_metrics_frequency |
Ab Version 2.6 bestimmt dieser Parameter die Erfassungshäufigkeit der schnell wechselnden Prozessmonitoring-Messwerte in Sekunden. Schnell wechselnde Prozessmonitoring-Messwerte sind Der Standardwert für diesen Parameter ist 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 |
collection_configuration.slow_process_metrics_frequency |
Geben Sie die Erfassungshäufigkeit der langsam wechselnden Prozessmonitoring-Messwerte in Sekunden an. Der Standardwert für diesen Parameter ist |
collection_configuration.process_metrics_to_skip |
Geben Sie die Prozessmonitoring-Messwerte an, die der Agent nicht erfassen soll. Dieser Parameter akzeptiert einen durch Kommas getrennten Wert von Prozessmonitoring-Messwertnamen. Beispiel:
|
collection_configuration.hana_metrics_config.hana_db_user |
Geben Sie das Datenbanknutzerkonto an, das der Agent zum Abfragen von SAP HANA verwendet. Standardwert ist |
collection_configuration.hana_metrics_config.hana_db_password |
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 |
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 |
collection_configuration.hana_metrics_config.sid |
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 |
Geben Sie |
collection_configuration.workload_validation_metrics_frequency |
Die Erfassungshäufigkeit der Arbeitslastmanager-Bewertungsmesswerte in Sekunden. Der Standardwert beträgt Wenn Sie die Erfassungshäufigkeit der Arbeitslastmanager-Messwerte ändern müssen, fügen Sie den Parameter |
collection_configuration.workload_validation_db_metrics_config.hana_db_user |
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 |
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.sid |
Geben Sie die SID Ihrer SAP HANA-Instanz an. |
collection_configuration.workload_validation_db_metrics_config.hostname |
Geben Sie die Kennzeichnung der Maschine an, entweder lokal oder remote, die Ihre SAP HANA-Instanz hostet. Folgende Werte werden unterstützt:
|
collection_configuration.workload_validation_db_metrics_config.port |
Geben Sie den Port an, über den die SAP HANA-Instanz Abfragen akzeptiert. Bei der ersten oder einzigen Mandantendatenbankinstanz ist der Port |
collection_configuration.workload_validation_db_metrics_frequency |
Die Erfassungshäufigkeit der SAP HANA-Datenbankmesswerte in Sekunden für die Arbeitslastmanager-Bewertung.
Die Standardeinstellung beträgt |
hana_monitoring_configuration.enabled |
Optional. Geben Sie hana_monitoring_configuration.enabled: true angeben.
|
hana_monitoring_configuration.sample_interval_sec |
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 |
hana_monitoring_configuration.query_timeout_sec |
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 |
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 |
Geben Sie die Namenskennzeichnung für Ihre SAP HANA-Instanz an. |
hana_monitoring_configuration.hana_instances.sid |
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 |
Geben Sie die Kennzeichnung der Maschine an, entweder lokal oder remote, die Ihre SAP HANA-Instanz hostet. Folgende Werte werden unterstützt:
|
hana_monitoring_configuration.hana_instances.port |
Geben Sie den Port an, über den die SAP HANA-Instanz Abfragen akzeptiert. Bei der ersten oder einzigen Mandantendatenbankinstanz ist der Port |
hana_monitoring_configuration.hana_instances.user |
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 |
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:
|
hana_monitoring_configuration.hana_instances.secret_name |
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 |
Optional. Gibt an, ob SSL in Ihrer SAP HANA-Instanz aktiviert ist. Der Standardwert ist |
hana_monitoring_configuration.hana_instances.host_name_in_certificate |
Wenn Sie für eine SAP HANA-Instanz |
hana_monitoring_configuration.hana_instances.tls_root_ca_file |
Wenn Sie für eine SAP HANA-Instanz |
hana_monitoring_configuration.queries.enabled |
Optional. Um eine SQL-Abfrage für alle Ihre SAP HANA-Instanzen zu aktivieren, geben Sie den Wert |
hana_monitoring_configuration.queries.name |
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 |
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 |
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 |
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 |
Geben Sie für die Verarbeitung durch Monitoring einen der folgenden Messwerttypen an: Messwerte vom Typ |
hana_monitoring_configuration.queries.columns.value_type |
Geben Sie für die Verarbeitung durch Monitoring einen Datentyp an, der vom Messwerttyp unterstützt wird. Folgende Datentypen werden unterstützt: |
hana_monitoring_configuration.queries.columns.name_override |
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:
|
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.