Installations- und Betriebsanleitung für den Monitoring-Agent für SAP HANA V2.0

Dieser Leitfaden enthält Anleitungen zum Installieren und Ausführen von Version 2.0 des Google Cloud-Monitoring-Agents für SAP HANA und zur Fehlerbehebung.

Eine Übersicht über den Monitoring-Agent für SAP HANA und seine Optionen finden Sie im Planungsleitfaden für den Monitoring-Agent für SAP HANA V2.0.

Vorbereitung

Der Monitoring-Agent für SAP HANA erfordert SAP HANA-Verbindungstreiber und eine bestimmte Version der Java-Laufzeitumgebung (JRE).

Wenn der Server, auf dem Sie den Agent installieren, Zugriff auf das Internet hat, lädt der Agent die Dateien während der Installation automatisch herunter.

Wenn der Server keinen Internetzugriff hat, können Sie die Dateien selbst auf den Server hochladen.

Wenn Sie sie selbst hochladen müssen, laden Sie vor der Installation des Agents folgende Dateien in das Verzeichnis /tmp/gcpsapdeps hoch:

  • https://github.com/SAP/SapMachine/releases/download/sapmachine-17.0.1/sapmachine-jre-17.0.1_linux-x64_bin.tar.gz
  • https://repo1.maven.org/maven2/com/sap/cloud/db/jdbc/ngdbc/2.11.14/ngdbc-2.11.14.jar

In diesem Leitfaden wird auch Folgendes vorausgesetzt:

  • Ein Google-Konto.
  • Ein Google Cloud-Projekt.
  • Ein Google Cloud-Rechnungskonto.
  • Eine oder mehrere bereitgestellte SAP HANA-Instanzen. Informationen zum Bereitstellen von SAP HANA in Google Cloud finden Sie im Bereitstellungsleitfaden für SAP HANA.

Erforderliche IAM-Rollen festlegen

Das Dienstkonto, das der Monitoring-Agent für SAP HANA verwendet, muss mindestens die Rolle Monitoring Metric Writer enthalten. Ist dies nicht der Fall, müssen Sie dem Dienstkonto die Rolle Monitoring Metric Writer zuweisen.

Wenn Sie das Passwort des SAP HANA-Systemnutzers mithilfe des Secret Managers speichern, muss das Dienstkonto die Rolle Secret Manager Secret Accessor enthalten und VM-Instanzen müssen den Zugriffsbereich cloud-platform enthalten.

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

  1. Rufen Sie in der Google Cloud Console die Seite IAM unter „IAM und Verwaltung“ auf.

    IAM aufrufen

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

  3. Identifizieren Sie das Dienstkonto, dem Sie die IAM-Rollen hinzufügen möchten.

    • Wenn sich das Dienstkonto nicht schon in der Hauptkontoliste 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 auf die Schaltfläche Hauptkonto bearbeiten Hauptkonto bearbeiten neben dem Dienstkonto, das Sie bearbeiten möchten.
  4. Klicken Sie auf Weitere Rolle hinzufügen und prüfen Sie, ob Ihrem Dienstkonto die folgenden Rollen zugewiesen sind:

    • Monitoring > Monitoring-Messwert-Autor
    • Secret Manager > Zugriffsperson für Secret Manager-Secret
  5. Klicken Sie auf Hinzufügen oder Speichern, um Ihrem Dienstkonto die Rollen zuzuweisen.

Informationen zum Festlegen von Zugriffsbereichen für eine VM-Instanz finden Sie unter Dienstkonto und Zugriffsbereiche für eine Instanz ändern.

Weitere Informationen zu den IAM-Rollen und -Bereichen, die für den Zugriff auf Secret Manager erforderlich sind, finden Sie unter Zugriffssteuerung von Secret Manager.

Monitoring-Agent für SAP HANA installieren

Google Cloud-RPM-Repository zur Betriebssystem-Repository-Liste hinzufügen

Sie müssen die URL für das Google Cloud-RPM-Repository für den Agent der Liste der Paket-Repositories für das Betriebssystem hinzufügen. Wie Sie ein Repository hinzufügen, hängt davon ab, ob Sie ein Red Hat- oder ein SUSE-Betriebssystem verwenden.

Repository zu RHEL hinzufügen

