Erfassung von Arbeitslastmanager-Bewertungsmesswerten konfigurieren

In diesem Leitfaden erfahren Sie, wie Sie den Google Cloud-Agent für SAP konfigurieren, um Arbeitslastmanager-Bewertungsmesswerte aus Ihren SAP-Systemen zu erfassen.

Informationen zu diesem Feature finden Sie unter Arbeitslastmanager-Bewertung mit dem Google Cloud-Agent für SAP.

Hinweise

Installation des Google Cloud-Agents für SAP prüfen. 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 Projekt aktiviert ist. Eine Anleitung finden Sie unter Workload Manager API aktivieren.

IAM-Rollen festlegen

Damit der Google Cloud-Agent für SAP die Arbeitslastmanager-Bewertungsmesswerte erfassen kann, muss das von Ihrer Compute Engine-VM-Instanz oder dem Bare-Metal-Lösung-Server 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.

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

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 Cloud fü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.2 (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.

SLES

Stellen Sie eine SSH-Verbindung zu Ihrer Instanz her.
Aktualisieren Sie die Agent-Instanz:
- (Empfohlen) So aktualisieren Sie den Agent auf Version 3.2 (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.

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-VM-Instanz oder dem 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_validation -enable

So aktivieren Sie die Erfassung der Messwerte "SAP HANA Insights" und "Best Practices für die Sicherheit von SAP HANA":
1. Ö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 Google Cloud-Agent für SAP.
2. Fügen Sie den Abschnitt workload_validation_db_metrics_config nach collect_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.
  - hana_db_password_secret_name: Geben Sie den Namen des Secrets im Secret Manager an, in dem das Passwort des Nutzerkontos gespeichert ist.
  - hostname: Geben Sie die Kennzeichnung der Maschine an, entweder lokal oder remote, die Ihre SAP HANA-Instanz hostet.
  - port: Geben Sie den Port an, über den die SAP HANA-Instanz Abfragen akzeptiert.
  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 Abschnitt cloud_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-VM-Instanz

Das folgende Beispiel ist eine vollständige Konfigurationsdatei des Google Cloud-Agents für SAP, die auf einem einer Compute Engine-VM-Instanz ausgeführt wird, wobei die Erfassung von Arbeitslastmanager-Bewertungsmesswerten aktiviert ist:

{
  "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",
      "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": "vm-instance-1",
    "image": "rhel-8"
  },
  "discovery_configuration": {
    "enable_discovery": true
  },
  "hana_monitoring_configuration": {
    "enabled": false
  }
}

Bare Metal Solution-Server

Das folgende Beispiel ist eine vollständige Konfigurationsdatei des Google Cloud-Agents für SAP, die auf einem Bare-Metal-Lösungsserver ausgeführt wird, wobei die Erfassung von Arbeitslastmanager-Bewertungsmesswerten aktiviert ist:

{
  "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",
      "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
  },
  "hana_monitoring_configuration": {
    "enabled": false
  }
}

Konfigurationsparameter

In der folgenden Tabelle werden die Konfigurationsparameter des Agents von Google Cloud für SAP erläutert, die für die Erfassung der Arbeitslastmanager-Bewertungsmesswerte spezifisch sind.

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` Wenn Ihr SAP-System auf einer Compute Engine-VM-Instanz ausgeführt wird, geben Sie den Namen dieser VM-Instanz an. Der Agent erkennt den Namen der VM-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`	`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_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.