Agent für SAP konfigurieren, um die Beobachtbarkeit einzurichten

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

Für den Beobachtbarkeitsdienst von Workload Manager muss der Agent Messwerte aus Ihrer SAP-Arbeitslast und der zugrunde liegenden Infrastruktur erfassen. Weitere Informationen finden Sie unter Übersicht zur SAP-Beobachtbarkeit.

Hinweis

  • Prüfen Sie die Installation des Google CloudAgent 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 Prüfen der Agent-Installation finden Sie unter Installation des Agents prüfen.

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

Agent für eine Arbeitslast in 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 Beobachtbarkeit für eine SAP-Arbeitslast einzurichten, die in einer einzelnen Zone ausgeführt wird: Führen Sie die folgenden Schritte aus:

  1. VM Extension Manager einrichten:

  2. Erstellen Sie eine VM-Erweiterungsrichtlinie, die den Agent für SAP von Google Cloud's auf 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 von Google Cloudmit einem Paket manager konfigurieren:

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

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

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

  3. So kann der Agent Details zur SAP-Arbeitslast suchen 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. Aktivieren Sie den Agent, um Messwerte aus den Prozessen zu erfassen, 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. Wenn der Agent Prozessmesswerte für Ihre SAP HANA-Datenbankinstanzen erfassen soll, müssen Sie zusätzliche Parameter im Abschnitt hana_metrics_config konfigurieren.

    Weitere Informationen finden Sie unter Erfassung von Prozessüberwachungsmesswerten konfigurieren.

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

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

    Weitere Informationen finden Sie unter Erfassung von SAP HANA-Überwachungsmesswerten konfigurieren.

  6. Speichern Sie die Konfigurationsdatei.

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

Agent für eine Arbeitslast in 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 Zonenausgeführt wird:

  1. VM Extension Manager einrichten:

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

  3. Wenn Sie eine hochverfügbare SAP-Arbeitslast ausführen oder einen Notfall wiederherstellungsstandort für Ihre SAP-Arbeitslast haben, erstellen Sie eine VM-Erweiterungsrichtlinie, die den Agent für SAP von Google Cloudauf den Compute-Instanzen installiert und verwaltet, auf denen der sekundäre Standort oder der Notfallwiederherstellungsstandort Ihrer 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 von Google Cloudmit einem Paket manager konfigurieren:

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

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

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

  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. Aktivieren Sie den Agent, um Messwerte aus den Prozessen zu erfassen, 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. Wenn der Agent Prozessmesswerte für Ihre SAP HANA-Datenbankinstanzen erfassen soll, müssen Sie zusätzliche Parameter im Abschnitt hana_metrics_config konfigurieren.

    Weitere Informationen finden Sie unter Erfassung von Prozessüberwachungsmesswerten konfigurieren.

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

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

    Weitere Informationen finden Sie unter Erfassung von SAP HANA-Überwachungsmesswerten konfigurieren.

  6. Speichern Sie die Konfigurationsdatei.

  7. Wenn Sie eine hochverfügbare SAP-Arbeitslast ausführen oder einen Notfallwiederherstellungsstandort für Ihre SAP-Arbeitslast haben, wiederholen Sie diesen Vorgang für alle anderen Compute-Instanzen, auf denen Ihre SAP-Arbeitslast ausgeführt wird.

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

Einrichtung für die Beobachtbarkeit von Workload Manager prüfen

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

So prüfen Sie die Google Cloud Einrichtung:

  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 Beobachtbarkeitsdienstes von Workload Manager korrekt ist, enthält die Ausgabe Folgendes. Ihre Konfiguration kann andere Werte als die default -Werte haben.

    Agent Status:
    Installed version: 3.12-....
    ...
    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 die Ausgabe zeigt, dass eine Einrichtung fehlt, lesen Sie die Informationen in den vorherigen Abschnitten, führen Sie die erforderlichen Aktionen aus und führen Sie dann den Befehl status noch einmal aus, um die Einrichtung noch einmal zu prüfen.

  4. Wenn Sie mehr als eine Compute-Instanz verwenden, um Ihre Arbeitslast auszuführen, 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's Agent für SAP, der für die Unterstützung der Beobachtbarkeit für eine SAP HANA-Arbeitslast konfiguriert ist:

Im folgenden Beispiel wird ein Schlüssel für den sicheren Nutzerspeicher (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,
      "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 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 Schlüssel für den sicheren Nutzerspeicher (hdbuserstore) 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 auf der Seite Beobachtbarkeit von Workload Manager in der Google Cloud Konsole angezeigt wird.

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