Um das Google Cloud-RPM-Repository zu RHEL hinzuzufügen, wählen Sie Ihre Version aus und gehen Sie so vor:

RHEL 7

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

  2. Führen Sie dazu folgenden Befehl aus:

    sudo tee /etc/yum.repos.d/google-saphanamonitoring-agent.repo << EOM
    [google-saphanamonitoring-agent]
    name=Google SAP HANA Monitoring Agent
    baseurl=https://packages.cloud.google.com/yum/repos/google-saphanamonitoring-agent-el7-\$basearch
    enabled=1
    gpgcheck=0
    repo_gpgcheck=0
    gpgkey=https://packages.cloud.google.com/yum/doc/yum-key.gpg
    EOM

RHEL 8

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

  2. Führen Sie dazu folgenden Befehl aus:

    sudo tee /etc/yum.repos.d/google-saphanamonitoring-agent.repo << EOM
    [google-saphanamonitoring-agent]
    name=Google SAP HANA Monitoring Agent
    baseurl=https://packages.cloud.google.com/yum/repos/google-saphanamonitoring-agent-el8-\$basearch
    enabled=1
    gpgcheck=0
    repo_gpgcheck=0
    gpgkey=https://packages.cloud.google.com/yum/doc/yum-key.gpg
    EOM

Repository zu SLES hinzufügen

Um das Google Cloud-RPM-Repository zu SLES hinzuzufügen, wählen Sie Ihre Version aus und gehen Sie so vor:

SLES 12

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

  2. Führen Sie dazu folgenden Befehl aus:

    sudo zypper addrepo --gpgcheck-allow-unsigned-package --refresh \
    https://packages.cloud.google.com/yum/repos/google-saphanamonitoring-agent-sles12-\$basearch google-saphanamonitoring-agent

SLES 15

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

  2. Führen Sie dazu folgenden Befehl aus:

    sudo zypper addrepo --gpgcheck-allow-unsigned-package --refresh \
    https://packages.cloud.google.com/yum/repos/google-saphanamonitoring-agent-sles15-\$basearch google-saphanamonitoring-agent

Agent installieren

Sie installieren den Monitoring-Agent für SAP HANA mithilfe des OS-Paketmanagers.

Wählen Sie Ihr Betriebssystem aus und folgen Sie der Anleitung, um den Agent zu installieren:

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

  2. Führen Sie dazu folgenden Befehl aus:

    RHEL

    sudo yum install google-saphanamonitoring-agent

    SLES

    sudo zypper --no-gpg-checks install google-saphanamonitoring-agent

Der Agent ist im Verzeichnis /usr/sap/google-saphanamonitoring-agent installiert.

Agent konfigurieren

Konfigurieren Sie den Agent, indem Sie die Agent-Konfigurationsdatei ändern: /usr/sap/google-saphanamonitoring-agent/conf/configuration.yaml.

Serverattributwerte, die automatisch erkannt werden

Standardmäßig ist der Abschnitt cloud_properties in der Datei configuration.yaml wie im folgenden Beispiel gezeigt auskommentiert und der Monitoring-Agent für SAP HANA verwendet die Projekt-ID, die Instanz-ID und die Zone der VM-Instanz, auf der der Agent ausgeführt wird.

  # cloud_properties:
     # project_id: MONITORED_INSTANCE_PROJECT_ID
     # instance_id: MONITORED_VM_ID
     # zone: MONITORED_VM_ZONE

Wenn der Agent auf derselben VM wie SAP HANA ausgeführt wird, können Sie den Abschnitt cloud_properties auskommentieren.

Wenn der Agent auf einer anderen VM als SAP HANA ausgeführt wird, müssen Sie das Kommentarzeichen # aus jeder Zeile im Abschnitt cloud_properties entfernen und die Attribute project_id, instance_id und zone durch die Projekt-ID, die Instanz-ID und die Zone der SAP HANA-Host-VM aktualisieren.

Wenn SAP HANA auf einem Bare-Metal-Lösungsserver ausgeführt wird, müssen Sie das Kommentarzeichen # aus den Zeilen cloud_properties und project_id entfernen und die Projekt-ID des Projekts angeben, das Sie mit der Bare-Metal-Lösung verwenden. Lassen Sie die Attribute instance_id und zone auskommentiert.

