SAP HANA

Mit Sammlungen den Überblick behalten Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.

Die SAP HANA-Integration erfasst SAP HANA-Messwerte und -Logs. Die Messwerte werden durch Abfragen relevanter Monitoringansichten erfasst. Diese Integration schreibt strukturierte Trace-Logs.

Weitere Informationen zu HANA finden Sie in der Dokumentation zu SAP HANA.

Vorbereitung

Sie müssen die Ops-Agent-Version 2.18.1 oder höher installieren, um HANA-Telemetrie zu erfassen.

Diese Integration unterstützt HANA Version 2.0.

HANA-Instanz konfigurieren

Zum Erfassen von Messwerten benötigt ein Monitoring-Nutzer SELECT-Zugriff auf die relevanten Monitoring-Ansichten. Das folgende SQL-Skript erstellt eine Monitoring-Rolle und wendet sie auf einen Monitoring-Nutzer an, wenn es von einem Nutzer mit ausreichenden Berechtigungen für die SAP HANA-Instanz ausgeführt wird.

--Create the user
CREATE RESTRICTED USER otel_monitoring_user PASSWORD ;
--Enable user login
ALTER USER otel_monitoring_user ENABLE CLIENT CONNECT;
--Create the monitoring role
CREATE ROLE OTEL_MONITORING;
--Grant permissions to the relevant views
GRANT CATALOG READ TO OTEL_MONITORING;
GRANT SELECT ON SYS.M_BACKUP_CATALOG TO OTEL_MONITORING;
GRANT SELECT ON SYS.M_BLOCKED_TRANSACTIONS TO OTEL_MONITORING;
GRANT SELECT ON SYS.M_CONNECTIONS TO OTEL_MONITORING;
GRANT SELECT ON SYS.M_CS_ALL_COLUMNS TO OTEL_MONITORING;
GRANT SELECT ON SYS.M_CS_TABLES TO OTEL_MONITORING;
GRANT SELECT ON SYS.M_DATABASE TO OTEL_MONITORING;
GRANT SELECT ON SYS.M_DISKS TO OTEL_MONITORING;
GRANT SELECT ON SYS.M_HOST_RESOURCE_UTILIZATION TO OTEL_MONITORING;
GRANT SELECT ON SYS.M_LICENSES TO OTEL_MONITORING;
GRANT SELECT ON SYS.M_RS_TABLES TO OTEL_MONITORING;
GRANT SELECT ON SYS.M_SERVICE_COMPONENT_MEMORY TO OTEL_MONITORING;
GRANT SELECT ON SYS.M_SERVICE_MEMORY TO OTEL_MONITORING;
GRANT SELECT ON SYS.M_SERVICE_REPLICATION TO OTEL_MONITORING;
GRANT SELECT ON SYS.M_SERVICE_STATISTICS TO OTEL_MONITORING;
GRANT SELECT ON SYS.M_SERVICE_THREADS TO OTEL_MONITORING;
GRANT SELECT ON SYS.M_SERVICES TO OTEL_MONITORING;
GRANT SELECT ON SYS.M_VOLUME_IO_TOTAL_STATISTICS TO OTEL_MONITORING;
GRANT SELECT ON SYS.M_WORKLOAD TO OTEL_MONITORING;
GRANT SELECT ON _SYS_STATISTICS.STATISTICS_CURRENT_ALERTS TO OTEL_MONITORING;
--Add the OTEL_MONITOR role to the monitoring user
GRANT OTEL_MONITORING TO otel_monitoring_user;

Ops-Agent für HANA konfigurieren

Fügen Sie die erforderlichen Elemente zum Erfassen von Telemetriedaten aus den HANA-Instanzen gemäß der Anleitung unter Ops-Agent konfigurieren hinzu und starten Sie den Agent neu.

Konfigurationsbeispiel

Der folgende Befehl erstellt die Konfiguration zum Erfassen und Aufnehmen von Telemetriedaten für HANA und startet den Ops-Agent neu.

