Configura la raccolta delle metriche di integrità dell'agente

Questa guida mostra come configurare Agent per SAP di Google Cloud per raccogliere le metriche di integrità dal processo daemon dell'agente sulla tua istanza VM di Compute Engine o sul server Bare Metal Solution.

Per informazioni su questa funzionalità, consulta Raccolta delle metriche di salute dell'agente.

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 dalla tua istanza VM di Compute Engine o dal server Bare Metal Solution includa i ruoli seguenti:

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 gli sono stati assegnati ruoli. 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 i 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 delle metriche di integrità dell'agente

Per consentire all'agente di Google Cloud per SAP di raccogliere le metriche di integrità per il relativo processo daemon sul tuo 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 suo processo 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 le informazioni a Cloud Monitoring. La frequenza predefinita è 60 secondi.

      Per modificare questa frequenza, esegui questo 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 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 suo processo 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 le 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 Google Cloud per SAP in esecuzione su un istanza VM 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 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 spiega i parametri di configurazione dell'agente Google Cloud per SAP 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 informazioni seguenti e inviarle a Cloud Monitoring:

  • Utilizzo di CPU e memoria da parte del processo daemon dell'agente sul tuo host.
  • L'integrità operativa del processo 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 la CPU e la memoria utilizzata del suo processo 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 controlla l'integrità operativa 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.