Version 2: SAP HANA-Monitoring-Messwerterfassung konfigurieren

In diesem Leitfaden erfahren Sie, wie Sie Version 2 des Agents von Google für SAP konfigurieren, um die SAP HANA-Monitoring-Messwerte aus Ihren SAP HANA-Systemen zu erfassen.

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

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.

IAM-Rollen festlegen

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

• Compute-Betrachter (roles/compute.viewer)
• Monitoring-Messwert-Autor (roles/monitoring.metricWriter)
• 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:

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 SAP HANA-Monitoring-Messwerten aktivieren

So aktivieren Sie die Erfassung von SAP HANA-Monitoring-Messwerten mit dem Google Cloud-Agent für SAP:

1. Stellen Sie eine SSH-Verbindung zu Ihrer Compute Engine-VM-Instanz oder dem Bare-Metal-Lösungsserver her.

2. Öffnen Sie die Konfigurationsdatei des Agents.

   /etc/google-cloud-sap-agent/configuration.json

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

   • Legen Sie für den Parameter enabled den Wert true fest.
   • Geben Sie im Abschnitt hana_instances die SAP HANA-Instanzen an, die der Agent überwachen soll.
   • Definieren Sie optional benutzerdefinierte Abfragen. Informationen zum Festlegen benutzerdefinierter Abfragen und Beispiele finden Sie unter Benutzerdefinierte Abfragen definieren.

   • Optional können Sie die integrierten Abfragen oder Standardabfragen deaktivieren. Eine Anleitung finden Sie unter SQL-Abfrage deaktivieren.

     Informationen zu den Konfigurationsparametern 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

{
  "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": false
  },
  "cloud_properties": {
    "project_id": "my-project",
    "instance_name": "vm-instance-1",
    "image": "rhel-8"
  },
  "discovery_configuration": {
    "enable_discovery": true
  },
  "hana_monitoring_configuration": {
    "enabled": true,
    "sample_interval_sec": 60,
    "query_timeout_sec": 30,
    "execution_threads": 20,
    "hana_instances": [
      {
        "name": "local",
        "sid": "DEH",
        "host": "localhost",
        "port": "30015",
        "user": "system",
        "secret_name": "password-secret-name"
      },
      {
        "name": "remote",
        "sid": "DEH",
        "host": "10.123.0.12",
        "port": "30015",
        "user": "system",
        "secret_name": "password-secret-name"
      }
    ],
    "queries": [
      {
        "name": "custom_query",
        "enabled": true,
        "sql": "SELECT * FROM MyTable;",
        "columns": [
          {
            "name": "string",
            "metric_type": "METRIC_LABEL",
            "value_type": "VALUE_STRING"
          },
          {
            "name": "bool",
            "metric_type": "METRIC_GAUGE",
            "value_type": "VALUE_BOOL"
          },
          {
            "name": "int",
            "metric_type": "METRIC_GAUGE",
            "value_type": "VALUE_INT64"
          },
          {
            "name": "double",
            "metric_type": "METRIC_GAUGE",
            "value_type": "VALUE_DOUBLE"
          }
        ]
      },
      {
        "name": "default_host_queries",
        "enabled": false
      }
    ]
  }
}

{
  "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": 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": true,
    "sample_interval_sec": 60,
    "query_timeout_sec": 30,
    "execution_threads": 20,
    "hana_instances": [
      {
        "name": "local",
        "sid": "DEH",
        "host": "localhost",
        "port": "30015",
        "user": "system",
        "secret_name": "password-secret-name"
      },
      {
        "name": "remote",
        "sid": "DEH",
        "host": "10.123.0.12",
        "port": "30015",
        "user": "system",
        "secret_name": "password-secret-name"
      }
    ],
    "queries": [
      {
        "name": "custom_query",
        "enabled": true,
        "sql": "SELECT * FROM MyTable;",
        "columns": [
          {
            "name": "string",
            "metric_type": "METRIC_LABEL",
            "value_type": "VALUE_STRING"
          },
          {
            "name": "bool",
            "metric_type": "METRIC_GAUGE",
            "value_type": "VALUE_BOOL"
          },
          {
            "name": "int",
            "metric_type": "METRIC_GAUGE",
            "value_type": "VALUE_INT64"
          },
          {
            "name": "double",
            "metric_type": "METRIC_GAUGE",
            "value_type": "VALUE_DOUBLE"
          }
        ]
      },
      {
        "name": "default_host_queries",
        "enabled": false
      }
    ]
  }
}

