Configurare la raccolta delle metriche sullo stato di salute dell'agente

Questa guida mostra come configurare l'agente per SAP di Google Cloudin modo da raccogliere le metriche relative allo stato dal processo di daemon dell'agente nell'istanza Compute Engine o nel server Bare Metal Solution.

Per informazioni su questa funzionalità, consulta la raccolta delle metriche relative allo stato degli agenti.

Prima di iniziare

• Convalida l'installazione dell'agente per SAP di Google Cloud. Per le istruzioni, consulta la guida all'installazione per il tuo scenario.
• Se hai installato l'agente su un server Bare Metal Solution, assicurati di aver completato i prerequisiti richiesti e di aver configurato un account di servizio. Per le istruzioni, consulta Configurare l'agente per SAP di Google Cloudsu Linux.

Ruoli obbligatori

Per assicurarti che l'account di servizio disponga delle autorizzazioni necessarie per consentire all'agente per SAP di Google Clouddi raccogliere le metriche relative allo stato dell'agente, chiedi all'amministratore di concedere all'account di servizio i seguenti ruoli IAM nel progetto:

• Monitoring Metric Writer (roles/monitoring.metricWriter): per scrivere le metriche raccolte in Cloud Monitoring.

Per saperne di più sulla concessione dei ruoli, consulta Gestisci l'accesso a progetti, cartelle e organizzazioni.

Questi ruoli predefiniti contengono le autorizzazioni necessarie per consentire all'agente per SAP di Google Clouddi raccogliere le metriche relative allo stato dell'agente. Per visualizzare le autorizzazioni esatte richieste, espandi la sezione Autorizzazioni richieste:

L'amministratore potrebbe anche assegnare all'account di servizio queste autorizzazioni con ruoli personalizzati o altri ruoli predefiniti.

Abilita la raccolta delle metriche relative allo stato di salute degli agenti

Per consentire all'agente per SAP di Google Clouddi raccogliere le metriche relative allo stato del processo di daemon sul tuo host:

1. Stabilisci una connessione SSH con l'istanza Compute Engine o il server Bare Metal Solution di destinazione.

2. Abilita la raccolta delle metriche relative allo stato di salute dell'agente:

   Esegui comando

   1. Per attivare la raccolta delle metriche relative allo stato dell'agente, esegui il seguente 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 della CPU e della memoria del processo di daemon e li invia a Cloud Monitoring. La frequenza predefinita è di 60 secondi.

      Per modificare questa frequenza, esegui il seguente 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. Se vuoi, puoi modificare la frequenza con cui l'agente controlla il proprio stato di operatività e invia queste informazioni a Cloud Monitoring. La frequenza predefinita è di 60 secondi.

      Per modificare questa frequenza, esegui il seguente comando. 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 il 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 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 della CPU e della memoria del processo di daemon e li invia a Cloud Monitoring. La frequenza predefinita è di 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. Se vuoi, puoi modificare la frequenza con cui l'agente controlla il proprio stato di operatività e invia queste informazioni a Cloud Monitoring. La frequenza predefinita è di 60 secondi.

      Per modificare questa frequenza, includi quanto segue nella sezionecollection_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

{
  "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
  },
  "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
  }
}

Parametri di configurazione

La tabella seguente illustra i parametri di configurazione dell'agente per SAP diGoogle Cloudspecifici per la raccolta delle metriche relative allo stato dell'agente: