Configura la raccolta di metriche di integrità dell'agente

Questa guida mostra come configurare l'agente Google Cloud per SAP in modo da raccogliere le metriche di integrità dal processo del daemon dell'agente sull'istanza VM di Compute Engine o sul server Bare Metal Solution.

Per informazioni su questa funzionalità, consulta Raccolta delle metriche relative allo stato di salute degli agenti.

Prima di iniziare

Imposta ruoli IAM

Per abilitare la raccolta delle metriche di integrità da parte dell'agente di Google Cloud per SAP, devi assicurarti che l'account di servizio utilizzato dall'istanza VM di Compute Engine o dal server Bare Metal Solution includa i seguenti ruoli:

Per aggiungere questi ruoli obbligatori al tuo account di servizio, segui questi passaggi:

  1. Nella console Google Cloud, vai alla pagina IAM.

    Vai a IAM

  2. Selezionare il tuo progetto Google Cloud.

  3. Identifica l'account di servizio a cui vuoi aggiungere un ruolo.

    • Se l'account di servizio non è già nell'elenco delle entità, non avrà alcun ruolo assegnato. Fai clic su Concedi accesso e inserisci l'indirizzo email dell'account di servizio.
    • Se l'account di servizio è già nell'elenco delle entità, ha ruoli esistenti. Fai clic sul pulsante Modifica per l'account di servizio che vuoi modificare.

  4. Seleziona il ruolo richiesto dall'elenco di ruoli disponibili:

    • Compute Engine > Visualizzatore Compute
    • Monitoring > Writer metriche Monitoring

  5. Fai clic su Salva per applicare i ruoli all'account di servizio.

Abilita la raccolta di metriche di integrità dell'agente

Per consentire all'agente di Google Cloud per SAP di raccogliere le metriche di integrità per il processo del daemon sull'host, segui questi passaggi:

  1. Stabilisci una connessione SSH con l'istanza VM host o il server Bare Metal Solution.

  2. Abilita la raccolta delle metriche di integrità dell'agente:

    Esegui comando

    1. Per abilitare la raccolta delle metriche di integrità dell'agente, esegui questo comando:

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

    2. Facoltativamente, puoi modificare la frequenza con cui l'agente raccoglie l'utilizzo di CPU e memoria del processo del daemon e li invia a Cloud Monitoring. La frequenza predefinita è 60 secondi.

      Per modificare questa frequenza, esegui questo comando:

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

      Sostituisci FREQUENCY con il valore richiesto, in secondi. La frequenza non deve essere inferiore a 5 secondi.

    3. Facoltativamente, puoi modificare la frequenza con cui l'agente controlla l'integrità operativa e invia queste informazioni a Cloud Monitoring. La frequenza predefinita è 60 secondi.

      Per modificare questa frequenza, esegui il comando seguente. La frequenza non deve essere inferiore a 5 secondi.

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

    Modifica file di configurazione

    In alternativa all'esecuzione del comando dell'agente, puoi modificare manualmente la configurazione dell'agente come segue:

    1. Apri il file di configurazione di Backint:

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

    2. Nella sezione collection_configuration, includi quanto segue:

      "collect_agent_metrics": true

    3. Facoltativamente, puoi modificare la frequenza con cui l'agente raccoglie l'utilizzo di CPU e memoria del processo del daemon e li invia a Cloud Monitoring. La frequenza predefinita è 60 secondi.

      Per modificare questa frequenza, includi quanto segue nella sezione collection_configuration.

      "agent_metrics_frequency": FREQUENCY

      Sostituisci FREQUENCY con il valore richiesto, in secondi. La frequenza non deve essere inferiore a 5 secondi.

    4. Facoltativamente, puoi modificare la frequenza con cui l'agente controlla l'integrità operativa e invia queste informazioni a Cloud Monitoring. La frequenza predefinita è 60 secondi.

      Per modificare questa frequenza, includi quanto segue nella sezione collection_configuration. La frequenza non deve essere inferiore a 5 secondi.

      "agent_health_frequency": FREQUENCY

    5. Salva il file di configurazione.

    6. Riavvia l'agente per applicare le nuove impostazioni:

      sudo systemctl restart google-cloud-sap-agent

File di configurazione di esempio

Istanza VM di Compute Engine

L'esempio seguente è un file di configurazione completo dell'agente di Google Cloud per SAP in esecuzione su un istanza VM di Compute Engine, in cui è abilitata la raccolta delle metriche di integrità dell'agente:

{
  "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
  },
  "hana_monitoring_configuration": {
    "enabled": false
  }
}

Server Bare Metal Solution

L'esempio seguente è un file di configurazione completo dell'agente di Google Cloud per SAP in esecuzione su un server Bare Metal Solution, in cui è abilitata la raccolta delle metriche di integrità dell'agente:

{
  "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
  },
  "hana_monitoring_configuration": {
    "enabled": false
  }
}

Parametri di configurazione

La tabella seguente illustra i parametri di configurazione dell'agente per SAP di Google Cloud specifici per la raccolta delle metriche di integrità dell'agente:

Parametri
collection_configuration.collect_agent_metrics

Boolean

Facoltativo. Specifica true per consentire all'agente di raccogliere le seguenti informazioni e inviarle a Cloud Monitoring:

  • Utilizzo di CPU e memoria da parte del processo daemon dell'agente sull'host.
  • L'integrità operativa del processo del daemon dell'agente sull'host.

Il valore predefinito è false.
collection_configuration.agent_metrics_frequency

Int

Facoltativo. Specifica la frequenza con cui l'agente raccoglie l'utilizzo di CPU e memoria del processo del daemon sull'host e li invia a Cloud Monitoring. Queste informazioni vengono acquisite dalle metriche sap/agent/cpu/utilization e sap/agent/memory/utilization. Il valore predefinito è 60 secondi. La frequenza non deve essere inferiore a 5 secondi.

collection_configuration.agent_health_frequency

Int

Facoltativo. Specifica la frequenza con cui l'agente con cui l'agente controlla la sua integrità operativa e invia queste informazioni a Cloud Monitoring. Queste informazioni vengono acquisite dalla metrica sap/agent/health. Il valore predefinito è di 60 secondi. La frequenza non deve essere inferiore a 5 secondi.