Konfigurationsbefehle für den Google Cloud-Agent für SAP

In diesem Dokument werden die Befehle beschrieben, mit denen Sie die Konfiguration des Google Cloud-Agents für SAP ändern können. Diese Befehle werden ab Version 3.2 des Agents unterstützt.

Die Konfigurationsbefehle sind eine Alternative zum Bearbeiten der Konfigurationsdatei des Agents: /etc/google-cloud-sap-agent/configuration.json. Jeder Konfigurationsbefehl startet auch den Agent neu, damit die Änderung wirksam wird.

Limit für Neustart des Agents

Sie können den Google Cloud-Agent für SAP bis zu dreimal in 60 Sekunden neu starten. Während dieses Zeitraums können Sie den Agent zwar weiter konfigurieren, indem Sie die Konfigurationsbefehle ausführen. Alle automatischen Neustartvorgänge, die über dieses Limit hinausgehen, schlagen jedoch mit der Ausgabe Could not restart the agent fehl.

Wenn Sie diese Ausgabe sehen, müssen Sie den Agent manuell neu starten, nachdem alle erforderlichen Konfigurationsbefehle ausgeführt wurden, damit die Änderungen wirksam werden. Eine Anleitung finden Sie unter Agent neu starten.

Hilfebefehle

  • So geben Sie eine zusammenfassende Hilfe für den Befehl google_cloud_sap_agent configure des Agents aus und beenden den Befehl:

    sudo /usr/bin/google_cloud_sap_agent configure -help
  • So geben Sie den Status der Features Ihrer Agent-Instanz aus:

    sudo /usr/bin/google_cloud_sap_agent configure -showall
  • So geben Sie die Version Ihrer Agent-Instanz aus:

    sudo /usr/bin/google_cloud_sap_agent configure -version

Informationen zu den vom Befehl google_cloud_sap_agent configure unterstützten Argumenten finden Sie unter Unterstützte Argumente.

Einstellungen auf oberster Ebene

  • So konfigurieren Sie den Agent für einen Bare-Metal-Lösungsserver:
    sudo /usr/bin/google_cloud_sap_agent configure -setting=bare_metal -enable

    So konfigurieren Sie den Agent für eine Compute Engine-VM-Instanz:

    sudo /usr/bin/google_cloud_sap_agent configure -setting=bare_metal -disable

  • So legen Sie die Logging-Ebene des Agents fest:

    sudo /usr/bin/google_cloud_sap_agent configure -loglevel=LOG_LEVEL

    Ersetzen Sie LOG_LEVEL durch eine der unterstützten Logebenen: debug, info, warn oder error.

Für SAP-Systemerkennung

  • So ermöglichen Sie dem Agent, die Namen und Versionen der SAP-Produkte zu erfassen, die von Ihrem SAP-System verwendet werden:

    sudo /usr/bin/google_cloud_sap_agent configure -feature=workload_discovery -enable

    So verhindern Sie, dass der Agent die Namen und Versionen der SAP-Produkte erfasst, die von Ihrem SAP-System verwendet werden:

    sudo /usr/bin/google_cloud_sap_agent configure -feature=workload_discovery -disable
  • So ermöglichen Sie dem Agent, die erkannten SAP-Systeminformationen an Cloud Logging und an Workload Manager zu senden, wenn die Workload Manager API in Ihrem Google Cloud-Projekt aktiviert ist:

    sudo /usr/bin/google_cloud_sap_agent configure -feature=sap_discovery -enable

    So verhindern Sie, dass der Agent die erkannten Informationen an Cloud Logging und Workload Manager sendet:

    sudo /usr/bin/google_cloud_sap_agent configure -feature=sap_discovery -disable

Für die Erfassung von Messwerten für den SAP-Host-Agent

  • So ermöglichen Sie dem Agent, die SAP-Host-Agent-Messwerte zu erfassen:

    sudo /usr/bin/google_cloud_sap_agent configure -feature=host_metrics -enable

    So beenden Sie die Erfassung der SAP-Host-Agent-Messwerte:

    sudo /usr/bin/google_cloud_sap_agent configure -feature=host_metrics -disable