Benutzerdefinierte SQL-Abfrage definieren

Der Google Cloud-Agent für SAP erfasst die SAP HANA-Monitoring-Messwerte, indem SQL-Abfragen auf Ihren SAP HANA-Instanzen ausgeführt werden. Zusätzlich zu diesen Standardabfragen können Sie benutzerdefinierte SQL-Abfragen definieren und ausführen. Gehen Sie dazu so vor:

1. Stellen Sie eine SSH-Verbindung zu Ihrer Compute Engine-VM-Instanz oder dem Bare-Metal-Lösungsserver her.

2. Öffnen Sie die Konfigurationsdatei des Agents.

   /etc/google-cloud-sap-agent/configuration.json

3. Legen Sie im Abschnitt hana_monitoring_configuration.queries Ihre benutzerdefinierte Abfrage fest.

   Informationen zum Festlegen benutzerdefinierter Abfragen und Beispiele finden Sie unter Benutzerdefinierte Abfragen definieren.

4. Zum Aktivieren einer benutzerdefinierten Abfrage setzen Sie den Parameter enabled auf true.

5. Speichern Sie die Konfigurationsdatei.

6. Starten Sie den Agent neu, damit die neuen Einstellungen wirksam werden:

   sudo systemctl restart google-cloud-sap-agent

SQL-Abfrage deaktivieren

Wenn Sie keine der integrierten SQL-Abfragen, die der Google Cloud-Agent für SAP bietet, und auch keine der von Ihnen definierten benutzerdefinierten Abfragen ausführen möchten, können Sie die SQL-Abfrage deaktivieren. Gehen Sie dazu so vor:

1. Stellen Sie eine SSH-Verbindung zu Ihrer Compute Engine-VM-Instanz oder dem Bare-Metal-Lösungsserver her.

2. Öffnen Sie die Konfigurationsdatei des Agents.

   /etc/google-cloud-sap-agent/configuration.json

3. So deaktivieren Sie eine integrierte Abfrage oder Standardabfrage im Abschnitt hana_monitoring_configuration.queries:

   {
   "name": "default_QUERY_NAME",
   "enabled": false
   }

   Ersetzen Sie QUERY_NAME durch den Namen der Standardabfrage. Informationen zu den Standardabfragen finden Sie unter Referenz zu Standardabfragen.

4. Wenn Sie eine benutzerdefinierte Abfrage deaktivieren möchten, setzen Sie den Parameter enabled für diese benutzerdefinierte Abfrage auf false.

5. Speichern Sie die Konfigurationsdatei.

6. Starten Sie den Agent neu, damit die neuen Einstellungen wirksam werden:

   sudo systemctl restart google-cloud-sap-agent

Konfigurationsparameter

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

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 – detaillierte HANA-Übersicht Dieses Dashboard enthält Diagramme mit einer Statusübersicht für die folgenden Messwerte: Instanzarbeitsspeicher, verwendeter Dienstspeicher, geschätzter Höchstspeicher des Schemas, Gesamtgröße des Row Store-Speichers, Ausreißer im Schemalesen, Ausreißer im Schemaschreiben, Anzahl der zuletzt komprimierten Datensätze mit Schemaausreißern, Systemverbindungen, Benachrichtigungen, CPU-Prozentsatz für die Top-5-VMs, Arbeitsspeicherprozentsatz für die Top-5-VMs und die Hosts nach Region.

  Die JSON-Datei für dieses Dashboard ist agent-for-sap-hana-detailed-overview.json.

• Agent für SAP – HANA-Leistung: Dieses Dashboard enthält Diagramme, die Rohmesswerte für die folgenden Messwerte anzeigen: Instanzarbeitsspeicher, Ausreißer im Schemalesen und -schreiben, Schemaleistung, Arbeitsspeichernutzung, Datensatzanzahl der Schemaausreißer, verwendete Gesamtgröße des Arbeitsspeichers, Größe des Row Store-Speichers, Systeminaktivität und laufende Verbindungen, Verbindungs- und Row Store-Arbeitsspeicher, Gesamtdatensätze des Schemas und die geschätzte maximale Gesamtgröße des Schemas.

  Die JSON-Datei für dieses Dashboard ist agent-for-sap-hana-performance.json.

Dashboards installieren

So installieren Sie ein benutzerdefiniertes Dashboard:

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.