SAP HANA-Attributwerte, die automatisch erkannt werden

Standardmäßig wird das Attribut sid in der Datei configuration.yaml auskommentiert und der Agent ruft die SAP HANA-System-ID (SID) aus der SAP HANA-Tabelle M_DATABASE ab. Wenn Sie eine andere SID angeben müssen, entfernen Sie das Kommentarzeichen aus der Zeile sid und geben Sie die gewünschte SID an.

Konfigurationsverfahren

In den folgenden Schritten werden die üblicherweise verwendeten Konfigurationsattribute angegeben. Eine Beschreibung aller Konfigurationsattribute finden Sie in den Beschreibungen der Konfigurationsattribute.

  1. Öffnen Sie die Konfigurationsdatei zur Bearbeitung mit Ihrem bevorzugten Texteditor. Beispiel:

    sudo vi /usr/sap/google-saphanamonitoring-agent/conf/configuration.yaml
  2. Entfernen Sie optional unter gcloud_auth das Kommentarzeichen # und geben Sie den Pfad zu einer JSON-Datei an, die den Schlüssel für ein IAM-Dienstkonto für den Agent enthält. Beispiel:

    gcloud_auth:
    # If defined this service account will be used for API calls or else the default VM credentials
    # will be used.
    service_account_json: /usr/sap/google-saphanamonitoring-agent/auth/example-project-id-abcdef123456.json
  3. Geben Sie eine oder mehrere SAP HANA-Instanzen an, die der Agent überwachen soll.

    Wenn Sie mehrere SAP HANA-Datenbanken angeben möchten, erstellen Sie eine neue Gruppe von Attributen, indem Sie alle entsprechenden hana_instances-Attribute von - name bis trust_store_secret_name kopieren. Die Attribute für SSL, Zertifikat, Schlüsselspeicher und Truststore müssen nur dann kopiert werden, wenn sie von der zusätzlichen SAP HANA-Instanz verwendet werden. Fügen Sie den zusätzlichen Satz von Instanzattributen unmittelbar nach dem ersten Satz und vor queries ein.

    So definieren Sie eine SAP HANA-Instanz:

    1. Geben Sie den Namen des Hosts an, auf dem die SAP HANA-Instanz ausgeführt wird. Dieser Wert wird in den Logs und in Monitoring angezeigt. Beispiel:

      - name: example-hana-vm
    2. Geben Sie die IP-Adresse des Hosts an, auf dem die SAP HANA-Instanz ausgeführt wird.

      • Wenn die SAP HANA-Instanz auf einer anderen Host-VM als der Agent ausgeführt wird, geben Sie die interne IP-Adresse der Host-VM an. Beispiel:

        host: 10.1.0.100
      • Wenn die SAP HANA-Instanz auf einem Host ausgeführt wird, der sich nicht im selben Google Cloud-Projekt wie der Agent befindet, geben Sie die öffentliche IP-Adresse der Host-VM an.

      • Wenn der Agent auf demselben Host wie SAP HANA ausgeführt wird, können Sie den Standardwert übernehmen. Dabei handelt es sich um die localhost-Loopback-IP-Adresse 127.0.0.1.

    3. Geben Sie den Port an, über den die SAP HANA-Instanz Abfragen akzeptiert. Bei der ersten oder einzigen Mandantendatenbank ist der Port 3nn15, wobei nn die Instanznummer von SAP HANA ist.

      port: 30015
    4. Geben Sie das SAP HANA-Nutzerkonto an, das der Agent zum Abfragen von SAP HANA verwenden soll. Standardmäßig ist das Nutzerkonto SYSTEM angegeben:

      user: SYSTEM
    5. Geben Sie das Passwort für das SAP HANA-Nutzerkonto an, das der Agent zum Abfragen von SAP HANA verwenden soll. Beispiel:

      password: TempPa55word
    6. Wenn das SAP HANA-System Transport Layer Secure (TLS)/Secure Sockets Layer (SSL) verwendet, aktivieren Sie die SSL-Unterstützung:

      enable_ssl: true
    7. Wenn Sie Zertifikate validieren möchten, wenn SAP HANA TLS/SSL verwendet, aktivieren Sie die Zertifikatprüfung und geben Sie bei Bedarf die Attribute für Zertifikatname, Schlüsselspeicher und Truststore an.

      validate_certificate: true

      Eine Beschreibung der Attribute für Zertifikatname, Schlüsselspeicher und Truststore finden Sie unter Beschreibungen der Konfigurationsattribute.

  4. Speichern und schließen Sie die configuration.yaml-Datei.

