Diagnoseinformationen zum Agent für SAP von Google Cloud

Stellen Sie dem Cloud Customer Care bei Problemen im Zusammenhang mit der Version 3.8 (aktuell) desGoogle Cloud-Agents für SAP so schnell wie möglich die folgenden Informationen zur Verfügung:

• Eine vollständige und detaillierte Beschreibung des Problems.
• Das Supportset für den Agent
• Die neuesten vom Agent erfassten Daten.
• Die Konfigurationsdatei für den Agent.
• Die Logdatei für den Agent.

Genaue Beschreibung des Problems

Geben Sie eine vollständige und detaillierte Beschreibung des Problems an, einschließlich der Version des Agents sowie Datum und Uhrzeit des Auftretens des Problems.

Führen Sie folgende Schritte aus, um die Version Ihres Agents zu prüfen:

Supportset

Das Supportset ist eine Sammlung von Informationen vom Agenten für SAP von Google Cloud, die den Kundenservice bei der Bereitstellung von Support unterstützt. Dieses Feature ist für den Agent für SAP Version 2.1 oder höher von Google Cloudverfügbar.

Ab Version 3.4 des Agents können Sie die Ausgabe des Befehls supportbundle mithilfe der Option result-bucket hochladen. Dazu muss das vom Agenten verwendete Dienstkonto die folgende IAM-Berechtigung haben: storage.objects.create.

Was im Support-Paket enthalten ist

• Protokoll- und Konfigurationsdateien des Agents

  Ab Version 3.0 des Agents gehören dazu auch die Logs und Konfigurationsdateien, die sich auf die Backint- und Laufwerk-Snapshot-Funktionen des Agents beziehen.

• SAP HANA-Traces und -Topologiedateien für den angegebenen Hostnamen und die SID.

• Konfigurationsdatei und Logs des Cloud Storage Backint-Agents für SAP HANA.

• Wenn Sie für einen Hochverfügbarkeitscluster (HA) unter RHEL pacemaker-diagnosis="true" angeben, wird die Ausgabe von sosreport im folgenden Verzeichnis gespeichert: /tmp/google-cloud-sap-agent/pacemaker-TIMESTAMP. Wenn die Ausführung des Befehls sosreport fehlschlägt, wird die Ausgabe von crm_report im angegebenen Verzeichnis gespeichert.

• Wenn Sie für einen HA-Cluster unter SUSE pacemaker-diagnosis=true angeben, wird die Ausgabe der Dienstprogramme hb_report und supportconfig im folgenden Verzeichnis gespeichert: /tmp/google-cloud-sap-agent/pacemaker-TIMESTAMP. Wenn die Ausführung dieser Dienstprogramme fehlschlägt, werden die Ausgabe von hb_report und crm_report im angegebenen Verzeichnis gespeichert.

• Die Datei /var/log/messages, die nützliche Informationen zu den Vorgängen Ihres Linux-Systems liefert.

• Ab Version 3.8 des Agents ist die Datei sapdiscovery.json standardmäßig enthalten. Die Datei enthält Informationen zu den SAP-Produkten und zugehörigen Komponenten, die auf der Compute-Instanz ausgeführt werden. Diese Informationen geben dem Kundenservice einen besseren Überblick über die Rolle und Konfiguration Ihres SAP-Systems.

  Damit der Kundenservicemitarbeiter diese Informationen erheben kann, müssen Sie die folgenden Anforderungen erfüllen:

  • Geben Sie "log_to_cloud": true in der Konfigurationsdatei des Agents an.
  • Erteilen Sie dem Dienstkonto, das der Kundenservicemitarbeiter verwendet, die IAM-Berechtigung logging.logEntries.list.

