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:
Rufen Sie in der Google Cloud Console die Seite IAM unter „IAM und Verwaltung“ auf.
Wählen Sie Ihr Google Cloud-Projekt aus.
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
neben dem Dienstkonto, das Sie bearbeiten möchten.
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
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
Stellen Sie eine SSH-Verbindung zu Ihrer Host-VM her.
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
Stellen Sie eine SSH-Verbindung zu Ihrer Host-VM her.
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
Stellen Sie eine SSH-Verbindung zu Ihrer Host-VM her.
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
Stellen Sie eine SSH-Verbindung zu Ihrer Host-VM her.
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:
Stellen Sie eine SSH-Verbindung zu Ihrer Host-VM her.
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.
Öffnen Sie die Konfigurationsdatei zur Bearbeitung mit Ihrem bevorzugten Texteditor. Beispiel:
sudo vi /usr/sap/google-saphanamonitoring-agent/conf/configuration.yaml
Entfernen Sie optional unter
gcloud_authdas 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
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- namebistrust_store_secret_namekopieren. 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 vorqueriesein.So definieren Sie eine SAP HANA-Instanz:
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
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.
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
Geben Sie das SAP HANA-Nutzerkonto an, das der Agent zum Abfragen von SAP HANA verwenden soll. Standardmäßig ist das Nutzerkonto
SYSTEMangegeben:user: SYSTEM
Geben Sie das Passwort für das SAP HANA-Nutzerkonto an, das der Agent zum Abfragen von SAP HANA verwenden soll. Beispiel:
password: TempPa55word
Wenn das SAP HANA-System Transport Layer Secure (TLS)/Secure Sockets Layer (SSL) verwendet, aktivieren Sie die SSL-Unterstützung:
enable_ssl: true
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.
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 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 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 |
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 |
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:
Stellen Sie eine SSH-Verbindung zu Ihrer Host-VM her.
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:
Stellen Sie eine SSH-Verbindung zu Ihrer Host-VM her.
Führen Sie dazu folgenden Befehl aus:
sudo systemctl start google-saphanamonitoring-agent
Ü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.
Beenden Sie den Agent:
sudo systemctl stop google-saphanamonitoring-agent
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:
Cloud Shell öffnen
Klonen Sie in Cloud Shell das Repository oder laden Sie es herunter:
git clone https://github.com/GoogleCloudPlatform/monitoring-dashboard-samples.git
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“.
Wählen Sie in der Google Cloud Console Monitoring aus oder klicken Sie auf die folgende Schaltfläche:
Klicken Sie im Navigationsbereich von Monitoring auf Dashboards.
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.
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
Stellen Sie eine SSH-Verbindung zu Ihrer Host-VM her.
Führen Sie dazu folgenden Befehl aus:
sudo yum check-update google-saphanamonitoring-agent
SLES
Stellen Sie eine SSH-Verbindung zu Ihrer Host-VM her.
Führen Sie dazu folgenden Befehl aus:
sudo zypper list-updates -r google-saphanamonitoring-agent
Update installieren
Wählen Sie Ihr Betriebssystem aus:
RHEL
Stellen Sie eine SSH-Verbindung zu Ihrer Host-VM her.
Führen Sie dazu folgenden Befehl aus:
sudo yum update google-saphanamonitoring-agent
SLES
Stellen Sie eine SSH-Verbindung zu Ihrer Host-VM her.
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_CONNECTIONSM_CS_ALL_COLUMNSM_CS_TABLESM_HOST_RESOURCE_UTILIZATIONM_RS_TABLESM_SERVICE_COMPONENT_MEMORYM_SERVICE_MEMORYM_SERVICE_REPLICATIONM_WORKLOAD- Ansicht
STATISTICS_CURRENT_ALERTSdes 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:
- Support für SAP in Google Cloud
- SAP-Hinweis 2456406 – SAP auf der Google Cloud Platform: Support-Voraussetzungen (SAP-Nutzerkonto erforderlich)