Beschreibungen der Konfigurationsattribute

In der folgenden Tabelle sind alle Attribute aufgeführt, mit denen Sie Ihre SAP HANA-Instanzen, Verbindungen, die TLS/SSL-Unterstützung und die Unterstützung der Zertifikatsprüfung definieren können.

Mit Ausnahme von sample_interval und query_timeout, die globale Standardeinstellungen für Abfragen definieren, werden alle anderen Attribute, die zur Definition oder Aktivierung einzelner Abfragen verwendet werden, im Planungsleitfaden für den Monitoring-Agent für SAP HANA dokumentiert.

Attribut Datentyp Beschreibung
sample_interval Int Definiert das Standardintervall in Sekunden zwischen den Abfragen. Der hier angegebene Wert kann für eine einzelne Abfrage überschrieben werden, indem in der Abfragedefinition sample_interval angegeben wird. Der Standardwert ist 300 (5 Minuten).
query_timeout Int Zulässige Zeit für die Ausführung der Abfrage in Sekunden. Der Standardwert beträgt fünf Minuten.
cloud_properties Attribute, die die Umgebung identifizieren, in der der Agent ausgeführt wird. Diese Werte werden automatisch erkannt, können aber geändert werden.
project_id String

Die ID des Google Cloud-Projekts, in dem SAP HANA ausgeführt wird.

In Monitoring ist dieser Wert ein Ressourcenlabel, mit dem Sie Ihre Daten filtern können.

Geben Sie dieses Attribut an, wenn SAP HANA auf einer anderen VM als der Agent oder auf einem Bare-Metal-Lösungsserver ausgeführt wird.

Wird der Agent auf derselben VM wie SAP HANA ausgeführt, so erkennt der Agent die Projekt-ID standardmäßig automatisch. Sie können das Standardverhalten überschreiben. Dazu geben Sie einen Attributwert an.

instance_id String

Wenn SAP HANA auf einer anderen Compute Engine-VM als der Agent ausgeführt wird, wird die Instanz-ID der SAP HANA-Host-VM angegeben.

In Monitoring ist dieser Wert ein Ressourcenlabel, mit dem Sie Ihre Daten filtern können.

Wenn SAP HANA auf einem Bare-Metal-Lösungsserver ausgeführt wird, lassen Sie instance_id immer auskommentiert.

Standardmäßig verwendet der Agent die Instanz-ID der VM, auf der der Agent installiert ist.

zone String

Wenn SAP HANA auf einer Compute Engine-VM in einer anderen Zone als der Agent ausgeführt wird, wird die Zone der SAP HANA-Host-VM angegeben.

In Monitoring ist dieser Wert ein Ressourcenlabel, mit dem Sie Ihre Daten filtern können.

Wenn SAP HANA auf einem Bare-Metal-Lösungsserver ausgeführt wird, lassen Sie zone immer auskommentiert.

Standardmäßig verwendet der Agent die Zone der VM, auf der der Agent installiert ist.

gcloud_auth Attribute in Bezug auf das Dienstkonto, das der Agent für die Identitäts- und Zugriffsverwaltung verwendet.
service_account_json String Gibt den Pfad zu einer JSON-Datei an, die den Schlüssel eines benutzerdefinierten Dienstkontos enthält, das Sie erstellen. Google Cloud verwendet das Dienstkonto, um den Agent zu authentifizieren und zu bestimmen, auf welche Google Cloud APIs und Ressourcen der Agent zugreifen kann. Wenn service_account_json weggelassen wird, verwendet der Agent das Dienstkonto der Host-VM.
hana_instances Attribute, die eine zu überwachende SAP HANA-Datenbank identifizieren. Wenn Sie mehr als eine SAP HANA-Datenbank angeben möchten, erstellen Sie eine neue Gruppe von Attributen, indem Sie die vorhandenen Instanzattribute von - name bis einschließlich enable_ssl kopieren und direkt nach der ersten Gruppe einfügen. Definieren Sie die zusätzliche Datenbank mit den neuen Attributen.
- name String

