Configurare la raccolta delle metriche sullo stato di integrità dell'agente

Questa guida mostra come configurare l'agente di Google Cloud per SAP in modo da raccogliere le metriche di 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

Impostare i ruoli IAM

Per consentire all'agente per SAP di Google Cloud di raccogliere le metriche relative allo stato, devi assicurarti che l'account di servizio utilizzato dall'istanza Compute Engine o dal server Bare Metal Solution includa i seguenti ruoli:

Per aggiungere questi ruoli obbligatori al tuo account di servizio:

  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à presente nell'elenco delle entità, non sono stati assegnati ruoli. Fai clic su Concedi accesso e inserisci l'indirizzo email dell'account di servizio.
    • Se l'account di servizio è già presente nell'elenco dei principali, significa che ha già dei ruoli. Fai clic sul pulsante Modifica per l'account di servizio che vuoi modificare.

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

    • Compute Engine > Visualizzatore Compute
    • Monitoraggio > Monitoring Metric Writer

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

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

Per consentire all'agente di Google Cloud per SAP di raccogliere le metriche di stato per il processo del daemon sul tuo host, segui questi passaggi:

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

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

    Esegui comando

    1. Per abilitare 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 di CPU e 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 di CPU e 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

Istanza Compute Engine

L'esempio seguente è un file di configurazione completo dell'agente di Google Cloud per SAP in esecuzione su un istanza Compute Engine, in cui è abilitata la raccolta delle metriche relative allo stato 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": "instance-1",
    "image": "rhel-8"
  },
  "discovery_configuration": {
    "enable_discovery": true,
    "enable_workload_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 relative allo stato 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,
    "enable_workload_discovery": true
  },
  "hana_monitoring_configuration": {
    "enabled": false
  }
}

Parametri di configurazione

La tabella seguente illustra i parametri di configurazione dell'agente di Google Cloud per SAP specifici per la raccolta delle metriche relative allo stato 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 della CPU e della memoria da parte del processo daemon dell'agente sull'host.
  • Lo stato operativo del processo di daemon dell'agente sul tuo host.

Il valore predefinito è false.
collection_configuration.agent_metrics_frequency

Int

Facoltativo. Specifica la frequenza con cui l'agente raccoglie l'utilizzo della CPU e della memoria del suo processo daemon sull'hosting 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 controlla il proprio stato operativo e invia queste informazioni a Cloud Monitoring. Queste informazioni vengono acquisite dalla metrica sap/agent/health. Il valore predefinito è 60 secondi. La frequenza non deve essere inferiore a 5 secondi.