# Configures Ops Agent to collect telemetry from the app and restart Ops Agent.

set -e

sudo tee /etc/google-cloud-ops-agent/config.yaml > /dev/null << EOF
logging:
  receivers:
    saphana:
      type: saphana
      include_paths:
      - /usr/sap/*/HDB*/saphanamon/trace/*.trc
      exclude_paths:
      - /usr/sap/*/HDB*/saphanamon/trace/nameserver_history*.trc
      - /usr/sap/*/HDB*/saphanamon/trace/nameserver*loads*.trc
      - /usr/sap/*/HDB*/saphanamon/trace/nameserver*executed_statements*.trc
  service:
    pipelines:
      saphana:
        receivers:
          - saphana
metrics:
  receivers:
    saphana:
      type: saphana
      username: SYSTEM
      password: G00g3l21
      endpoint: localhost:30015
  service:
    pipelines:
      saphana:
        receivers:
          - saphana
EOF

sudo service google-cloud-ops-agent restart

Logerfassung konfigurieren

Um Logs von HANA aufzunehmen, müssen Sie Empfänger für die von HANA erzeugten Logs erstellen und dann eine Pipeline für die neuen Empfänger erstellen.

Geben Sie die folgenden Felder an, um einen Empfänger für Ihre saphana-Logs zu konfigurieren:

