Configurare la raccolta delle metriche di valutazione di Workload Manager

Questa guida mostra come configurare l'agente di Google Cloud per SAP per raccogliere le metriche di valutazione di Workload Manager dai sistemi SAP.

Per informazioni su questa funzionalità, consulta Valutazione di Workload Manager mediante l'agente di Google Cloud per SAP.

Prima di iniziare

Impostare i ruoli IAM

Per consentire all'Agent for SAP di Google Cloud di raccogliere le metriche di valutazione di Workload Manager, 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 Aggiungi 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:

    • Visualizzatore Compute
    • Workload Manager > Workload Manager Insights Writer
    • Secret Manager > Secret Manager Secret Accessor

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

Verifica la versione dell'agente

Google Cloud consiglia di installare la versione più recente di Agent for SAP per una valutazione accurata dei carichi di lavoro SAP, in quanto le release periodiche di Agent for SAP potrebbero aggiungere o modificare le metriche utilizzate per la valutazione.

Per assicurarti di avere la versione più recente dell'agente per SAP di Google Cloud, devi controllare periodicamente la disponibilità di aggiornamenti e aggiornare l'agente.

Installare un aggiornamento

Seleziona il tuo sistema operativo e segui i passaggi:

RHEL

  1. Stabilisci una connessione SSH con l'istanza.
  2. Aggiorna l'istanza dell'agente:
    • (Consigliato) Per eseguire l'aggiornamento alla versione 3.6 (la più recente) dell'agente: 
      sudo yum --nogpgcheck update google-cloud-sap-agent
    • Per eseguire l'aggiornamento a una versione specifica dell'agente: 
      sudo yum install google-cloud-sap-agent-VERSION_NUMBER.x86_64

      Sostituisci VERSION_NUMBER con il numero di versione dell'agente che vuoi installare, ad esempio 3.1-606637668. Per informazioni sulle versioni dell'agente che puoi installare, consulta Elenco di tutte le versioni disponibili dell'agente.

SLES

  1. Stabilisci una connessione SSH con l'istanza.
  2. Aggiorna l'istanza dell'agente:
    • (Consigliato) Per eseguire l'aggiornamento alla versione 3.6 (la più recente) dell'agente: 
      sudo zypper --no-gpg-checks update google-cloud-sap-agent
    • Per eseguire l'aggiornamento a una versione specifica dell'agente: 
      sudo zypper install google-cloud-sap-agent-VERSION_NUMBER.x86_64

      Sostituisci VERSION_NUMBER con il numero di versione dell'agente che vuoi installare, ad esempio 3.1-606637668. Per informazioni sulle versioni dell'agente che puoi installare, consulta Elenco di tutte le versioni disponibili dell'agente.

Abilita la raccolta delle metriche di valutazione del Gestore workload

A partire dalla versione 3.2, le nuove installazioni dell'agente di Google Cloud per SAP sono attivate per impostazione predefinita per raccogliere le metriche di valutazione di Workload Manager. Se stai eseguendo l'aggiornamento alla versione 3.2 da una versione precedente, puoi anche attivare esplicitamente la funzionalità. Per farlo, segui questa procedura.

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

  2. Per consentire all'agente di raccogliere le metriche di valutazione del Gestore workload: 

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

  3. Per attivare la raccolta delle metriche "SAP HANA Insights" e "SAP HANA Security Best Practices":

    1. Apri il file di configurazione dell'agente:

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

      In alternativa, puoi eseguire questa configurazione anche tramite comandi. Per ulteriori informazioni, consulta Comandi di configurazione per l'agente di Google Cloud per SAP.

    2. Aggiungi la sezione workload_validation_db_metrics_config dopo collect_workload_validation_metrics, quindi specifica i seguenti parametri:

      • hana_db_user: specifica l'account utente del database SAP HANA utilizzato per eseguire query sull'istanza SAP HANA.
      • hostname: specifica l'identificatore della macchina, locale o remota, che ospita l'istanza SAP HANA.
      • port: specifica la porta su cui l'istanza SAP HANA accetta le query.
      • sid: specifica l'SID dell'istanza SAP HANA

      • hana_db_password_secret_name: specifica il nome del segreto in Secret Manager che memorizza la password dell'account utente

        In alternativa al segreto, puoi utilizzare il parametro di configurazione hdbuserstore_key.

      • hdbuserstore_key: specifica la chiave hdbuserstore che autentica l'utente specificato per hana_db_user

        Se specifichi hdbuserstore_key, salta la specifica dei parametri hostname e port.

      Per informazioni su questi parametri, consulta Parametri di configurazione.

  4. Se vuoi, nella sezione cloud_properties puoi aggiornare i valori dei parametri impostati automaticamente. A tale scopo, aggiungi la sezione cloud_properties al file di configurazione e specifica i parametri richiesti e i relativi valori.

  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