• Ab Version 3.8 des Agents enthält das Bundle, wenn Sie die Option metrics angeben, Informationen zu den Vorkommnissen von vordefinierten SAP-Ereignissen und zu den Änderungen der Werte des Messwerts für die Prozessüberwachung und des Messwerts für die SAP HANA-Überwachung für einen bestimmten Zeitraum.

  • Damit der Agent Informationen zu den Vorkommnissen von vordefinierten SAP-Ereignissen aus Cloud Logging-Protokollen erfassen kann, müssen die folgenden Anforderungen erfüllt sein:
    • Geben Sie "log_to_cloud": true in der Konfigurationsdatei des Agents an.
    • Erteilen Sie dem Dienstkonto, das der Kundenservicemitarbeiter verwendet, die IAM-Berechtigung logging.logEntries.list.
  • Damit der Kundenservicemitarbeiter Informationen zu Änderungen der Messwerte aus Cloud Monitoring abrufen kann, müssen die folgenden Anforderungen erfüllt sein:
    • Geben Sie "send_metrics_to_monitoring": true in der Konfigurationsdatei des Agents an.
    • Weisen Sie dem Dienstkonto, das der Kundenservicemitarbeiter verwendet, die folgenden IAM-Berechtigungen zu: monitoring.metricDescriptors.get, monitoring.metricDescriptors.list, monitoring.monitoredResourceDescriptors.get, monitoring.monitoredResourceDescriptors.list und monitoring.timeSeries.list.
  • Der Zeitraum, in dem der Agent die Cloud Logging-Logs und Cloud Monitoring-Einträge filtert, wird durch das Verhalten der folgenden Optionen bestimmt:
    • timestamp: Der Zeitstempel im Format YYYY-MM-DD HH:MM:SS, in dessen Nähe Sie Informationen zu Vorkommnissen der vordefinierten SAP-Ereignistypen und Änderungen an Messwerten erfassen möchten. Der Standardwert ist die Uhrzeit, zu der Sie den Befehl supportbundle ausführen.
    • before-duration: Die Anzahl der Sekunden vor timestamp, in denen der Agent nach Vordefinierten SAP-Ereignissen und Änderungen an Messwertwerten sucht. Der Standardwert beträgt 3.600 Sekunden.
    • after-duration: Die Anzahl der Sekunden nach timestamp, während der der Agent nach Vordefinierten SAP-Ereignissen und Änderungen an Messwerten sucht. Der Standardwert beträgt 1.800 Sekunden.

  • Die erfassten Informationen sind in Ordnern organisiert, die JSON-Dateien für jeden aufgetretenen SAP-Ereignistyp und jeden Messwert enthalten, dessen Wert sich geändert hat. Das folgende Beispiel zeigt, wie die Ausgabe aussieht:

    supportbundle/
    |--- process_metrics/
      |--- pm_sap_control_cpu_utilization.json
      |--- pm_sap_control_memory_utilization.json
    |--- hana_monitoring_metrics/
      |--- hm_sap_hanamonitoring_disk_readtime.json
      |--- hm_sap_hanamonitoring_disk_writetime.json
    |--- sap_events/
      |--- se_HA_Availability.json
      |--- se_HA_Replication.json

Support-Set generieren

Führen Sie den folgenden Befehl auf Ihrer Compute-Instanz aus, um ein Support-Bundle für eine Agentinstanz zu generieren, die unter Linux ausgeführt wird:

sudo /usr/bin/google_cloud_sap_agent supportbundle --sid="SID" --instance-numbers="INSTANCE_NUMBERS" --hostname="HOST_NAME" [--pacemaker-diagnosis="BOOLEAN_VALUE"] [--result-bucket="BUCKET_NAME"] [--metrics] [--timestamp="TIMESTAMP"] [-before-duration=BEFORE_DURATION] [-after-duration=AFTER_DURATION]

Ersetzen Sie Folgendes:

• SID: Ihre SAP-System-ID.
• INSTANCE_NUMBERS: Die SAP-Instanznummern, für die Sie das Support-Bundle generieren möchten.

  Wenn Sie mehrere Instanznummern angeben möchten, trennen Sie sie durch ein Leerzeichen. Beispiel: 00 11 22 Wenn Sie zwei oder mehr SAP-Instanzennummern angeben, generiert der Befehl ein kombiniertes Support-Bundle für die angegebenen Instanzen.

• HOST_NAME: Der Name des Hosts, auf dem Sie den Befehl ausführen.
• BOOLEAN_VALUE: Der Wert true oder false, der angibt, ob die Pacemaker-bezogene Diagnose durchgeführt wird oder nicht. Der Standardwert ist false.
• BUCKET_NAME: Der Name des Cloud Storage-Buckets, in den die Ausgabe des Befehls supportbundle hochgeladen werden soll.
• TIMESTAMP: Der Zeitstempel im Format YYYY-MM-DD HH:MM:SS, um den herum Sie Informationen zu Vorkommnissen der vordefinierten SAP-Ereignistypen und Änderungen an Messwertwerten erfassen möchten. Der Standardwert ist die Uhrzeit, zu der Sie den Befehl supportbundle ausführen.
• BEFORE_DURATION: Die Anzahl der Sekunden vor dem Wert der Option timestamp, während der der Agent nach Vordefinierten SAP-Ereignissen und Änderungen an Messwertwerten sucht. Der Standardwert beträgt 3.600 Sekunden.
• AFTER_DURATION: Die Anzahl der Sekunden nach dem Wert der Option timestamp, während der der Agent nach Vordefinierten SAP-Ereignissen und Änderungen an Messwerten sucht. Der Standardwert beträgt 1.800 Sekunden.

Zuletzt vom Agent erfassten Daten

Geben Sie die zuletzt vom Agent erfassten Daten an. Speichern Sie die zuletzt vom Agent erfassten Daten in einer Datei und hängen Sie die Datei an Ihre Supportanfrage an.

So rufen Sie die zuletzt vom Agent erfassten Daten auf:

Konfigurationsdatei

Nachdem Sie Anmeldedaten wie den Nutzernamen und die Passwörter der SAP HANA-Datenbank entfernt haben, geben Sie die Konfigurationsdatei für den Agenten von Google Cloudfür SAP an.

Wechseln Sie zum folgenden Pfad, um die Konfigurationsdatei für den Agent zu finden:

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

C:\Program Files\Google\google-cloud-sap-agent\conf\configuration.json

Logdatei

Geben Sie die Logdatei für den Agent für SAP von Google Cloudan.

Wechseln Sie zum folgenden Pfad, um die Logdatei für den Agent zu finden:

/var/log/google-cloud-sap-agent.log

C:\Program Files\Google\google-cloud-sap-agent\logs\google-cloud-sap-agent.log