Agent für SAP konfigurieren, um die Beobachtbarkeit einzurichten

In diesem Dokument wird beschrieben, wie Sie den Agent für SAP von Google Cloudkonfigurieren, um die Beobachtbarkeit für Ihre SAP-Arbeitslast mit Workload Manager einzurichten.

Der Workload Manager-Beobachtbarkeitsdienst benötigt den Agent, um Messwerte aus Ihrer SAP-Arbeitslast und der zugrunde liegenden Infrastruktur zu erfassen. Weitere Informationen finden Sie unter SAP-Observability – Übersicht.

Hinweise

  • Prüfen Sie die Installation des Google Cloud-Agents für SAP auf allen Compute Engine-Instanzen, auf denen die SAP-Arbeitslast ausgeführt wird, für die Sie die Beobachtbarkeit einrichten möchten.

    Informationen zum Überprüfen der Agent-Installation finden Sie unter Agent-Installation überprüfen.

  • Prüfen Sie, ob Sie die Voraussetzungen für die SAP-Beobachtbarkeit erfüllt haben.

Agent für eine Arbeitslast mit einer einzelnen Zone konfigurieren

VM Extension Manager

Wenn Sie den Agent auf einer Reihe von Compute Engine-Instanzen konfigurieren und verwalten möchten, müssen Sie eine VM Extension Manager-Richtlinie dafür erstellen.

So konfigurieren Sie den Agent, um die Observability für eine SAP-Arbeitslast einzurichten, die in einer einzelnen Zone ausgeführt wird:

  1. VM Extension Manager einrichten:

  2. Erstellen Sie eine VM-Erweiterungsrichtlinie, die den Agent für SAP von Google Cloudauf den Compute-Instanzen installiert und verwaltet, auf denen Ihre SAP-Arbeitslast ausgeführt wird:

Paketmanager

Wenn Sie den Agent-Lebenszyklus manuell verwalten, anstatt VM Extension Manager zu verwenden, können Sie den Agent für SAP mit einem Paketmanager konfigurieren: Google Cloud

  1. Stellen Sie eine SSH-Verbindung zur Compute-Instanz her, auf der Ihr SAP-Arbeitslast ausgeführt wird.

  2. Prüfen Sie, ob Sie die aktuelle Version des Agents für SAP verwenden.

    Informationen zum Aktualisieren des Agents finden Sie unter Google Cloud-Agent für SAP aktualisieren.

  3. So kann der Agent Details zur SAP-Arbeitslast nachschlagen und an Workload Manager senden:

    sudo /usr/bin/google_cloud_sap_agent configure -feature=sap_discovery -enable
sudo /usr/bin/google_cloud_sap_agent configure -feature=workload_discovery -enable

  4. So aktivieren Sie die Erfassung von Messwerten aus den Prozessen, die in Ihrer SAP-Arbeitslast ausgeführt werden:

    1. Aktivieren Sie die Prozessüberwachungsfunktion des Agents:
    sudo /usr/bin/google_cloud_sap_agent configure -feature=process_metrics -enable
    1. Damit der Agent Prozessmesswerte für Ihre SAP HANA-Datenbankinstanzen erfassen kann, müssen Sie zusätzliche Parameter im Abschnitt hana_metrics_config konfigurieren.

    Weitere Informationen finden Sie unter Erfassung von Prozessmonitoring-Messwerten konfigurieren.

  5. Aktivieren Sie den Agent, um Messwerte von den SAP HANA-Instanzen zu erfassen, die in Ihrer SAP-Arbeitslast ausgeführt werden:

    1. Aktivieren Sie die SAP HANA-Monitoring-Funktion des Agents:
    sudo /usr/bin/google_cloud_sap_agent configure -feature=hana_monitoring -enable
    1. Damit der Agent eine Verbindung zu den SAP HANA-Instanzen herstellen und Messwerte erfassen kann, müssen Sie zusätzliche Parameter konfigurieren.

    Weitere Informationen finden Sie unter Erfassung von SAP HANA-Monitoring-Messwerten konfigurieren.

  6. Speichern Sie die Konfigurationsdatei.

Beispiele für Agent-Konfigurationen für die Observability finden Sie unter Beispielkonfigurationen für Agents.

Agent für eine Arbeitslast mit mehreren Zonen konfigurieren

VM Extension Manager

Wenn Sie den Agent auf einer Reihe von Compute Engine-Instanzen konfigurieren und verwalten möchten, müssen Sie eine VM Extension Manager-Richtlinie dafür erstellen.