Der Name des Hosts, auf dem SAP HANA ausgeführt wird. Dieser Wert gibt die SAP HANA-Instanz an.

In Monitoring ist dieser Wert ein Messwertlabel, mit dem Sie Ihre Daten filtern können.

Wenn Sie mehr als eine Datenbank überwachen, ändern Sie diesen Wert, um die Datenbanken zu unterscheiden.

sid String Ein optionales Attribut, das die SID der SAP HANA-Instanz angibt, die der Agent überwacht.

Der Agent ruft diesen Wert normalerweise automatisch von SAP HANA ab, sodass Sie ihn nicht angeben müssen. Wenn Sie einen anderen Wert angeben müssen oder der Agent die SID nicht automatisch erkennt, entfernen Sie das Kommentarzeichen des Attributs sid und geben Sie den erforderlichen Wert an.

host String Die IP-Adresse des SAP HANA-Hosts. Wenn der Agent auf demselben Host wie SAP HANA ausgeführt wird, können Sie den Standard akzeptieren. Dies ist die localhost-Loopback-IP-Adresse.
port Int Die von SAP definierte Portnummer des SAP HANA-Servers. Geben Sie für die erste oder einzige Mandantendatenbank 3nn15 an, wobei nn die SAP HANA-Instanznummer ist. Weitere Informationen zu SAP HANA-Ports finden Sie unter TCP/IP-Ports aller SAP-Produkte.
connections Int Bei Verbindungs-Pooling die Anzahl der Verbindungen, die im Verbindungspool verwaltet werden sollen. Ändern Sie dieses Attribut nur, wenn Sie von Cloud Customer Care dazu aufgefordert werden.
user String Das SAP HANA-Datenbank-Nutzerkonto, das der Agent zum Abfragen von SAP HANA verwendet. Standardmäßig ist SYSTEM ausgewählt.
password String Das Passwort für das Datenbank-Nutzerkonto, das der Monitoring-Agent verwendet, um SAP HANA abzufragen. Geben Sie kein Passwort an, wenn Sie die Anmeldedaten für die Datenbanknutzer mit Secret Manager speichern.
secret_name String Wenn Sie die Anmeldedaten von Datenbanknutzern mit Secret Manager speichern, geben Sie den Namen des Secrets an, das die Sicherheitsanmeldedaten enthält.
enable_ssl Boolesch Gibt an, ob SSL oder TSL in SAP HANA aktiviert ist. Gültige Werte sind true und false.
validate_certificate Boolesch Gibt an, ob der Agent das Zertifikat des Servers prüft. Gültige Werte sind true und false.
host_name_in_certificate Gibt den SAP HANA-Hostnamen an, der im Zertifikat enthalten ist. Dieses Attribut ist erforderlich, wenn der Monitoring-Agent für SAP HANA auf derselben Host-VM wie SAP HANA ausgeführt wird und die SAP HANA-Host-VM localhost anstelle des tatsächlichen Hostnamens verwendet, um die Verbindung zwischen dem Agent und der Host-VM herzustellen.
key_store Gibt den Pfad zu einem Java-Schlüsselspeicher von JKS oder PKCS12 an. Wenn dieses Attribut nicht angegeben ist, verwendet der Monitoring-Agent für SAP HANA den JVM-Standard.

Wenn der Schlüsselspeicher passwortgeschützt ist, muss entweder key_store_password oder key_store_secret_name angegeben werden.

