Erfassung von Agent-Zustandsmesswerten konfigurieren

In diesem Leitfaden erfahren Sie, wie Sie den Google Cloud-Agent für SAP so konfigurieren, dass Zustandsmesswerte aus dem Daemon-Prozess des Agents auf Ihrer Compute Engine-VM-Instanz oder Ihrem Bare-Metal-Lösungsserver erfasst werden.

Informationen zu diesem Feature finden Sie unter Erfassung von Agent-Zustandsmesswerten.

Hinweise

IAM-Rollen festlegen

Damit der Google Cloud-Agent für SAP die Zustandsmesswerte erfassen kann, muss das von Ihrer Compute Engine-VM-Instanz oder dem Bare-Metal-Lösung-Server verwendete Dienstkonto folgende Rollen haben:

So fügen Sie Ihrem Dienstkonto die erforderlichen Rollen hinzu:

  1. Öffnen Sie in der Google Cloud Console die Seite IAM.

    IAM aufrufen

  2. Wählen Sie Ihr Google Cloud-Projekt aus.

  3. 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 Zugriff erlauben 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 .

  4. Wählen Sie die erforderliche Rolle in der Liste der verfügbaren Rollen aus:

    • Compute Engine > Compute-Betrachter
    • Monitoring > Monitoring-Messwert-Autor

  5. Klicken Sie auf Speichern, um die Rollen auf das Dienstkonto anzuwenden.

Erfassung von Agent-Zustandsmesswerten aktivieren

So aktivieren Sie den Google Cloud-Agent für SAP, um die Zustandsmesswerte für den Daemon-Prozess auf Ihrem Host zu erfassen:

  1. Stellen Sie eine SSH-Verbindung zu Ihrer Host-VM-Instanz oder Ihrem Bare-Metal-Lösung-Server her.

  2. So aktivieren Sie die Erfassung der Agent-Zustandsmesswerte:

    Befehl ausführen

    1. Führen Sie den folgenden Befehl aus, um die Erfassung von Agent-Zustandsmesswerten zu aktivieren:

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

    2. Optional können Sie die Häufigkeit ändern, mit der der Agent die CPU- und Arbeitsspeichernutzung seines Daemon-Prozesses erfasst und an Cloud Monitoring sendet. Die Standardeinstellung beträgt 60 Sekunden.

      Führen Sie den folgenden Befehl aus, um diese Häufigkeit zu ändern:

      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.

    3. Optional können Sie die Häufigkeit ändern, mit der der Agent seinen Betriebszustand prüft und diese Informationen an Cloud Monitoring sendet. Die Standardeinstellung beträgt 60 Sekunden.

      Führen Sie den folgenden Befehl aus, um diese Häufigkeit zu ändern. Die Häufigkeit darf nicht weniger als 5 Sekunden betragen.

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

    Konfigurationsdatei bearbeiten

    Statt den Befehl des Agents auszuführen, können Sie die Konfiguration des Agents so manuell ändern:

    1. Öffnen Sie die Backint-Konfigurationsdatei:

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

    2. Geben Sie im Abschnitt collection_configuration Folgendes ein:

      "collect_agent_metrics": true

    3. Optional können Sie die Häufigkeit ändern, mit der der Agent die CPU- und Arbeitsspeichernutzung seines Daemon-Prozesses erfasst und an Cloud Monitoring sendet. Die Standardeinstellung beträgt 60 Sekunden.

      Fügen Sie Folgendes im Abschnitt collection_configuration ein, um diese Häufigkeit zu ändern.

      "agent_metrics_frequency": FREQUENCY

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

    4. Optional können Sie die Häufigkeit ändern, mit der der Agent seinen Betriebszustand prüft und diese Informationen an Cloud Monitoring sendet. Die Standardeinstellung beträgt 60 Sekunden.

      Fügen Sie Folgendes im Abschnitt collection_configuration ein, um diese Häufigkeit zu ändern. Die Häufigkeit darf nicht weniger als 5 Sekunden betragen.

      "agent_health_frequency": FREQUENCY

    5. Speichern Sie die Konfigurationsdatei.

    6. 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 Agent-Zustandsmesswerten aktiviert ist:

{
  "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,
    "collect_agent_metrics": true,
    "agent_metrics_frequency": 60,
    "agent_health_frequency": 60
  },
  "cloud_properties": {
    "project_id": "my-project",
    "instance_name": "vm-instance-1",
    "image": "rhel-8"
  },
  "discovery_configuration": {
    "enable_discovery": true,
    "enable_workload_discovery": true
  },
  "hana_monitoring_configuration": {
    "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 Agent-Zustandsmesswerten aktiviert ist:

{
  "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,
    "collect_agent_metrics": true,
    "agent_metrics_frequency": 60,
    "agent_health_frequency": 60
  },
  "cloud_properties": {
    "project_id": "my-project",
    "instance_name": "bms-machine-1"
    "region": "us-central1",
    "image": "rhel-8"
  },
  "discovery_configuration": {
    "enable_discovery": true,
    "enable_workload_discovery": true
  },
  "hana_monitoring_configuration": {
    "enabled": false
  }
}

Konfigurationsparameter

In der folgenden Tabelle werden die Konfigurationsparameter des Agents von Google Cloud für SAP erläutert, die für die Erfassung der Agent-Zustandsmesswerte spezifisch sind.

Parameter
collection_configuration.collect_agent_metrics

Boolean

Optional. Geben Sie true an, damit der Agent die folgenden Informationen erfassen und an Cloud Monitoring senden kann:

  • CPU- und Arbeitsspeichernutzung durch den Daemon-Prozess des Agents auf Ihrem Host.
  • Der Betriebszustand des Daemon-Prozesses des Agents auf Ihrem Host.

Der Standardwert ist false.
collection_configuration.agent_metrics_frequency

Int

Optional. Geben Sie an, mit welcher Häufigkeit der Agent die CPU- und Arbeitsspeichernutzung seines Daemon-Prozesses auf dem Host erfasst und an Cloud Monitoring sendet. Diese Informationen werden durch die Messwerte sap/agent/cpu/utilization und sap/agent/memory/utilization erfasst. Der Standardwert beträgt 60 Sekunden. Die Häufigkeit darf nicht weniger als 5 Sekunden betragen.

collection_configuration.agent_health_frequency

Int

Optional. Geben Sie die Häufigkeit an, mit der der Agent seinen Betriebszustand prüft und diese Informationen an Cloud Monitoring sendet. Diese Informationen werden vom Messwert sap/agent/health erfasst. Der Standardwert beträgt 60 Sekunden. Die Häufigkeit darf nicht weniger als 5 Sekunden betragen.