So konfigurieren Sie den Agent, um die Beobachtbarkeit für eine SAP-Arbeitslast einzurichten, die in zwei oder mehr Zonen ausgeführt wird:

  1. VM Extension Manager einrichten:

  2. Erstellen Sie eine VM-Erweiterungsrichtlinie, die den Agent für SAP von Google Cloudauf den Compute-Instanzen installiert und verwaltet, auf denen der primäre Standort Ihrer SAP-Arbeitslast ausgeführt wird:

  3. Wenn Sie eine SAP-Arbeitslast mit hoher Verfügbarkeit ausführen oder einen DR-Standort (Disaster Recovery) für Ihre SAP-Arbeitslast haben, erstellen Sie eine VM-Erweiterungsrichtlinie, mit der der Agent für SAP auf den Compute-Instanzen installiert und verwaltet wird, auf denen der sekundäre oder DR-Standort Ihrer SAP-Arbeitslast ausgeführt wird. Google Cloud

Paketmanager

Wenn Sie den Agent-Lebenszyklus manuell verwalten, anstatt VM Extension Manager zu verwenden, können Sie den Agent für SAP mit einem Paketmanager konfigurieren: Google Cloud

  1. Stellen Sie eine SSH-Verbindung zur Compute-Instanz her, auf der Ihr SAP-Arbeitslast ausgeführt wird.

  2. Prüfen Sie, ob Sie die aktuelle Version des Agents für SAP verwenden.

    Informationen zum Aktualisieren des Agents finden Sie unter Google Cloud-Agent für SAP aktualisieren.

  3. So kann der Agent Details zur SAP-Arbeitslast erfassen und an Workload Manager senden:

    sudo /usr/bin/google_cloud_sap_agent configure -feature=sap_discovery -enable
sudo /usr/bin/google_cloud_sap_agent configure -feature=workload_discovery -enable

  4. So aktivieren Sie die Erfassung von Messwerten aus den Prozessen, die in Ihrer SAP-Arbeitslast ausgeführt werden:

    1. Aktivieren Sie die Prozessüberwachungsfunktion des Agents:
    sudo /usr/bin/google_cloud_sap_agent configure -feature=process_metrics -enable
    1. Damit der Agent Prozessmesswerte für Ihre SAP HANA-Datenbankinstanzen erfassen kann, müssen Sie zusätzliche Parameter im Abschnitt hana_metrics_config konfigurieren.

    Weitere Informationen finden Sie unter Erfassung von Prozessmonitoring-Messwerten konfigurieren.

  5. Aktivieren Sie den Agent, um Messwerte von den SAP HANA-Instanzen zu erfassen, die in Ihrer SAP-Arbeitslast ausgeführt werden:

    1. Aktivieren Sie die SAP HANA-Monitoring-Funktion des Agents:
    sudo /usr/bin/google_cloud_sap_agent configure -feature=hana_monitoring -enable
    1. Damit der Agent eine Verbindung zu den SAP HANA-Instanzen herstellen und Messwerte erfassen kann, müssen Sie zusätzliche Parameter konfigurieren.

    Weitere Informationen finden Sie unter Erfassung von SAP HANA-Monitoring-Messwerten konfigurieren.

  6. Speichern Sie die Konfigurationsdatei.

  7. Wenn Sie eine SAP-Arbeitslast mit hoher Verfügbarkeit ausführen oder einen DR-Standort (Disaster Recovery) für Ihre SAP-Arbeitslast haben, wiederholen Sie dieses Verfahren für alle anderen Compute-Instanzen, auf denen Ihre SAP-Arbeitslast ausgeführt wird.

Beispiele für Agent-Konfigurationen für die Observability finden Sie unter Beispielkonfigurationen für Agents.

Einrichtung der Workload Manager-Beobachtbarkeit validieren

Sie können prüfen, ob Sie die richtige Google Cloud -Einrichtung für die Verwendung des Workload Manager-Beobachtbarkeitsdienstes haben, indem Sie den status-Befehl des Agents ausführen.

Führen Sie die folgenden Schritte aus, um die Einrichtung von Google Cloud zu validieren:

  1. Stellen Sie eine SSH-Verbindung zur Compute Engine-Instanz her, auf der Ihre SAP-Arbeitslast ausgeführt wird.

  2. Prüfen Sie die Google Cloud -Einrichtung für die Beobachtbarkeit:

    sudo /usr/bin/google_cloud_sap_agent status

    Wenn Ihre Google Cloud -Einrichtung für die Verwendung des Workload Manager-Beobachtbarkeitsdienstes korrekt ist, enthält die Ausgabe Folgendes. Ihre Konfiguration enthält möglicherweise andere Werte als die default-Werte.

    Agent Status:
    Installed version: 3.10-....
    ...
    Systemd Service Enabled: True
    Systemd Service Running: True
    Cloud API Full Scopes: True
    Configuration File: /etc/google-cloud-sap-agent/configuration.json
    Configuration Valid: True
...
----------------------------------------------------------------------------
Process Metrics: Enabled
    Status: Fully Functional
    IAM Permissions: All granted
    Configuration:
        collect_process_metrics:        true (configuration file)
        process_metrics_frequency:      30    (default)
        process_metrics_to_skip:        []   (default)
        slow_process_metrics_frequency: 120   (default)
...
----------------------------------------------------------------------------
HANA Monitoring Metrics: Enabled
    Status: Fully Functional
    IAM Permissions: All granted
    Configuration:
        connection_timeout:       120   (default)
        enabled:                  true  (configuration file)
        execution_threads:        10    (default)
        max_connect_retries:      1     (default)
        query_timeout_sec:        300   (default)
        sample_interval_sec:      300   (default)
        send_query_response_time: false (default)
...
----------------------------------------------------------------------------
System Discovery: Enabled
    Status: Fully Functional
    IAM Permissions: All granted
    Configuration:
        enable_discovery:                  true  (default)
        enable_workload_discovery:         true  (default)
        sap_instances_update_frequency:    60    (default)
        system_discovery_update_frequency: 14400 (default)
...

  3. Wenn in der Ausgabe darauf hingewiesen wird, dass eine Einrichtung fehlt, sehen Sie sich die Informationen in den vorherigen Abschnitten an, führen Sie die erforderlichen Aktionen aus und führen Sie den Befehl status noch einmal aus, um die Einrichtung neu zu validieren.

  4. Wenn Sie mehr als eine Compute-Instanz zum Ausführen Ihrer Arbeitslast verwenden, wiederholen Sie diesen Vorgang für alle anderen Compute-Instanzen, auf denen Ihre Arbeitslast ausgeführt wird.

Beispielkonfigurationen für Agents

Die folgenden Beispiele sind vollständige Konfigurationsdateien des Google Cloud-Agents für SAP, der für die Unterstützung der Beobachtbarkeit für eine SAP HANA-Arbeitslast konfiguriert ist:

Im folgenden Beispiel wird ein Secure User Store (hdbuserstore)-Schlüssel 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,
      "collect_process_metrics": true,
      "hana_metrics_config": {
        "hana_db_user": "db_user_name",
        "sid": "DEH",
        "hdbuserstore_key": "user_store_key"
      }
    },
    "discovery_configuration": {
      "enable_workload_discovery": true,
      "enable_discovery": true
    },
    "hana_monitoring_configuration": {
      "enabled": true,
      "hana_instances": [
        {
          "name": "local",
          "sid": "DEH",
          "user": "system",
          "hdbuserstore_key": "user_store_key"
        },
        {
          "name": "remote",
          "sid": "DEH",
          "user": "system",
          "hdbuserstore_key": "user_store_key"
        }
      ]
    }
  }

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,
      "collect_process_metrics": true,
      "hana_metrics_config": {
        "hana_db_user": "db_user_name",
        "sid": "DEH",
        "hana_db_password_secret_name": "db_pwd_secret_name"
      }
    },
    "discovery_configuration": {
      "enable_workload_discovery": true,
      "enable_discovery": true
    },
    "hana_monitoring_configuration": {
      "enabled": true,
      "hana_instances": [
        {
          "name": "local",
          "sid": "DEH",
          "host": "localhost",
          "port": "30015",
          "user": "db_user_name",
          "hdbuserstore_key": "user_store_key"
        },
        {
          "name": "remote",
          "sid": "DEH",
          "host": "10.123.0.12",
          "port": "30015",
          "user": "db_user_name",
          "secret_name": "db_pwd_secret_name"
        }
      ]
    }
  }

Im folgenden Beispiel werden ein Nutzername und ein Passwort für die SAP HANA-Authentifizierung verwendet. Wir empfehlen stattdessen, einen Secure Nutzerspeicher (hdbuserstore)-Schlüssel oder ein Secret Manager-Secret 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,
      "collect_process_metrics": true,
      "hana_metrics_config": {
        "hana_db_user": "db_user_name",
        "sid": "DEH",
        "hana_db_password": "TempPa55word"
      }
    },
    "discovery_configuration": {
      "enable_workload_discovery": true,
      "enable_discovery": true
    },
    "hana_monitoring_configuration": {
      "enabled": true,
      "hana_instances": [
        {
          "name": "local",
          "sid": "DEH",
          "host": "localhost",
          "port": "30015",
          "user": "db_user_name",
          "password": "TempPa55word"
        },
        {
          "name": "remote",
          "sid": "DEH",
          "host": "10.123.0.12",
          "port": "30015",
          "user": "db_user_name",
          "password": "TempPa55word"
        }
      ]
    }
  }

Informationen zu den vom Agent unterstützten Konfigurationsparametern finden Sie unter Konfigurationsparameter.

Nächste Schritte

  • Nachdem Sie die Einrichtung der Beobachtbarkeit für eine SAP-Arbeitslast abgeschlossen haben, kann es bis zu 15 Minuten dauern, bis diese Arbeitslast in der Observability-Seite von Workload Manager in der Google Cloud -Konsole angezeigt wird.

    Informationen zum Beobachten Ihrer SAP-Arbeitslast finden Sie unter Beobachtbarkeitsmesswerte für SAP ansehen.