key_store_password Wenn ein Schlüsselspeicher passwortgeschützt ist, geben Sie ein Nur-Text-Passwort für den Schlüsselspeicher an. Die Spezifikation von key_store_password schließt sich mit der Spezifikation von key_store_secret_name aus.
key_store_secret_name Wenn ein Schlüsselspeicher passwortgeschützt ist, geben Sie den Namen eines Secrets im Secret Manager an, das das Passwort für den Schlüsselspeicher enthält. Die Spezifikation von key_store_secret_name schließt sich mit der Spezifikation von key_store_password aus.
trust_store Gibt den Pfad zur Truststore-JKS-Datei an, die die öffentlichen Zertifikate des SAP HANA-Servers enthält. Normalerweise enthält der Truststore das Root-Zertifikat oder das Zertifikat der Zertifizierungsstelle, die das Zertifikat des SAP HANA-Servers signiert hat. Wenn trust_store nicht angegeben wird, verwendet der Agent den standardmäßigen Truststore der JVM.
trust_store_password Wenn ein Truststore passwortgeschützt ist, geben Sie ein Nur-Text-Passwort für den Truststore an. Die Spezifikation von trust_store_password schließt sich mit der Spezifikation von trust_store_secret_name aus.
trust_store_secret_name Wenn ein Truststore passwortgeschützt ist, geben Sie den Namen eines Secrets im Secret Manager an, das das Passwort für den Truststore enthält. Die Spezifikation von trust_store_secret_name schließt sich mit der Spezifikation von trust_store_password aus.

Agent aktivieren

Nachdem der Monitoring-Agent für SAP HANA konfiguriert wurde, aber bevor Sie ihn starten, aktivieren Sie den Agent als systemd-Dienst, damit der Dienst bei jedem Neustart der VM-Instanz neu gestartet wird.

So aktivieren Sie den Agent:

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

  2. Führen Sie dazu folgenden Befehl aus:

    sudo systemctl enable google-saphanamonitoring-agent

    Die Ausgabe sollte in etwa wie im folgenden Beispiel aussehen:

    Created symlink /etc/systemd/system/multi-user.target.wants/google-saphanamonitoring-agent.service → /usr/sap/google-saphanamonitoring-agent/service/google-saphanamonitoring-agent.service.
    Created symlink /etc/systemd/system/google-saphanamonitoring-agent.service → /usr/sap/google-saphanamonitoring-agent/service/google-saphanamonitoring-agent.service.
    

Agent starten

So starten Sie den Agent:

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

  2. Führen Sie dazu folgenden Befehl aus:

    sudo systemctl start google-saphanamonitoring-agent
  3. Überprüfen Sie den Status des Agents:

    sudo systemctl status google-saphanamonitoring-agent

Wenn der Start erfolgreich ist, beginnt der Agent nach einigen Sekunden mit der Abfrage von SAP HANA und sendet die Messwerte an Monitoring.

Informationen zum Aufrufen Ihrer Messwerte in Monitoring finden Sie unter Benutzerdefiniertes Dashboard zum Anzeigen Ihrer Messwerte installieren.

Logs prüfen

So prüfen Sie die Logs:

tail -n 100 -f /var/log/google-saphanamonitoring-agent.log

Wenn der Agent gestartet wird, werden die Startereignisse in den Logs aufgezeichnet. Start, Planung von Abfragen und das Senden der Messwerte an Monitoring werden in den Logs aufgezeichnet.

Das folgende Beispiel zeigt die Startlogs und die Logeinträge für die erste erfolgreiche Abfrage an SAP HANA.

2021-04-26T20:42:53.392UTC [INFO] ******  Starting Google SAP HANA Custom Metrics Agent ******
2021-04-26T20:42:53.413UTC [INFO] Controller initializing...
2021-04-26T20:42:53.414UTC [INFO] Configuring dependencies...
2021-04-26T20:42:53.677UTC [INFO] Configuration of dependencies complete.
2021-04-26T20:42:53.678UTC [INFO] Configuration loading...
2021-04-26T20:42:53.704UTC [INFO] Loading system level metric definitions...
2021-04-26T20:42:53.767UTC [INFO] Loading conf/configuration.yaml...
2021-04-26T20:42:53.836UTC [INFO] Default Cloud Properties: projectId=example-project-id, instanceId=8254335046206112691, zone=us-central1-f
2021-04-26T20:42:53.843UTC [INFO] No "cloud_properties" field found in the config file, so using default cloud properties.
2021-04-26T20:42:53.850UTC [INFO] Configuration loaded and validated.
2021-04-26T20:42:53.865UTC [INFO] Configuration load complete.
2021-04-26T20:42:53.865UTC [INFO] Controller initialization complete
2021-04-26T20:42:53.865UTC [INFO] Starting sampling of HANA metrics...
2021-04-26T20:42:53.875UTC [INFO] Creating connection pool of size 10 for SAP HANA instance "example-hana-vm"
2021-04-26T20:42:54.289UTC [INFO] The SAP HANA agent has completed initial setup. Metrics will start being sent to Cloud Monitoring in 30 seconds.
2021-04-26T20:43:24.278UTC [INFO] Writing time series data to Cloud Monitoring
2021-04-26T20:43:24.281UTC [INFO] Writing time series data to Cloud Monitoring
2021-04-26T20:43:24.292UTC [INFO] Writing time series data to Cloud Monitoring
2021-04-26T20:43:24.292UTC [INFO] Writing time series data to Cloud Monitoring
2021-04-26T20:43:24.294UTC [INFO] Writing time series data to Cloud Monitoring
2021-04-26T20:43:24.295UTC [INFO] Writing time series data to Cloud Monitoring
2021-04-26T20:43:24.295UTC [INFO] Scheduling another execution for query "replication_query" and instance "example-hana-vm" in 300 seconds