I seguenti esempi sono file di configurazione completati dell'agente di Google Cloud per SAP in esecuzione su un'istanza Compute Engine di un, dove è attivata la raccolta delle metriche di valutazione di Workload Manager.

Per l'autenticazione SAP HANA, l'agente utilizza il seguente ordine di preferenza: se specificato, il parametro di configurazione hdbuserstore_key è preferito rispetto al parametro hana_db_password, che è preferito rispetto al parametro hana_db_password_secret_name. Ti consigliamo di impostare una sola opzione di autenticazione nel file di configurazione.

  • L'esempio seguente utilizza una chiave del repository degli utenti protetto (hdbuserstore) per l'autenticazione SAP HANA: 
    {
  "provide_sap_host_agent_metrics": true,
  "bare_metal": false,
  "log_level": "INFO",
  "log_to_cloud": true,
  "collection_configuration": {
    "collect_workload_validation_metrics": true,
    "workload_validation_db_metrics_frequency": 3600,
    "workload_validation_db_metrics_config": {
      "hana_db_user": "system",
      "sid": "DEH",
      "hdbuserstore_key": "user_store_key"
    },
    "collect_process_metrics": false
  },
  "discovery_configuration": {
    "enable_discovery": true,
    "enable_workload_discovery": true
  },
  "hana_monitoring_configuration": {
    "enabled": false
  }
}
  • L'esempio seguente utilizza un nome utente e un segreto Secret Manager per l'autenticazione SAP HANA: 
    {
  "provide_sap_host_agent_metrics": true,
  "bare_metal": false,
  "log_level": "INFO",
  "log_to_cloud": true,
  "collection_configuration": {
    "collect_workload_validation_metrics": true,
    "workload_validation_db_metrics_frequency": 3600,
    "workload_validation_db_metrics_config": {
      "hana_db_user": "system",
      "sid": "DEH",
      "hana_db_password_secret_name": "instance-id-hana-db-password-secret",
      "hostname": "localhost",
      "port": "30015"
    },
    "collect_process_metrics": false
  },
  "discovery_configuration": {
    "enable_discovery": true,
    "enable_workload_discovery": true
  },
  "hana_monitoring_configuration": {
    "enabled": false
  }
}
  • L'esempio seguente utilizza un nome utente e una password per l'autenticazione SAP HANA. Ti consigliamo di utilizzare un secret di Secret Manager o una chiave del repository degli utenti protetto (hdbuserstore) per l'autenticazione SAP HANA. 
    {
  "provide_sap_host_agent_metrics": true,
  "bare_metal": false,
  "log_level": "INFO",
  "log_to_cloud": true,
  "collection_configuration": {
    "collect_workload_validation_metrics": true,
    "workload_validation_db_metrics_frequency": 3600,
    "workload_validation_db_metrics_config": {
      "hana_db_user": "system",
      "sid": "DEH",
      "hana_db_password": "TempPa55word",
      "hostname": "localhost",
      "port": "30015"
    },
    "collect_process_metrics": false
  },
  "discovery_configuration": {
    "enable_discovery": true,
    "enable_workload_discovery": true
  },
  "hana_monitoring_configuration": {
    "enabled": false
  }
}

Server Bare Metal Solution

I seguenti esempi sono file di configurazione completati dell'agente di Google Cloud per SAP in esecuzione su un'istanza Compute Engine di unserver Bare Metal Solution, dove è attivata la raccolta delle metriche di valutazione di Workload Manager.