Für die Erfassung von Agent-Zustandsmesswerten

  • So aktivieren Sie die Erfassung der Agent-Zustandsmesswerte:

    sudo /usr/bin/google_cloud_sap_agent configure -feature=agent_metrics -enable

    So aktivieren Sie die Erfassung der Agent-Zustandsmesswerte:

    sudo /usr/bin/google_cloud_sap_agent configure -feature=agent_metrics -disable

  • So ändern Sie die Häufigkeit, mit der der Agent die CPU- und Arbeitsspeichernutzung seines Daemon-Prozesses erfasst und an Cloud Monitoring sendet:

    sudo /usr/bin/google_cloud_sap_agent configure -feature=agent_metrics -agent_metrics_frequency=FREQUENCY

    Ersetzen Sie FREQUENCY durch den erforderlichen Wert in Sekunden. Die Häufigkeit darf nicht weniger als 5 Sekunden betragen.

  • So ändern Sie die Häufigkeit, mit der der Agent seinen Betriebszustand prüft und diese Informationen an Cloud Monitoring sendet:

    sudo /usr/bin/google_cloud_sap_agent configure -feature=agent_metrics -agent_health_frequency=FREQUENCY

Für die Erfassung von Prozessmonitoring-Messwerten

  • So ermöglichen Sie dem Agent, die Prozessmonitoring-Messwerte zu erfassen:

    sudo /usr/bin/google_cloud_sap_agent configure -feature=process_metrics -enable

    So beenden Sie die Erfassung von Prozessmonitoring-Messwerten:

    sudo /usr/bin/google_cloud_sap_agent configure -feature=process_metrics -disable
  • So ändern Sie die Häufigkeit, mit der der Agent die schnell wechselnden Prozessmonitoring-Messwerte erfassen muss:

    sudo /usr/bin/google_cloud_sap_agent configure -feature=process_metrics -process_metrics_frequency=FREQUENCY

    So ändern Sie die Häufigkeit, mit der der Agent die langsam wechselnden Prozessmonitoring-Messwerte erfassen muss:

    sudo /usr/bin/google_cloud_sap_agent configure -feature=process_metrics -slow_process_metrics_frequency=FREQUENCY

    Ersetzen Sie FREQUENCY durch die Häufigkeit in Sekunden, mit der der Agent die Messwerte erfassen muss.

  • So beenden Sie die Erfassung jeglicher Prozessmonitoring-Messwerte:

    sudo /usr/bin/google_cloud_sap_agent configure -feature=process_metrics -process_metrics_to_skip="LIST_OF_METRICS" -add

    So setzen Sie die Erfassung jeglicher Prozessmonitoring-Messwerte fort, die Sie beim Agent angehalten haben:

    sudo /usr/bin/google_cloud_sap_agent configure -feature=process_metrics -process_metrics_to_skip="LIST_OF_METRICS" -remove

    Ersetzen Sie LIST_OF_METRICS durch die Namen der Prozessmonitoring-Messwerte, die der Agent wieder erfassen soll. Trennen Sie die Messwertnamen durch Kommas.

Für die Erfassung von Arbeitslastmanager-Bewertungsmesswerten

  • So kann der Agent die Bewertungsmesswerte für Arbeitslastmanager erfassen:
    sudo /usr/bin/google_cloud_sap_agent configure -feature=workload_evaluation -enable
  • So beenden Sie die Erfassung von Arbeitslastmanager-Bewertungsmesswerten:

    sudo /usr/bin/google_cloud_sap_agent configure -feature=workload_evaluation -disable
  • So ändern Sie die Häufigkeit, mit der der Agent die Arbeitslastmanager-Bewertungsmesswerte erfassen muss:

    sudo /usr/bin/google_cloud_sap_agent configure -feature=workload_evaluation -workload_evaluation_metrics_frequency=FREQUENCY

    Ersetzen Sie FREQUENCY durch die Häufigkeit in Sekunden, mit der der Agent die Arbeitslastmanager-Bewertungsmesswerte erfassen muss.

  • So ändern Sie die Häufigkeit, mit der der Agent die SAP HANA-Datenbankmesswerte für die Bewertung des Arbeitslastmanagers erfassen muss:

    sudo /usr/bin/google_cloud_sap_agent configure -feature=workload_evaluation -workload_evaluation_db_metrics_frequency=FREQUENCY

    Ersetzen Sie FREQUENCY durch die Häufigkeit in Sekunden, mit der der Agent die SAP HANA-Datenbankmesswerte für die Bewertung des Arbeitslastmanagers erfassen muss.