Agent anhalten

Wenn Sie eine benutzerdefinierte Abfrage hinzufügen oder die Konfiguration des Agents anderweitig ändern, müssen Sie den Agent beenden und starten, bevor die neue Abfrage oder andere Konfigurationsänderungen wirksam werden.

  1. Beenden Sie den Agent:

    sudo systemctl stop google-saphanamonitoring-agent
  2. Starten Sie den Agent neu:

    sudo systemctl start google-saphanamonitoring-agent

Benutzerdefiniertes Dashboard installieren, um Messwerte aufzurufen

So installieren Sie das benutzerdefinierte SAP HANA-Dashboard aus dem GitHub-Repository in Monitoring:

  1. Cloud Shell öffnen

    Zu Cloud Shell

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

    git clone https://github.com/GoogleCloudPlatform/monitoring-dashboard-samples.git
  3. Installieren Sie in Cloud Shell das SAP HANA-Dashboard performance.json:

    gcloud monitoring dashboards create \
    --config-from-file=monitoring-dashboard-samples/dashboards/sap-hana/performance.json

Das Dashboard „SAP HANA Performance” wird den verfügbaren Dashboards in Ihrem Google Cloud-Projekt hinzugefügt. Folgen Sie der Anleitung unter Installiertes Dashboard ansehen, um Ihr Dashboard anzeigen zu lassen.

Weitere Informationen finden Sie unter:

Das installierte Dashboard anzeigen

Die Datei performance.json im Repository erstellt ein neues benutzerdefiniertes Dashboard mit dem Titel „SAP HANA-Leistung“.

  1. Wählen Sie in der Google Cloud Console Monitoring aus oder klicken Sie auf die folgende Schaltfläche:

    Zu Monitoring

  2. Klicken Sie im Navigationsbereich von Monitoring auf Dashboards.

  3. Klicken Sie in der Liste auf SAP HANA Performance. 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 unter Benutzerdefinierte Dashboards anzeigen.

Die folgende Abbildung zeigt einen Teil des benutzerdefinierten Dashboards für SAP HANA in Monitoring.

Screenshot zeigt die beiden obersten Diagrammen des benutzerdefinierten SAP HANA-Leistungs-Dashboards in Monitoring.

Monitoring-Agent für SAP HANA aktualisieren

Um sicherzustellen, dass Sie die neueste Version des Monitoring-Agents für SAP HANA verwenden, sollten Sie regelmäßig nach Updates suchen. Updates werden auf der Seite "Versionshinweise" von SAP in Google Cloud angekündigt.

Nach Updates suchen

Wählen Sie Ihr Betriebssystem aus:

RHEL

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

  2. Führen Sie dazu folgenden Befehl aus:

    sudo yum check-update google-saphanamonitoring-agent

SLES

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

  2. Führen Sie dazu folgenden Befehl aus:

    sudo zypper list-updates -r google-saphanamonitoring-agent

Update installieren

Wählen Sie Ihr Betriebssystem aus:

RHEL

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

  2. Führen Sie dazu folgenden Befehl aus:

    sudo yum update google-saphanamonitoring-agent

SLES

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

  2. Führen Sie dazu folgenden Befehl aus:

    sudo zypper --no-gpg-checks update google-saphanamonitoring-agent

Fehlerbehebung