Feld Standard Beschreibung
exclude_paths [/usr/sap/*/HDB*/${HOSTNAME}/trace/nameserver_history*.trc, /usr/sap/*/HDB*/${HOSTNAME}/trace/nameserver*loads*.trc, /usr/sap/*/HDB*/${HOSTNAME}/trace/nameserver*executed_statements*.trc] Eine Liste von Dateisystempfadmustern, die aus dem mit include_paths übereinstimmenden Satz ausgeschlossen werden sollen.
include_paths [/usr/sap/*/HDB*/${HOSTNAME}/trace/*.trc] Eine Liste mit Dateisystempfaden, die durch Tailing jeder Datei gelesen werden sollen. In den Pfaden kann ein Platzhalter (*) verwendet werden.
record_log_file_path false Wenn true festgelegt ist, wird der Pfad zu der spezifischen Datei, aus der der Logdatensatz abgerufen wurde, im Ausgabelogeintrag als Wert des Labels agent.googleapis.com/log_file_path angezeigt. Bei Verwendung eines Platzhalters wird nur der Pfad der Datei aufgezeichnet, aus der der Eintrag abgerufen wurde.
type Der Wert muss saphana. lauten.
wildcard_refresh_interval 60s Das Intervall, in dem Platzhalterdateipfade in include_paths aktualisiert werden. Wird als Zeitdauer angegeben, z. B. 30s oder 2m. Dieses Attribut kann bei hohen Logging-Durchsätzen nützlich sein, wenn Logdateien schneller als das Standardintervall rotiert werden.

Was wird protokolliert?

Der logName wird von den Empfänger-IDs abgeleitet, die in der Konfiguration angegeben sind. Detaillierte Felder in LogEntry sind:

saphana-Logs enthalten die folgenden Felder in LogEntry:

Feld Typ Beschreibung
jsonPayload.component String SAP HANA-Komponente
jsonPayload.thread_id number ID des Threads, der die Nachricht protokolliert
jsonPayload.connection_id number ID der Verbindung, aus der die Nachricht stammt, wenn die Nachricht im Bereich einer Verbindung protokolliert wurde
jsonPayload.transaction_id number ID der Transaktion, von der die Nachricht stammt, wenn die Nachricht im Bereich einer Transaktion protokolliert wurde
jsonPayload.update_transaction_id number ID der Aktualisierungstransaktion, von der die Nachricht stammt, wenn die Nachricht im Bereich einer Aktualisierungstransaktion protokolliert wurde
jsonPayload.message String Log-Nachricht
sourceLocation.file String Name der Quelldatei
sourceLocation.line number Zeile in der Quelldatei

Messwerterfassung konfigurieren

Um Messwerte von HANA aufzunehmen, müssen Sie Empfänger für die von HANA erzeugten Messwerte erstellen und dann eine Pipeline für die neuen Empfänger erstellen.

Um einen Empfänger für Ihre saphana-Messwerte zu konfigurieren, geben Sie die folgenden Felder an:

Feld Standard Beschreibung
ca_file Pfad zum CA-Zertifikat. Als Client wird dadurch das Serverzertifikat verifiziert. Wenn leer, verwendet der Empfänger die System-Stammzertifizierungsstelle.
cert_file Pfad zum TLS-Zertifikat, das für TLS-fähige Verbindungen verwendet werden soll.
collection_interval 60s Ein Wert für time.Duration, wie z. B. 30s oder 5m.
endpoint localhost:30015 Der Hostname:Port, mit dem die Verbindung zur saphana-Instanz hergestellt wird.
insecure true Legt fest, ob eine sichere TLS-Verbindung verwendet werden soll. Wenn „false“ festgelegt ist, ist TLS aktiviert.
insecure_skip_verify false Legt fest, ob die Bestätigung des Zertifikats übersprungen werden soll. Wenn insecure auf true gesetzt ist, wird der insecure_skip_verify value nicht verwendet.
key_file Pfad zum TLS-Schlüssel, der für TLS-erforderliche Verbindungen verwendet werden soll.
password Das Passwort für die Verbindung mit der Instanz.
type Dieser Wert muss saphana sein.
username Der Nutzername für die Verbindung mit der Instanz.

Was wird überwacht?

Die folgende Tabelle enthält die Liste der Messwerte, die der Ops-Agent aus der HANA-Instanz erfasst.

Messwerttyp
Art, Typ
Überwachte Ressourcen
Label
workload.googleapis.com/saphana.alert.count
GAUGEINT64
gce_instance
rating
workload.googleapis.com/saphana.backup.latest
GAUGEINT64
gce_instance
 
workload.googleapis.com/saphana.column.memory.used
GAUGEINT64
gce_instance
host
subtype
type
workload.googleapis.com/saphana.component.memory.used
GAUGEINT64
gce_instance
component
host
workload.googleapis.com/saphana.connection.count
GAUGEINT64
gce_instance
host
status
workload.googleapis.com/saphana.cpu.used
CUMULATIVEINT64
gce_instance
host
type
workload.googleapis.com/saphana.disk.size.current
GAUGEINT64
gce_instance
host
path
state
usage_type
workload.googleapis.com/saphana.host.memory.current
GAUGEINT64
gce_instance
host
state
workload.googleapis.com/saphana.host.swap.current
GAUGEINT64
gce_instance
host
state
workload.googleapis.com/saphana.instance.code_size
GAUGEINT64
gce_instance
host
workload.googleapis.com/saphana.instance.memory.current
GAUGEINT64
gce_instance
host
state
workload.googleapis.com/saphana.instance.memory.shared.allocated
GAUGEINT64
gce_instance
host
workload.googleapis.com/saphana.instance.memory.used.peak
GAUGEINT64
gce_instance
host
workload.googleapis.com/saphana.license.expiration.time
GAUGEINT64
gce_instance
product
system
workload.googleapis.com/saphana.license.limit
GAUGEINT64
gce_instance
product
system
workload.googleapis.com/saphana.license.peak
GAUGEINT64
gce_instance
product
system
workload.googleapis.com/saphana.network.request.average_time
GAUGEDOUBLE
gce_instance
host
workload.googleapis.com/saphana.network.request.count
GAUGEINT64
gce_instance
host
state
workload.googleapis.com/saphana.network.request.finished.count
CUMULATIVEINT64
gce_instance
host
type
workload.googleapis.com/saphana.replication.average_time
GAUGEDOUBLE
gce_instance
mode
port
primary
secondary
workload.googleapis.com/saphana.replication.backlog.size
GAUGEINT64
gce_instance
mode
port
primary
secondary
workload.googleapis.com/saphana.replication.backlog.time
GAUGEINT64
gce_instance
mode
port
primary
secondary
workload.googleapis.com/saphana.row_store.memory.used
GAUGEINT64
gce_instance
host
type
workload.googleapis.com/saphana.schema.memory.used.current
GAUGEINT64
gce_instance
host
schema
type
workload.googleapis.com/saphana.schema.memory.used.max
GAUGEINT64
gce_instance
host
schema
workload.googleapis.com/saphana.schema.operation.count
CUMULATIVEINT64
gce_instance
host
schema
type
workload.googleapis.com/saphana.schema.record.compressed.count
GAUGEINT64
gce_instance
host
schema
workload.googleapis.com/saphana.schema.record.count
GAUGEINT64
gce_instance
host
schema
type
workload.googleapis.com/saphana.service.code_size
GAUGEINT64
gce_instance
host
service
workload.googleapis.com/saphana.service.count
GAUGEINT64
gce_instance
host
status
workload.googleapis.com/saphana.service.memory.compactors.allocated
GAUGEINT64
gce_instance
host
service
workload.googleapis.com/saphana.service.memory.compactors.freeable
GAUGEINT64
gce_instance
host
service
workload.googleapis.com/saphana.service.memory.effective_limit
GAUGEINT64
gce_instance
host
service
workload.googleapis.com/saphana.service.memory.heap.current
GAUGEINT64
gce_instance
host
service
state
workload.googleapis.com/saphana.service.memory.limit
GAUGEINT64
gce_instance
host
service
workload.googleapis.com/saphana.service.memory.shared.current
GAUGEINT64
gce_instance
host
service
state
workload.googleapis.com/saphana.service.memory.used
GAUGEINT64
gce_instance
host
service
type
workload.googleapis.com/saphana.service.stack_size
GAUGEINT64
gce_instance
host
service
workload.googleapis.com/saphana.service.thread.count
GAUGEINT64
gce_instance
host
status
workload.googleapis.com/saphana.transaction.blocked
GAUGEINT64
gce_instance
host
workload.googleapis.com/saphana.transaction.count
CUMULATIVEINT64
gce_instance
host
type
workload.googleapis.com/saphana.volume.operation.count
CUMULATIVEINT64
gce_instance
host
path
type
usage_type
workload.googleapis.com/saphana.volume.operation.size
CUMULATIVEINT64
gce_instance
host
path
type
usage_type
workload.googleapis.com/saphana.volume.operation.time
CUMULATIVEINT64
gce_instance
host
path
type
usage_type

Beispieldashboard

Damit Sie Ihre HANA-Messwerte aufrufen können, müssen Sie ein Diagramm oder ein Dashboard konfiguriert haben. Cloud Monitoring bietet eine Bibliothek mit Beispiel-Dashboards für Integrationen, die vorkonfigurierte Diagramme enthalten. Informationen zum Installieren dieser Dashboards finden Sie unter Beispiel-Dashboards installieren.

Konfiguration prüfen

In diesem Abschnitt wird beschrieben, wie Sie prüfen können, ob Sie den HANA-Empfänger richtig konfiguriert haben. Es kann ein oder zwei Minuten dauern, bis der Ops-Agent Telemetriedaten erfasst.

Um zu prüfen, ob die Logs aufgenommen wurden, rufen Sie den Log-Explorer auf. Führen Sie dann die folgende Abfrage aus, um die HANA-Logs aufzurufen:

resource.type="gce_instance"
log_id("saphana")

Um zu prüfen, ob die Messwerte aufgenommen wurden, rufen Sie den Metrics Explorer auf und führen Sie die folgende Abfrage auf dem Tab MQL aus:

fetch gce_instance
| metric 'workload.googleapis.com/saphana.connection.count'
| every 1m

Nächste Schritte

Eine Anleitung zur Installation von Ops-Agent mit Ansible zum Konfigurieren einer Drittanbieteranwendung und zum Installieren eines Beispieldashboards finden Sie im Video Ops-Agent installieren, um Fehler in Drittanbieteranwendungen zu beheben.