Erfassung von Prozess-Monitoring-Messwerten konfigurieren

In diesem Leitfaden erfahren Sie, wie Sie den Google Cloud-Agent für SAP so konfigurieren, dass die Prozessmonitoring-Messwerte aus Ihren SAP-Systemen erfasst werden.

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

Hinweise

IAM-Rollen festlegen

Damit der Google Cloud-Agent für SAP die Prozessmonitoring-Messwerte erfassen kann, muss das von Ihrer Compute Engine-VM-Instanz oder dem Bare-Metal-Lösung-Server verwendete Dienstkonto folgende Rollen haben:

So fügen Sie Ihrem Dienstkonto die erforderlichen Rollen hinzu:

  1. Öffnen Sie in der Google Cloud Console die Seite IAM.

    IAM aufrufen

  2. Wählen Sie Ihr Google Cloud-Projekt aus.

  3. 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 .

  4. Wählen Sie die erforderliche Rolle in der Liste der verfügbaren Rollen aus:

    • Compute-Betrachter
    • Monitoring > Monitoring-Messwert-Autor
    • Secret Manager > Zugriffsperson für Secret Manager-Secret

  5. Klicken Sie auf Hinzufügen oder Speichern, um dem Dienstkonto die Rollen zuzuweisen.

Erfassung von Prozess-Monitoring-Messwerten aktivieren

Gehen Sie so vor, um das Erfassen von Prozess-Monitoring-Messwerten mit dem Google Cloud-Agent für SAP zu aktivieren:

  1. Stellen Sie eine SSH-Verbindung zu Ihrer Host-VM her.

  2. Ö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.

  3. Führen Sie im Abschnitt collection_configuration folgende Schritte aus:

    • Geben Sie für den Parameter collect_process_metrics den Wert true an.
    • Um die Erfassung von Prozess-Monitoring-Messwerten für Ihre SAP HANA-Datenbankinstanzen zu aktivieren, müssen Sie zusätzliche Parameter im Abschnitt hana_metrics_config konfigurieren. Weitere Informationen zu diesen Parametern finden Sie unter Konfigurationsparameter.

  4. 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.

  5. Speichern Sie die Konfigurationsdatei.

  6. 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 aufeiner Compute Engine-VM-Instanzausgeführt wird, wobei die Erfassung von Prozessmonitoring-Messwerten 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,
    "collect_process_metrics": true,
    "process_metrics_frequency": 5,
    "slow_process_metrics_frequency": 30,
    "hana_metrics_config": {
      "hana_db_user": "db_user_name",
      "sid": "DEH",
      "hana_db_password_secret_name": "db_pwd_secret_name",
      "hdbuserstore_key": "user_store_key"
    }
  },
  "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 aufeinem Bare-Metal-Lösungsserverausgeführt wird, wobei die Erfassung von Prozessmonitoring-Messwerten 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,
    "collect_process_metrics": true,
    "process_metrics_frequency": 5,
    "slow_process_metrics_frequency": 30,
    "hana_metrics_config": {
      "hana_db_user": "db_user_name",
      "sid": "DEH",
      "hana_db_password_secret_name": "db_pwd_secret_name",
      "hdbuserstore_key": "user_store_key"
    }
  },
  "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 Prozessmonitoring-Messwerte 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_process_metrics

Boolean

Geben Sie true an, um die Erfassung von Prozessmonitoring-Messwerten zu aktivieren. Der Standardwert ist false.
Dieser Parameter gilt nur für Linux.

Wenn Sie die Erfassung der Prozessmesswerte für SAP HANA aktivieren, müssen Sie zusätzliche Parameter einrichten, die unter hana_metrics_config aufgeführt sind.
collection_configuration.process_metrics_frequency

Int

Ab Version 2.6 bestimmt dieser Parameter die Erfassungshäufigkeit der schnell wechselnden Prozessmonitoring-Messwerte in Sekunden. Schnell wechselnde Prozessmonitoring-Messwerte sind sap/hana/availability, sap/hana/ha/availability und sap/nw/availability.

Der Standardwert für diesen Parameter ist 5 Sekunden. Wir empfehlen, diesen Standardwert zu verwenden.

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 slow_process_metrics_frequency.
collection_configuration.slow_process_metrics_frequency

Int

Geben Sie die Erfassungshäufigkeit der langsam wechselnden Prozessmonitoring-Messwerte in Sekunden an.

Der Standardwert für diesen Parameter ist 30 Sekunden.
collection_configuration.process_metrics_to_skip

Array

Geben Sie die Prozessmonitoring-Messwerte an, die der Agent nicht erfassen soll. Dieser Parameter akzeptiert einen durch Kommas getrennten Wert von Prozessmonitoring-Messwertnamen. Beispiel: "process_metrics_to_skip": ["/sap/nw/abap/sessions", "/sap/nw/abap/rfc"].

collection_configuration.hana_metrics_config.hana_db_user

String

Geben Sie das Datenbanknutzerkonto an, das der Agent zum Abfragen von SAP HANA verwendet. Standardwert ist SYSTEM.
collection_configuration.hana_metrics_config.hana_db_password

String

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

String

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 hana_db_password_secret_name, hdbuserstore_key oder hana_db_password angeben.
collection_configuration.hana_metrics_config.hdbuserstore_key

String

Zum Authentifizieren des SAP HANA-Nutzers, den Sie für hana_db_user angeben, geben Sie einen hdbuserstore-Schlüssel an, den Sie für diesen Nutzer erstellt haben.

Wenn Sie einen hdbuserstore-Schlüssel für die Authentifizierung verwenden möchten, müssen Sie die folgenden Bedingungen erfüllen:

  • Die SAP-Tools hdbsql und hdduserstore sind auf der Compute-Instanz installiert, die den Agent hostet.
  • Der Schlüssel hdbuserstore entspricht einer bestimmten SAP HANA-Instanz. Sie können keine Schlüssel verwenden, die Hostnamen mehrerer SAP HANA-Instanzen enthalten.
collection_configuration.hana_metrics_config.sid

String

Geben Sie die SID Ihrer SAP HANA-Instanz an.

Erfasste Messwerte anzeigen

Um die vom Agent erfassten Prozessmonitoring-Messwerte zu visualisieren, können Sie die folgenden benutzerdefinierten Dashboards verwenden, die Google Cloud bereitstellt:

  • Agent für SAP-HANA Übersicht: Dieses Dashboard enthält Diagramme mit einer Statusübersicht für die folgenden Messwerte: SAP HANA-Verfügbarkeit, SAP HANA-HA-Verfügbarkeit, SAP HANA-HA-Replikation, SAP HANA-Dienststatus, HA-Cluster – Knotenstatus und HA-Cluster – Ressourcenstatus für SAP-Instanzen.

    Die JSON-Datei für dieses Dashboard ist sap-agent-status-overview.json.

  • Agent für SAP-HANA-Rohdaten: Dieses Dashboard enthält Diagramme mit unverarbeiteten Daten für die folgenden Messwerte: SAP HANA-Verfügbarkeit, SAP HANA HA-Verfügbarkeit, SAP HANA HA-Replikation, SAP HANA-Dienststatus, HA-Cluster – Knotenstatus und HA-Cluster – Ressourcenstatus für SAP-Instanzen.

    Die JSON-Datei für dieses Dashboard ist sap-agent-raw-metrics.json.

Dashboards installieren

So installieren Sie ein benutzerdefiniertes Dashboard:

Google Cloud Console

  1. Rufen Sie in der Google Cloud Console die Seite Monitoring auf:

    Zu Monitoring

  2. Klicken Sie im Navigationsbereich von Monitoring auf Dashboards.

  3. Klicken Sie auf den Tab Beispielbibliothek.

    Anzeige des ausgewählten Tabs der Beispielbibliothek.

  4. Geben Sie im Feld Filter Agent for SAP ein, um die agent-spezifischen benutzerdefinierten Dashboards zu filtern.

  5. (Optional) Klicken Sie auf Vorschau, um Details zu einem Dashboard oder eine Vorschau des Inhalts anzuzeigen.

  6. Wählen Sie das Dashboard aus, das Sie installieren möchten.

  7. Klicken Sie auf Importieren und dann auf Bestätigen.

    Das Dashboard wird den verfügbaren Dashboards in Ihrem Google Cloud-Projekt hinzugefügt. Folgen Sie der Anleitung unter Installierte Dashboards aufrufen, um Ihr Dashboard anzeigen zu lassen.

Google Cloud CLI

  1. Cloud Shell öffnen

    Cloud Shell öffnen

  2. Klonen Sie in Cloud Shell das Repository oder laden Sie es herunter:

    git clone https://github.com/GoogleCloudPlatform/monitoring-dashboard-samples/

  3. Installieren Sie in Cloud Shell das erforderliche Dashboard mithilfe der entsprechenden JSON-Datei:

    gcloud monitoring dashboards create --config-from-file=CONFIG_FROM_FILE

    Ersetzen Sie CONFIG_FROM_FILE durch den Pfad zur JSON-Datei, die die Dashboard-Konfiguration enthält. Dashboard-Konfigurationsdateien können sich unter dem Pfad monitoring-dashboard-samples/dashboards/google-cloud-agent-for-sap befinden.

    Das Dashboard wird den verfügbaren Dashboards in Ihrem Google Cloud-Projekt hinzugefügt. Folgen Sie der Anleitung unter Installierte Dashboards aufrufen, um Ihr Dashboard anzeigen zu lassen.

Installierte Dashboards aufrufen

So rufen Sie die installierten Dashboards auf:

  1. Rufen Sie in der Google Cloud Console die Seite Monitoring auf:

    Zu Monitoring

  2. Klicken Sie im Navigationsbereich von Monitoring auf Dashboards.

  3. Klicken Sie in der Liste auf den Namen des Dashboards.

Wenn Sie viele Dashboards haben, können Sie nach benutzerdefinierten Dashboards oder nach dem Namen des neuen Dashboards filtern. Informationen zum Filtern dieser Liste finden Sie im Artikel Benutzerdefinierte Dashboards anzeigen.

Die folgende Abbildung zeigt ein Teil eines benutzerdefinierten Dashboards für SAP HANA-Messwerte in Monitoring.

Screenshot zeigt das benutzerdefinierte Dashboard für SAP HANA-Messwerte in Monitoring.