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-Instanz oder Ihrem Bare-Metal-Lösungsserver erfasst werden.

Weitere Informationen zu dieser Funktion finden Sie unter Erfassung von Agent-Zustandsmesswerten.

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-Berechtigungen festlegen

Damit der Google Cloud-Agent für SAP die Zustandsmesswerte erfassen kann, muss das von Ihrer Compute Engine-Instanz oder dem Bare-Metal-Lösungsserver verwendete Dienstkonto die erforderlichen IAM-Berechtigungen haben.

So fügen Sie Ihrem Dienstkonto die erforderlichen Berechtigungen 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 gewähren 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:

   • Monitoring > Monitoring-Messwert-Autor

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

Für eine detaillierte Zugriffsebene können Sie Ihrer benutzerdefinierten Rolle die folgenden IAM-Berechtigungen zuweisen:

• Messwerterhebung:
  • monitoring.timeSeries.create

Weitere Informationen zum Erstellen einer benutzerdefinierten Rolle finden Sie unter Benutzerdefinierte Rollen erstellen und verwalten.

Erfassung von Agent-Zustandsmesswerten aktivieren

So aktivieren Sie den Google Cloud-Agent für SAP, damit er die Zustandsmesswerte für den Daemonprozess auf Ihrem Host erfasst:

1. Stellen Sie eine SSH-Verbindung zu Ihrer Compute Engine-Hostinstanz oder Ihrem Bare-Metal-Lösungsserver her.

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

   Befehl ausführen

   1. Führen Sie den folgenden Befehl aus, um die Erfassung der Agent-Zustandsmesswerte 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

   Alternativ zum Ausführen des Befehls des Agents können Sie die Konfiguration des Agents manuell so ändern:

   1. Öffnen Sie die Backint-Konfigurationsdatei:

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

   2. Fügen 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

{
  "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": "instance-1",
    "image": "rhel-8"
  },
  "discovery_configuration": {
    "enable_discovery": true,
    "enable_workload_discovery": true
  },
  "hana_monitoring_configuration": {
    "enabled": false
  }
}

{
  "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.