In diesem Leitfaden erfahren Sie, wie Sie den Agent für SAP von Google Cloudkonfigurieren, um die Bewertungsmesswerte des Arbeitslastmanagers aus Ihren SAP-Systemen zu erfassen.
Informationen zu diesem Feature finden Sie unter Arbeitslastmanager-Bewertung mit dem Agent für SAP von Google Cloud.
Hinweis
- Prüfen Sie die Installation des Google Cloud-Agents für SAP. Eine Anleitung finden Sie in der Installationsanleitung für Ihr Szenario.
- Wenn Sie den Agent auf einem Bare-Metal-Lösungsserver installiert haben, prüfen Sie, ob Sie die erforderlichen Voraussetzungen erfüllt und ein Dienstkonto eingerichtet haben. Eine Anleitung finden Sie unter Google Cloud-Agent für SAP unter Linux konfigurieren.
Achten Sie darauf, dass die Workload Manager API für Ihr Google Cloud-Projekt aktiviert ist.
IAM-Rollen festlegen
Damit der Agent für SAP von Google Clouddie Arbeitslastmanager-Bewertungsmesswerte erfassen kann, muss das von Ihrer Compute Engine-Instanz oder dem Bare-Metal-Lösungsserver verwendete Dienstkonto folgende Rollen haben:
- Compute-Betrachter (
roles/compute.viewer
) - Workload Manager Insights Writer (
roles/workloadmanager.insightWriter
) - Zugriffsperson für Secret Manager-Secret (
roles/secretmanager.secretAccessor
), wenn Sie Secret Manager zum Speichern des SAP HANA-Datenbankpassworts nutzen.
So fügen Sie Ihrem Dienstkonto die erforderlichen Rollen hinzu:
Öffnen Sie in der Google Cloud Console die Seite IAM.
Wählen Sie Ihr Google Cloud-Projekt aus.
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 .
Wählen Sie die erforderliche Rolle in der Liste der verfügbaren Rollen aus:
- Compute-Betrachter
- Arbeitslastmanager > Autor von Arbeitslastmanager-Statistiken
- Secret Manager > Zugriffsperson für Secret Manager-Secret
Klicken Sie auf Hinzufügen oder Speichern, um dem Dienstkonto die Rollen zuzuweisen.
Für eine detaillierte Zugriffsebene können Sie Ihrer benutzerdefinierten Rolle die folgenden IAM-Berechtigungen zuweisen:
- Messwerterfassung:
monitoring.timeSeries.create
compute.zoneOperations.list
compute.disks.list
compute.nodeGroups.get
workloadmanager.insights.write
- Secret Manager:
secretmanager.versions.access
Weitere Informationen zum Erstellen einer benutzerdefinierten Rolle finden Sie unter Benutzerdefinierte Rollen erstellen und verwalten.
Agent-Version überprüfen
Google Cloud empfiehlt, dass Sie die neueste Version von Agent für SAP installieren, um Ihre SAP-Arbeitslasten genau zu bewerten, da durch regelmäßige Releases des Agents für SAP Messwerte hinzugefügt oder geändert werden können, die für die Bewertung verwendet werden.
Um sicherzustellen, dass Sie die neueste Version des Agents von Google Cloudfür SAP verwenden, müssen Sie regelmäßig nach Updates suchen und den Agent aktualisieren.
Update installieren
Wählen Sie Ihr Betriebssystem aus und folgen Sie dann den Schritten:
RHEL
- Stellen Sie eine SSH-Verbindung zu Ihrer Instanz her.
- Aktualisieren Sie die Agent-Instanz:
- (Empfohlen) So aktualisieren Sie den Agent auf Version 3.6 (aktuell):
sudo yum --nogpgcheck update google-cloud-sap-agent
- So aktualisieren Sie auf eine bestimmte Version des Agents:
sudo yum 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.
- (Empfohlen) So aktualisieren Sie den Agent auf Version 3.6 (aktuell):
SLES
- Stellen Sie eine SSH-Verbindung zu Ihrer Instanz her.
- Aktualisieren Sie die Agent-Instanz:
- (Empfohlen) So aktualisieren Sie den Agent auf Version 3.6 (aktuell):
sudo zypper --no-gpg-checks update google-cloud-sap-agent
- So aktualisieren Sie auf eine bestimmte Version des Agents:
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.
- (Empfohlen) So aktualisieren Sie den Agent auf Version 3.6 (aktuell):
Erfassung von Arbeitslastmanager-Bewertungsmesswerten aktivieren
Ab Version 3.2 sind neue Installationen des Google Cloud-Agents für SAP standardmäßig aktiviert, um die Bewertungsmesswerte von Workload Manager zu erfassen. Wenn Sie von einer vorherigen Version auf Version 3.2 aktualisieren, können Sie die Funktion auch explizit aktivieren. Führen Sie dazu folgende Schritte aus:
Stellen Sie eine SSH-Verbindung zu Ihrer Compute Engine-Instanz oder Ihrem Bare-Metal-Lösungsserver her.
So kann der Agent die Bewertungsmesswerte für Arbeitslastmanager erfassen:
sudo /usr/bin/google_cloud_sap_agent configure -feature=workload_evaluation -enable
So aktivieren Sie die Erfassung der Messwerte "SAP HANA Insights" und "Best Practices für die Sicherheit von SAP HANA":
Öffnen Sie die Konfigurationsdatei des Agents.
/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 Agent für SAP von Google Cloud.
Fügen Sie den Abschnitt
workload_validation_db_metrics_config
nachcollect_workload_validation_metrics
hinzu und geben Sie dann die folgenden Parameter an:hana_db_user
: Geben Sie das Nutzerkonto der SAP HANA-Datenbank an, das zum Abfragen der SAP HANA-Instanz verwendet wird.hostname
: Geben Sie die Kennzeichnung der Maschine an, entweder lokal oder remote, die Ihre SAP HANA-Instanz hostet.port
: Geben Sie den Datenbankport an, über den die SAP HANA-Instanz Abfragen akzeptiert. Geben Sie beispielsweise30015
ein, wenn Ihre Mieterdatenbank auf Port30015
wartet.sid
: Gibt die SID Ihrer SAP HANA-Instanz an.hana_db_password_secret_name
: Gibt den Namen des Secrets im Secret Manager an, in dem das Passwort des Nutzerkontos gespeichert ist.Als Alternative zum Secret können Sie den Konfigurationsparameter
hdbuserstore_key
verwenden.hdbuserstore_key
: Gibt den Schlüsselhdbuserstore
an, mit dem der Nutzer authentifiziert wird, den Sie fürhana_db_user
angegeben haben.Wenn Sie
hdbuserstore_key
angeben, überspringen Sie die Angabe der Parameterhostname
undport
.
Weitere Informationen zu diesen Parametern finden Sie unter Konfigurationsparameter.
Optional können Sie im Abschnitt
cloud_properties
die automatisch festgelegten Parameterwerte aktualisieren. Fügen Sie dazu den Abschnittcloud_properties
zur Konfigurationsdatei hinzu und geben Sie die erforderlichen Parameter und deren Werte an.Speichern Sie die Konfigurationsdatei.
Starten Sie den Agent neu, damit die neuen Einstellungen wirksam werden:
sudo systemctl restart google-cloud-sap-agent
Beispielhafte Konfigurationsdateien
Compute Engine-Instanz
Los siguientes ejemplos son archivos de configuración completos del agente deGoogle Cloudpara SAP, que se ejecutan en una instancia deCompute Engineausgeführt werden, wobei die Erfassung von Arbeitslastmanager-Bewertungsmesswerten aktiviert ist.
Für die SAP HANA-Authentifizierung verwendet der Agent die folgende Prioritätsreihenfolge: Wenn angegeben, hat der Konfigurationsparameter hdbuserstore_key
Vorrang vor dem Parameter hana_db_password
, der Vorrang vor dem Parameter hana_db_password_secret_name
hat. Wir empfehlen, in der Konfigurationsdatei nur eine Authentifizierungsoption festzulegen.
- Im folgenden Beispiel wird ein Schlüssel für den Secure User Store (
hdbuserstore
) für die SAP HANA-Authentifizierung verwendet:{ "provide_sap_host_agent_metrics": true, "bare_metal": false, "log_level": "INFO", "log_to_cloud": true, "collection_configuration": { "collect_workload_validation_metrics": true, "workload_validation_db_metrics_frequency": 3600, "workload_validation_db_metrics_config": { "hana_db_user": "system", "sid": "DEH", "hdbuserstore_key": "user_store_key" }, "collect_process_metrics": false }, "discovery_configuration": { "enable_discovery": true, "enable_workload_discovery": true }, "hana_monitoring_configuration": { "enabled": false } }
- Im folgenden Beispiel werden ein Nutzername und ein Secret Manager-Secret für die SAP HANA-Authentifizierung verwendet:
{ "provide_sap_host_agent_metrics": true, "bare_metal": false, "log_level": "INFO", "log_to_cloud": true, "collection_configuration": { "collect_workload_validation_metrics": true, "workload_validation_db_metrics_frequency": 3600, "workload_validation_db_metrics_config": { "hana_db_user": "system", "sid": "DEH", "hana_db_password_secret_name": "instance-id-hana-db-password-secret", "hostname": "localhost", "port": "30015" }, "collect_process_metrics": false }, "discovery_configuration": { "enable_discovery": true, "enable_workload_discovery": true }, "hana_monitoring_configuration": { "enabled": false } }
- Im folgenden Beispiel werden ein Nutzername und ein Passwort für die SAP HANA-Authentifizierung verwendet. Wir empfehlen, stattdessen ein Secret Manager-Secret oder einen Schlüssel für den Secure User Store (
hdbuserstore
) für die SAP HANA-Authentifizierung zu verwenden.{ "provide_sap_host_agent_metrics": true, "bare_metal": false, "log_level": "INFO", "log_to_cloud": true, "collection_configuration": { "collect_workload_validation_metrics": true, "workload_validation_db_metrics_frequency": 3600, "workload_validation_db_metrics_config": { "hana_db_user": "system", "sid": "DEH", "hana_db_password": "TempPa55word", "hostname": "localhost", "port": "30015" }, "collect_process_metrics": false }, "discovery_configuration": { "enable_discovery": true, "enable_workload_discovery": true }, "hana_monitoring_configuration": { "enabled": false } }
Bare Metal Solution-Server
Los siguientes ejemplos son archivos de configuración completos del agente deGoogle Cloudpara SAP, que se ejecutan en una instancia deservidor de la solución Bare Metalausgeführt werden, wobei die Erfassung von Arbeitslastmanager-Bewertungsmesswerten aktiviert ist.
Für die SAP HANA-Authentifizierung verwendet der Agent die folgende Prioritätsreihenfolge: Wenn angegeben, hat der Konfigurationsparameter hdbuserstore_key
Vorrang vor dem Parameter hana_db_password
, der Vorrang vor dem Parameter hana_db_password_secret_name
hat. Wir empfehlen, in der Konfigurationsdatei nur eine Authentifizierungsoption festzulegen.
- Im folgenden Beispiel wird ein Schlüssel für den Secure User Store (
hdbuserstore
) für die SAP HANA-Authentifizierung verwendet:{ "provide_sap_host_agent_metrics": true, "bare_metal": true, "log_level": "INFO", "log_to_cloud": true, "collection_configuration": { "collect_workload_validation_metrics": true, "workload_validation_db_metrics_frequency": 3600, "workload_validation_db_metrics_config": { "hana_db_user": "system", "sid": "DEH", "hdbuserstore_key": "user_store_key" }, "collect_process_metrics": false }, "cloud_properties": { "project_id": "my-project", "instance_name": "bms-machine-1", "region": "us-central1" "image": "rhel-8" },
"discovery_configuration": { "enable_discovery": true, "enable_workload_discovery": true }, "hana_monitoring_configuration": { "enabled": false } } - Im folgenden Beispiel werden ein Nutzername und ein Secret Manager-Secret für die SAP HANA-Authentifizierung verwendet:
{ "provide_sap_host_agent_metrics": true, "bare_metal": true, "log_level": "INFO", "log_to_cloud": true, "collection_configuration": { "collect_workload_validation_metrics": true, "workload_validation_db_metrics_frequency": 3600, "workload_validation_db_metrics_config": { "hana_db_user": "system", "sid": "DEH", "hana_db_password_secret_name": "instance-id-hana-db-password-secret", "hostname": "localhost", "port": "30015" }, "collect_process_metrics": false }, "cloud_properties": { "project_id": "my-project", "instance_name": "bms-machine-1", "region": "us-central1" "image": "rhel-8" },
"discovery_configuration": { "enable_discovery": true, "enable_workload_discovery": true }, "hana_monitoring_configuration": { "enabled": false } } - Im folgenden Beispiel werden ein Nutzername und ein Passwort für die SAP HANA-Authentifizierung verwendet. Wir empfehlen, stattdessen ein Secret Manager-Secret oder einen Schlüssel für den Secure User Store (
hdbuserstore
) für die SAP HANA-Authentifizierung zu verwenden.{ "provide_sap_host_agent_metrics": true, "bare_metal": true, "log_level": "INFO", "log_to_cloud": true, "collection_configuration": { "collect_workload_validation_metrics": true, "workload_validation_db_metrics_frequency": 3600, "workload_validation_db_metrics_config": { "hana_db_user": "system", "sid": "DEH", "hana_db_password": "TempPa55word", "hostname": "localhost", "port": "30015" }, "collect_process_metrics": false }, "cloud_properties": { "project_id": "my-project", "instance_name": "bms-machine-1", "region": "us-central1" "image": "rhel-8" },
"discovery_configuration": { "enable_discovery": true, "enable_workload_discovery": true }, "hana_monitoring_configuration": { "enabled": false } }
Konfigurationsparameter
In der folgenden Tabelle werden die Konfigurationsparameter des Agents vonGoogle Cloudfür SAP erläutert, die für die Erfassung der Workload Manager-Bewertungsmesswerte spezifisch sind.
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 |
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
|
Wenn Ihr SAP-System auf einer Compute Engine-Instanz ausgeführt wird, geben Sie den Namen dieser Compute Engine-Instanz an. Der Agent erkennt den Namen der Compute-Instanz bei der Installation automatisch. Wenn Ihr SAP-System auf einem Bare-Metal-Lösungsserver ausgeführt wird, geben Sie den Namen dieses Servers an. |
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 Compute-Instanz ausgeführt wird, verwendet der Agent standardmäßig die Zone, in der die Compute-Instanz bereitgestellt wird. |
cloud_properties.image |
Geben Sie den Namen des Betriebssystem-Images der Instanz an. |
cloud_properties.numeric_project_id |
Geben Sie die numerische ID des Google Cloud-Projekts an, in dem das SAP-System ausgeführt wird. |
discovery_configuration.enable_workload_discovery |
Geben Sie Weitere Informationen finden Sie in der Codebasis des Agents im GitHub-Repository |
discovery_configuration.enable_discovery |
Geben Sie Wenn Sie den Wert |
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_collection_definition.fetch_latest_config |
Optional. Der Standardwert ist |
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 |
Geben Sie das Passwort für das Nutzerkonto an, das zum Abfragen der SAP HANA-Instanz verwendet wird. Für die SAP HANA-Authentifizierung verwendet der Agent die folgende Prioritätsreihenfolge: Wenn angegeben, hat der Konfigurationsparameter |
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. Alternativ können Sie den Konfigurationsparameter Für die SAP HANA-Authentifizierung verwendet der Agent die folgende Prioritätsreihenfolge: Wenn angegeben, hat der Konfigurationsparameter |
collection_configuration.workload_validation_db_metrics_config.hdbuserstore_key
|
Wenn Sie eine sichere Verbindung zu einem SAP HANA-System herstellen möchten, geben Sie den Schlüssel Secure Nutzerspeicher ( Prüfen Sie Folgendes, um einen
Dieser Konfigurationsparameter wird ab Version 3.3 des Agents unterstützt. Wenn Sie Für die SAP HANA-Authentifizierung verwendet der Agent die folgende Prioritätsreihenfolge: Wenn angegeben, hat der Konfigurationsparameter |
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 |
Erfasste Messwerte anzeigen
So rufen Sie die vom Kundenservicemitarbeiter erfassten Bewertungsmesswerte für den Arbeitslastmanager auf:
Logdatei des Agents aufrufen:
Legen Sie die Logebene des Agents auf
DEBUG
fest:sudo /usr/bin/google_cloud_sap_agent configure -loglevel=debug
Nachdem der Agent neu gestartet wurde, um die neue Protokollebene zu aktivieren, sehen Sie sich die Protokolldatei des Agents an:
/var/log/google-cloud-sap-agent.log
Suchen Sie in der Logdatei nach Einträgen mit folgenden Inhalten:
workload.googleapis.com/sap/validation/
Im folgenden Beispiel sind die Bewertungsmesswerte des Arbeitslastmanager in der Logdatei des Agents zu sehen:
{"level":"debug","timestamp":"2024-05-31T20:13:39.439Z",..."context":"WorkloadManagerMetrics",
"metric":"workload.googleapis.com/sap/validation/system","value":1} {"level":"debug","timestamp":"2024-05-31T20:13:39.439Z",..."context":"WorkloadManagerMetrics",
"key":"instance_name","value":"n1-hana-sles15"} {"level":"debug","timestamp":"2024-05-31T20:13:39.439Z",..."context":"WorkloadManagerMetrics",
"key":"os","value":"sles-15-SP4"} ... {"level":"debug","timestamp":"2024-05-31T20:13:39.439Z",..."context":"WorkloadManagerMetrics",
"metric":"workload.googleapis.com/sap/validation/corosync","value":0} ...
Wenn Ihre Agentinstanz so konfiguriert ist, dass Protokolle an Cloud Logging gesendet werden, können Sie sich die Protokolle des Agents in Cloud Logging ansehen.
Erstellen und führen Sie im Arbeitslastmanager eine Bewertung für Ihre SAP-Arbeitslast aus. Weitere Informationen finden Sie unter Bewertung erstellen und ausführen.
Informationen zu den Best Practices, die Workload Manager für die Bewertung von SAP-Arbeitslasten in Google Cloudunterstützt, finden Sie unter Best Practices: Arbeitslastmanager für SAP.