Per l'autenticazione SAP HANA, l'agente utilizza il seguente ordine di preferenza: se specificato, il parametro di configurazione hdbuserstore_key è preferito rispetto al parametro hana_db_password, che è preferito rispetto al parametro hana_db_password_secret_name. Ti consigliamo di impostare una sola opzione di autenticazione nel file di configurazione.

  • L'esempio seguente utilizza una chiave del repository degli utenti protetto (hdbuserstore) per l'autenticazione SAP HANA: 
    {
  "provide_sap_host_agent_metrics": true,
  "bare_metal": true,
  "log_level": "INFO",
  "log_to_cloud": true,
  "collection_configuration": {
    "collect_workload_validation_metrics": true,
    "workload_validation_db_metrics_frequency": 3600,
    "workload_validation_db_metrics_config": {
      "hana_db_user": "system",
      "sid": "DEH",
      "hdbuserstore_key": "user_store_key"
    },
    "collect_process_metrics": false
  },
  "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
  }
}
  • L'esempio seguente utilizza un nome utente e un segreto Secret Manager per l'autenticazione SAP HANA: 
    {
  "provide_sap_host_agent_metrics": true,
  "bare_metal": true,
  "log_level": "INFO",
  "log_to_cloud": true,
  "collection_configuration": {
    "collect_workload_validation_metrics": true,
    "workload_validation_db_metrics_frequency": 3600,
    "workload_validation_db_metrics_config": {
      "hana_db_user": "system",
      "sid": "DEH",
      "hana_db_password_secret_name": "instance-id-hana-db-password-secret",
      "hostname": "localhost",
      "port": "30015"
    },
    "collect_process_metrics": false
  },
  "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
  }
}
  • L'esempio seguente utilizza un nome utente e una password per l'autenticazione SAP HANA. Ti consigliamo di utilizzare un secret di Secret Manager o una chiave del repository degli utenti protetto (hdbuserstore) per l'autenticazione SAP HANA. 
    {
  "provide_sap_host_agent_metrics": true,
  "bare_metal": true,
  "log_level": "INFO",
  "log_to_cloud": true,
  "collection_configuration": {
    "collect_workload_validation_metrics": true,
    "workload_validation_db_metrics_frequency": 3600,
    "workload_validation_db_metrics_config": {
      "hana_db_user": "system",
      "sid": "DEH",
      "hana_db_password": "TempPa55word",
      "hostname": "localhost",
      "port": "30015"
    },
    "collect_process_metrics": false
  },
  "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 di valutazione di Workload Manager.

Parametri
provide_sap_host_agent_metrics

Boolean

Per abilitare la raccolta delle metriche richieste dall'agente host SAP, specifica true. Il valore predefinito è true.
Non impostare provide_sap_host_agent_metrics su false a meno che non ti venga indicato dall'assistenza clienti Google Cloud o dall'assistenza SAP.

bare_metal

Boolean

Quando l'agente è installato su un server Bare Metal Solution, specifica true. Il valore predefinito è false.
log_level

String

Per impostare il livello di logging dell'agente, imposta il valore richiesto. I livelli di log disponibili sono i seguenti:

  • DEBUG
  • INFO
  • WARNING
  • ERROR

Il valore predefinito è INFO. Non modificare il livello di logging, a meno che non ti venga indicato dall'assistenza clienti Google Cloud.
log_to_cloud

Boolean

Per reindirizzare i log dell'agente a Cloud Logging, specifica true. Il valore predefinito è true.
cloud_properties.project_id

String

Se il sistema SAP è in esecuzione su un server Bare Metal Solution, specifica l'ID progetto del progetto Google Cloud che utilizzi con Bare Metal Solution.

Quando l'agente viene eseguito su un'istanza Compute Engine, per impostazione predefinita rileva automaticamente l'ID progetto.
cloud_properties.instance_name

String

Se il sistema SAP è in esecuzione su un'istanza Compute Engine, specifica il nome dell'istanza di calcolo. L'agente rileva automaticamente il nome dell'istanza di calcolo al momento dell'installazione.

Se il sistema SAP è in esecuzione su un server Bare Metal Solution, specifica il nome del server.
cloud_properties.region

String

Se il sistema SAP è in esecuzione su un server Bare Metal Solution, specifica la regione del server Bare Metal Solution.

Per impostazione predefinita, quando l'agente viene eseguito su un'istanza di calcolo, utilizza la regione in cui è dipiegato.
cloud_properties.zone

String

Quando l'agente viene eseguito su un'istanza di calcolo, per impostazione predefinita utilizza la zona in cui è dipiattaforma l'istanza di calcolo.
cloud_properties.image

String

Specifica il nome dell'immagine del sistema operativo dell'istanza.

Quando l'agente viene eseguito su un'istanza di calcolo, per impostazione predefinita rileva automaticamente l'immagine del sistema operativo utilizzata dall'istanza di calcolo.
cloud_properties.numeric_project_id

String

Specifica l'ID numerico del progetto Google Cloud in cui è in esecuzione il sistema SAP.

Quando l'agente viene eseguito su un'istanza di calcolo, per impostazione predefinita rileva automaticamente il numero del progetto.
discovery_configuration.enable_workload_discovery

Boolean

Per consentire all'agente di raccogliere i nomi e le versioni dei prodotti SAP in esecuzione sull'host, specifica true. Il valore predefinito è true.

Per ulteriori informazioni, consulta il codice dell'agente nel google-cloud-sap-agent repository GitHub in GoogleCloudPlatform/sapagent.

discovery_configuration.enable_discovery

Boolean

Per inviare a Cloud Logging le informazioni raccolte dall'agente sui prodotti SAP in esecuzione sull'host, specifica true. Il valore predefinito è true.

Se specifichi il valore false, l'agente memorizza le informazioni raccolte sull'host e non le invia a Cloud Logging.

collection_configuration.collect_workload_validation_metrics

Boolean

Per attivare la raccolta delle metriche di valutazione di Workload Manager, specifica true. Dalla versione 3.2, il valore predefinito è true.
Questo parametro è applicabile solo a Linux.
collection_configuration.workload_validation_metrics_frequency

Int

La frequenza di raccolta delle metriche di valutazione del Gestore workload in secondi. Il valore predefinito è 300 secondi.

Se devi modificare la frequenza di raccolta delle metriche di Workload Manager, aggiungi il parametro workload_validation_metrics_frequency nella sezione collection_configuration e fornisci il valore richiesto.
collection_configuration.workload_validation_collection_definition.fetch_latest_config

Boolean

Facoltativo. Il valore predefinito è true, che consente all'agente di raccogliere l'ultimo insieme di metriche di valutazione di Workload Manager senza che tu debba aggiornarlo. Se vuoi disattivare questo comportamento, specifica questo parametro nel file di configurazione e imposta il relativo valore su false.
collection_configuration.workload_validation_db_metrics_config.hana_db_user

String

Specifica l'account utente utilizzato per eseguire query sull'istanza SAP HANA. L'account utente deve disporre dell'autorizzazione di lettura per il database SAP HANA.
collection_configuration.workload_validation_db_metrics_config.hana_db_password

String

Specifica la password per l'account utente utilizzato per eseguire query sull'istanza SAP HANA.

Per l'autenticazione SAP HANA, l'agente utilizza il seguente ordine di preferenza: se specificato, il parametro di configurazione hdbuserstore_key è preferito rispetto al parametro hana_db_password, che è preferito rispetto al parametro hana_db_password_secret_name. Ti consigliamo di impostare una sola opzione di autenticazione nel file di configurazione.

collection_configuration.workload_validation_db_metrics_config.hana_db_password_secret_name

String

Specifica il nome del segreto in Secret Manager che memorizza la password dell'account utente.

In alternativa, puoi specificare il parametro di configurazione hdbuserstore_key per autenticare l'utente SAP HANA specificato.

Per l'autenticazione SAP HANA, l'agente utilizza il seguente ordine di preferenza: se specificato, il parametro di configurazione hdbuserstore_key è preferito rispetto al parametro hana_db_password, che è preferito rispetto al parametro hana_db_password_secret_name. Ti consigliamo di impostare una sola opzione di autenticazione nel file di configurazione.

collection_configuration.workload_validation_db_metrics_config.hdbuserstore_key

String

Per connetterti in sicurezza a un sistema SAP HANA, specifica una chiave Secure User Store (hdbuserstore) che hai creato per quel sistema.

Per utilizzare una chiave hdbuserstore per l'autenticazione, verifica quanto segue:

  • Gli strumenti SAP hdbsql e hdbuserstore sono installati sull'istanza di calcolo che ospita l'agente.
  • La chiave hdbuserstore corrisponde a un'istanza SAP HANA specifica. Non puoi utilizzare chiavi che contengono gli hostname di più istanze SAP HANA.
  • L'utente SIDadm può eseguire query sul database SAP HANA utilizzando questa chiave. Qui SID si riferisce al valore specificato per il parametro sid. Puoi verificarlo eseguendo il seguente comando come utente SIDadm: 
    hdbsql -U HDB_USERSTORE_KEY "SELECT * FROM DUMMY"

Questo parametro di configurazione è supportato dalla versione 3.3 dell'agente.

Se specifichi hdbuserstore_key, puoi saltare la specifica dei parametri hostname e port.

Per l'autenticazione SAP HANA, l'agente utilizza il seguente ordine di preferenza: se specificato, il parametro di configurazione hdbuserstore_key è preferito rispetto al parametro hana_db_password, che è preferito rispetto al parametro hana_db_password_secret_name. Ti consigliamo di impostare una sola opzione di autenticazione nel file di configurazione.

collection_configuration.workload_validation_db_metrics_config.sid

String

Specifica l'SID dell'istanza SAP HANA.
collection_configuration.workload_validation_db_metrics_config.hostname

String

Specifica l'identificatore della macchina, locale o remota, che ospita la tua istanza SAP HANA. Di seguito sono riportati i valori supportati:

  • Se l'host è un computer locale, specifica la stringa localhost o l'indirizzo IP loopback localhost, ad esempio 127.0.0.1.
  • Se l'host è una macchina remota, specifica il relativo indirizzo IP interno o esterno.
collection_configuration.workload_validation_db_metrics_config.port

String

Specifica la porta su cui l'istanza SAP HANA accetta le query. Per la prima o l'unica istanza del database del tenant, la porta è 3NN15, dove NN è il numero di istanza dell'istanza SAP HANA.
collection_configuration.workload_validation_db_metrics_frequency

Int

La frequenza di raccolta delle metriche del database SAP HANA, in secondi, per la valutazione di Workload Manager. Il valore predefinito è 3600 secondi.

Sebbene tu possa aggiornare la frequenza di raccolta delle metriche del database SAP HANA, ti consigliamo di utilizzare il valore predefinito. Se devi modificare il valore predefinito, aggiungi il parammetro workload_validation_db_metrics_frequency nella sezione collection_configuration e fornisci il valore richiesto. Assicurati di non impostare una frequenza di raccolta superiore a 3600 secondi.

Visualizzare le metriche raccolte

Per visualizzare le metriche di valutazione di Workload Manager raccolte dall'agente:

  • Visualizza il file di log dell'agente:

    1. Imposta il livello di log dell'agente su DEBUG:

      sudo /usr/bin/google_cloud_sap_agent configure -loglevel=debug

    2. Dopo il riavvio dell'agente per applicare il nuovo livello di log, consulta il file di log dell'agente:

      /var/log/google-cloud-sap-agent.log

    3. Nel file di log, cerca le voci che contengono quanto segue:

      workload.googleapis.com/sap/validation/

      Di seguito è riportato un esempio che mostra le metriche di valutazione di Workload Manager nel file di log dell'agente:

      {"level":"debug","timestamp":"2024-05-31T20:13:39.439Z",..."context":"WorkloadManagerMetrics",
      "metric":"workload.googleapis.com/sap/validation/system","value":1}
{"level":"debug","timestamp":"2024-05-31T20:13:39.439Z",..."context":"WorkloadManagerMetrics",
      "key":"instance_name","value":"n1-hana-sles15"}
{"level":"debug","timestamp":"2024-05-31T20:13:39.439Z",..."context":"WorkloadManagerMetrics",
      "key":"os","value":"sles-15-SP4"}
...
{"level":"debug","timestamp":"2024-05-31T20:13:39.439Z",..."context":"WorkloadManagerMetrics",
      "metric":"workload.googleapis.com/sap/validation/corosync","value":0}
...

  • Se l'istanza dell'agente è configurata per inviare i log a Cloud Logging, puoi visualizzare i log dell'agente in Cloud Logging.

  • Crea ed esegui una valutazione per il tuo carico di lavoro SAP in Workload Manager. Per ulteriori informazioni, consulta Creare ed eseguire una valutazione.

    Per informazioni sulle best practice supportate da Workload Manager per la valutazione dei carichi di lavoro SAP in esecuzione su Google Cloud, consulta le best practice di Workload Manager per SAP.