In den folgenden Abschnitten werden Schritte beschrieben, die Sie ausführen können, wenn Probleme mit der Installation, Abfragen oder dem Senden von Messwerten an Monitoring auftreten.

Installation schlägt fehl

Vergewissern Sie sich, dass Sie ein Betriebssystem verwenden, das vom Monitoring-Agent für SAP HANA unterstützt wird. Weitere Informationen finden Sie unter Unterstützte Betriebssysteme.

Suchen Sie in der Shell, die Sie zur Installation des Agents verwendet haben, nach Fehlermeldungen.

Bestätigen Sie, dass das Google Cloud-RPM-Repository für den Agent der Liste der Repositories des Betriebssystems hinzugefügt wurde, wie unter Hinzufügen des Google Cloud-RPM-Repositorys zur Betriebssystem-Repository-Liste beschrieben.

Standardabfragen schlagen fehl

Prüfen Sie auf der Host-VM, ob die Logdatei /var/log/google-saphanamonitoring-agent.log Fehlermeldungen enthält.

Bestätigen Sie auf der Host-VM, dass im Attribut port jeder SAP HANA-Instanzdefinition in der Datei configuration.yaml der richtige Port angegeben ist. Informationen zu SAP-Ports für SAP HANA-SQL-Abfragen finden Sie unter TCP/IP-Ports aller SAP-Produkte.

Prüfen Sie, ob Ihr SAP HANA-Datenbanknutzer auf die folgenden SAP HANA-Systemansichten Zugriff hat:

  • M_CONNECTIONS
  • M_CS_ALL_COLUMNS
  • M_CS_TABLES
  • M_HOST_RESOURCE_UTILIZATION
  • M_RS_TABLES
  • M_SERVICE_COMPONENT_MEMORY
  • M_SERVICE_MEMORY
  • M_SERVICE_REPLICATION
  • M_WORKLOAD
  • Ansicht STATISTICS_CURRENT_ALERTS des Schemas _SYS_STATISTICS

Messwerte werden nicht an Monitoring gesendet

Prüfen Sie auf der Host-VM, ob die Logdatei /var/log/google-saphanamonitoring-agent.log Fehlermeldungen enthält.

Wenn der Agent nicht das Dienstkonto einer Host-VM verwendet, prüfen Sie, ob der Pfad zum JSON-Dienstkontoschlüssel richtig im Attribut service_account_json in der Datei configuration.yaml angegeben ist.

Auf der Startseite "IAM & Verwaltung" muss das vom Agent verwendete Dienstkonto die Rolle Monitoring Metric Writer (roles/monitoring.metricWriter) haben. Weitere Informationen finden Sie unter Erforderliche IAM-Rollen festlegen.

Support für den Monitoring-Agent für SAP HANA erhalten

Wenn Sie Hilfe bei der Behebung eines Problems mit dem Monitoring-Agent für SAP HANA benötigen, erfassen Sie die erforderlichen Diagnoseinformationen und wenden Sie sich an Cloud Customer Care. Weitere Informationen finden Sie unter Diagnoseinformationen zum Monitoring-Agent für SAP HANA.

Support

Wenden Sie sich bei Problemen mit der Infrastruktur oder den Diensten von Google Cloud an Customer Care. Kontaktdaten finden Sie in der Google Cloud Console auf der Seite Supportübersicht. Wenn Customer Care feststellt, dass sich um ein Problem Ihres SAP-Systems handelt, werden Sie an den SAP-Support verwiesen.

Reichen Sie bei Problemen in Zusammenhang mit SAP-Produkten Ihre Supportanfrage beim SAP-Support ein. SAP wertet das Support-Ticket aus und leitet es, wenn es sich um ein Problem mit der Google Cloud-Infrastruktur handelt, gegebenenfalls an die entsprechende Google Cloud-Komponente in seinem System weiter: BC-OP-LNX-GOOGLE oder BC-OP-NT-GOOGLE.

Supportanforderungen

Bevor Sie Support für SAP-Systeme sowie für die Infrastruktur und Dienste von Google Cloud erhalten können, müssen Sie die Mindestanforderungen für den Supportplan erfüllen.

Weitere Informationen zu den Mindestsupportanforderungen für SAP in Google Cloud finden Sie hier:

Nächste Schritte