In diesem Leitfaden erfahren Sie, wie Sie Version 2 des Google Cloud-Agents 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:
Öffnen Sie in der Google Cloud Console die Seite IAM.
Wählen Sie Ihr Google Cloud-Projekt aus.
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 .
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
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:
Stellen Sie eine SSH-Verbindung zu Ihrer Compute Engine-VM-Instanz oder dem Bare-Metal-Lösungsserver her.
Öffnen Sie die Konfigurationsdatei des Agents.
/etc/google-cloud-sap-agent/configuration.json
Führen Sie im Abschnitt
hana_monitoring_configuration
folgende Schritte aus:- Legen Sie für den Parameter
enabled
den Werttrue
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.
- Legen Sie für den Parameter
Optional können Sie im Abschnitt
cloud_properties
die automatisch festgelegten Parameterwerte aktualisieren. Fügen Sie dazu den Abschnittcloud_properties
zur Konfigurationsdatei hinzu und geben Sie die erforderlichen Parameter und deren Werte an.Speichern Sie die Konfigurationsdatei.
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 SAP HANA-Monitoring-Messwerten aktiviert ist. Beachten Sie, dass die in diesem Beispiel enthaltene benutzerdefinierte Abfragecustom_query
den Definitionsrichtlinien für benutzerdefinierte Abfragen entspricht, die unter Benutzerdefinierte Abfragen definieren angegeben sind.
{ "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", "hdbuserstore_key": "user_store_key" }, { "name": "remote", "sid": "DEH", "host": "10.123.0.12", "port": "30015", "user": "system", "secret_name": "password-secret-name", "hdbuserstore_key": "user_store_key" } ], "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 } ] } }
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 SAP HANA-Monitoring-Messwerten aktiviert ist. Beachten Sie, dass die in diesem Beispiel enthaltene benutzerdefinierte Abfragecustom_query
den Definitionsrichtlinien für benutzerdefinierte Abfragen entspricht, die unter Benutzerdefinierte Abfragen definieren angegeben sind.
{ "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", "hdbuserstore_key": "user_store_key" }, { "name": "remote", "sid": "DEH", "host": "10.123.0.12", "port": "30015", "user": "system", "secret_name": "password-secret-name", "hdbuserstore_key": "user_store_key" } ], "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:
Stellen Sie eine SSH-Verbindung zu Ihrer Compute Engine-VM-Instanz oder dem Bare-Metal-Lösungsserver her.
Öffnen Sie die Konfigurationsdatei des Agents.
/etc/google-cloud-sap-agent/configuration.json
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.
Zum Aktivieren einer benutzerdefinierten Abfrage setzen Sie den Parameter
enabled
auftrue
.Speichern Sie die Konfigurationsdatei.
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:
Stellen Sie eine SSH-Verbindung zu Ihrer Compute Engine-VM-Instanz oder dem Bare-Metal-Lösungsserver her.
Öffnen Sie die Konfigurationsdatei des Agents.
/etc/google-cloud-sap-agent/configuration.json
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.Wenn Sie eine benutzerdefinierte Abfrage deaktivieren möchten, setzen Sie den Parameter
enabled
für diese benutzerdefinierte Abfrage auffalse
.Speichern Sie die Konfigurationsdatei.
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.
Parameter | |
---|---|
provide_sap_host_agent_metrics |
Geben Sie |
bare_metal |
Wenn der Agent auf einem Bare-Metal-Lösungsserver installiert ist, geben Sie |
log_level |
Legen Sie den erforderlichen Wert fest, um die Logging-Ebene des Agents festzulegen. Folgende Logebenen sind verfügbar:
Standardwert ist |
log_to_cloud |
Geben Sie |
sap_system_discovery |
Geben Sie |
cloud_properties.project_id |
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. |
cloud_properties.instance_name
|
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. Geben Sie in Agent-Version 2.5 oder früher den Servernamen der Bare-Metal-Lösung für das Attribut |
cloud_properties.region |
Wenn Ihr SAP-System auf einem Bare-Metal-Lösungsserver ausgeführt wird, geben Sie die Region des Bare-Metal-Lösungsservers an. |
cloud_properties.zone |
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 |
Geben Sie den Namen des Betriebssystem-Images der Instanz an. |
cloud_properties.numeric_project_id |
Die numerische ID des Google Cloud-Projekts, in dem das SAP-System ausgeführt wird. |
hana_monitoring_configuration.enabled |
Optional. Geben Sie hana_monitoring_configuration.enabled: true angeben.
|
hana_monitoring_configuration.sample_interval_sec |
Optional. Geben Sie das Abtastintervall in Sekunden an, das die Häufigkeit bestimmt, mit der der Google Cloud-Agent für SAP Ihre SAP HANA-Instanzen abfragt, um die SAP HANA-Monitoring-Messwerte zu erfassen. Der Standardwert beträgt 300 Sekunden. Für jede in der Konfigurationsdatei des Google Cloud-Agents für SAP definierte Abfrage können Sie das globale Abtastintervall überschreiben. Geben Sie dazu das erforderliche Intervall für den Parameter |
hana_monitoring_configuration.query_timeout_sec |
Optional. Geben Sie das Zeitlimit für jede Abfrage an die SAP HANA-Instanzen an. Der Standardwert beträgt 300 Sekunden. |
hana_monitoring_configuration.execution_threads |
Optional. Geben Sie die Anzahl der Threads an, die zum Senden von Abfragen an die SAP HANA-Instanzen verwendet werden. Jede Abfrage wird in einem eigenen Thread ausgeführt. Der Standardwert ist 10. |
hana_monitoring_configuration.hana_instances.name |
Geben Sie die Namenskennzeichnung für Ihre SAP HANA-Instanz an. |
hana_monitoring_configuration.hana_instances.sid |
Geben Sie die SID Ihrer SAP HANA-Instanz an. Dieser String wird allen Messwerten, die sich aus der Abfrage Ihrer SAP HANA-Instanzen ergeben, als Label hinzugefügt. |
hana_monitoring_configuration.hana_instances.host |
Geben Sie die Kennzeichnung der Maschine an, entweder lokal oder remote, die Ihre SAP HANA-Instanz hostet. Folgende Werte werden unterstützt:
|
hana_monitoring_configuration.hana_instances.port |
Geben Sie den Port an, über den die SAP HANA-Instanz Abfragen akzeptiert. Bei der ersten oder einzigen Mandantendatenbankinstanz ist der Port |
hana_monitoring_configuration.hana_instances.user |
Geben Sie das Nutzerkonto an, das zum Abfragen der SAP HANA-Instanz verwendet wird. |
hana_monitoring_configuration.hana_instances.password |
Optional. Geben Sie das Passwort (als Nur-Text) an, mit dem das Nutzerkonto für die Abfrage der SAP HANA-Instanz authentifiziert wird. Für die Authentifizierung müssen Sie eine der folgenden Optionen angeben:
|
hana_monitoring_configuration.hana_instances.secret_name |
Optional. Geben Sie den Namen des Secrets im Secret Manager an, in dem das Passwort des Nutzerkontos gespeichert ist. |
hana_monitoring_configuration.hana_instances.hdbuserstore_key
|
Wenn Sie eine sichere Verbindung zu einem SAP HANA-System herstellen möchten, geben Sie den Schlüssel Secure Nutzerspeicher ( Prüfen Sie Folgendes, um einen
Wenn Sie |
hana_monitoring_configuration.hana_instances.enable_ssl |
Optional. Gibt an, ob SSL in Ihrer SAP HANA-Instanz aktiviert ist. Der Standardwert ist |
hana_monitoring_configuration.hana_instances.host_name_in_certificate |
Wenn Sie für eine SAP HANA-Instanz |
hana_monitoring_configuration.hana_instances.tls_root_ca_file |
Wenn Sie für eine SAP HANA-Instanz |
hana_monitoring_configuration.queries.enabled |
Optional. Um eine SQL-Abfrage für alle Ihre SAP HANA-Instanzen zu aktivieren, geben Sie den Wert |
hana_monitoring_configuration.queries.name |
Wenn Sie in Ihrer Konfigurationsdatei benutzerdefinierte Abfragen definiert haben, müssen Sie für jede benutzerdefinierte Abfrage einen eindeutigen Namen angeben. Der Abfragename muss eindeutig sein, da er zum Erstellen der Standard-URL des Messwerts in Monitoring verwendet wird. |
hana_monitoring_configuration.queries.sql |
Geben Sie die SQL-Anweisung an, die der Agent an Ihre SAP HANA-Instanzen ausgibt. Die SQL-Anweisung muss der von SAP definierten SQL- und Systemansichten-Referenz zur SAP-Syntax entsprechen. |
hana_monitoring_configuration.queries.sample_interval_sec |
Optional. Geben Sie das Abtastintervall für die SQL-Abfrage an. Dadurch wird das globale Abtastintervall überschrieben. Der Wert muss mindestens 5 Sekunden lang sein. |
hana_monitoring_configuration.queries.columns.name |
Geben Sie einen Namen an, der jede Spalte eindeutig identifiziert. Der Spaltenname muss eindeutig sein, da er zum Erstellen der Standard-URL des Messwerts in Monitoring verwendet wird. |
hana_monitoring_configuration.queries.columns.metric_type |
Geben Sie für die Verarbeitung durch Monitoring einen der folgenden Messwerttypen an: Messwerte vom Typ |
hana_monitoring_configuration.queries.columns.value_type |
Geben Sie für die Verarbeitung durch Monitoring einen Datentyp an, der vom Messwerttyp unterstützt wird. Folgende Datentypen werden unterstützt: |
hana_monitoring_configuration.queries.columns.name_override |
Optional. Geben Sie für die Verarbeitung durch Monitoring den Pfad an, der in der Messwert-URL anstelle der Abfrage- und Spaltennamen angezeigt werden soll. Beispiel:
|
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:
Google Cloud Console
Rufen Sie in der Google Cloud Console die Seite Monitoring auf:
Klicken Sie im Navigationsbereich von Monitoring auf Dashboards.
Klicken Sie auf den Tab Beispielbibliothek.
Geben Sie im Feld Filter
Agent for SAP
ein, um die agent-spezifischen benutzerdefinierten Dashboards zu filtern.(Optional) Klicken Sie auf Vorschau, um Details zu einem Dashboard oder eine Vorschau des Inhalts anzuzeigen.
Wählen Sie das Dashboard aus, das Sie installieren möchten.
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
Cloud Shell öffnen
Klonen Sie in Cloud Shell das Repository oder laden Sie es herunter:
git clone https://github.com/GoogleCloudPlatform/monitoring-dashboard-samples/
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 Pfadmonitoring-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:
Rufen Sie in der Google Cloud Console die Seite Monitoring auf:
Klicken Sie im Navigationsbereich von Monitoring auf Dashboards.
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.