Für die Erfassung von SAP HANA-Monitoring-Messwerten

  • So ermöglichen Sie dem Agent, die SAP HANA-Monitoring-Messwerte zu erfassen:

    sudo /usr/bin/google_cloud_sap_agent configure -feature=hana_monitoring -enable

    So beenden Sie die Erfassung der SAP HANA-Monitoring-Messwerte:

    sudo /usr/bin/google_cloud_sap_agent configure -feature=hana_monitoring -disable
  • So ändern Sie das Stichprobenintervall, in dem der Agent die SAP HANA-Monitoring-Messwerte erfassen muss:

    sudo /usr/bin/google_cloud_sap_agent configure -feature=hana_monitoring -sample_interval_sec=SAMPLE_INTERNAL

    Ersetzen Sie SAMPLE_INTERNAL durch das Intervall in Sekunden. Das Intervall muss mindestens 5 Sekunden lang sein.

  • So ändern Sie den Zeitlimitwert für eine Abfrage an die SAP HANA-Instanz:

    sudo /usr/bin/google_cloud_sap_agent configure -feature=hana_monitoring -query_timeout_sec=QUERY_TIMEOUT

    Ersetzen Sie QUERY_TIMEOUT durch einen Wert in Sekunden.

Unterstützte Argumente

In der folgenden Tabelle werden die Argumente beschrieben, die Sie mit dem Befehl google_cloud_sap_agent configure verwenden können:

Argument Beschreibung
-add

Dieses Argument bewirkt, dass der Agent die Erfassung der Prozessmonitoring-Messwerte beendet, die Sie für das Argument -process_metrics_to_skip angeben.

-disable

Deaktiviert das angegebene Feature oder den Parameter des Agents.

-enable

Aktiviert das angegebene Feature oder den Parameter des Agents.

-f=FEATURE_NAME
oder
-feature=FEATURE_NAME

STRING

Legt die Agent-Funktion fest, die Sie konfigurieren möchten. Folgende Werte werden unterstützt:

  • host_metrics
  • process_metrics
  • agent_metrics
  • hana_monitoring
  • workload_evaluation
  • sap_discovery
-h oder -help

Zeigt Hilfeinformationen zu dem Befehl an.

-loglevel=LOG_LEVEL

STRING

Legt die Logging-Ebene für den Agent fest. Die unterstützten Werte sind debug, info, warn und error.

-path=PATH

STRING

Legt den Pfad für die Konfigurationsdatei des Agents fest: /etc/google-cloud-sap-agent/configuration.json.

-process_metrics_to_skip="LIST_OF_METRICS"

STRING

Gibt die Prozessmonitoring-Messwerte an, die der Agent nicht mehr erfassen darf. Verwenden Sie ein Komma, um die Messwertnamen zu trennen. Verwenden Sie die Argumente -add und -remove mit -process_metrics_to_skip.

-process_metrics_frequency=FREQUENCY

INT

Legt die Häufigkeit fest, mit der der Agent schnell wechselnde Prozessmonitoring-Messwerte erfasst. Der Standardwert beträgt 5 Sekunden.

-slow_process_metrics_frequency=FREQUENCY

INT

Legt die Häufigkeit fest, mit der der Agent langsam wechselnde Prozessmonitoring-Messwerte erfasst. Der Standardwert beträgt 30 Sekunden.

-query_timeout_sec=TIMEOUT

INT

Legt das Abfragezeitlimit in Sekunden für die Erfassung der SAP HANA-Monitoring-Messwerte fest.

-remove

Dieses Argument bewirkt, dass der Agent die Erfassung der Prozessmonitoring-Messwerte fortsetzt, die Sie mithilfe des Arguments -process_metrics_to_skip beendet haben.

-sample_interval_sec=INTERVAL

INT

Legt die Häufigkeit in Sekunden fest, mit der der Agent Ihre SAP HANA-Instanz abfragt und die SAP HANA-Monitoringmesswerte erfasst.

-setting=SETTING

STRING

Gibt die Agent-Einstellung an, die Sie konfigurieren möchten.

-showall

Gibt den Status der Features Ihrer Agent-Instanz aus.

-slow_process_metrics_frequency=FREQUENCY

INT

Gibt die Erfassungshäufigkeit der langsam wechselnden Prozessmonitoring-Messwerte in Sekunden an.

-v oder -version

Gibt die Version des Agents aus.

-workload_evaluation_metrics_frequency=FREQUENCY

INT

Legt die Häufigkeit fest, mit der der Agent die Arbeitslastmanager-Bewertungsmesswerte erfasst.

-workload_evaluation_db_metrics_frequency=FREQUENCY

INT

Legt die Häufigkeit fest, mit der der Agent die SAP HANA-Datenbankmesswerte für die Bewertung des Arbeitslastmanagers erfasst.