Questa pagina è stata tradotta dall'API Cloud Translation.

Configura la raccolta delle metriche di valutazione del Gestore carichi di lavoro

Questa guida mostra come configurare Agent per SAP di Google Cloud per raccogliere le metriche di valutazione di Workload Manager dai tuoi sistemi SAP.

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

Prima di iniziare

Convalida l'installazione dell'agente di Google Cloud per SAP. Per le istruzioni, consulta la guida all'installazione adatta al 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, vedi Configurare l'agente Google Cloud per SAP su Linux.
Assicurati che l'API Workload Manager sia abilitata per il tuo progetto Google Cloud.

Abilitare l'API Workload Manager

Imposta ruoli IAM

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

Visualizzatore Compute (roles/compute.viewer)
Writer di Workload Manager Insights (roles/workloadmanager.insightWriter)
Funzione di accesso ai secret di SAP HANA (roles/secretmanager.secretAccessor) se utilizzi Secret Manager per archiviare la password del database SAP HANA.

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

Nella console Google Cloud, vai alla pagina IAM.

Vai a IAM
Selezionare il tuo progetto Google Cloud.
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 Aggiungi 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.
Seleziona il ruolo richiesto dall'elenco di ruoli disponibili:
- Visualizzatore Compute
- Gestione carichi di lavoro > Writer insight gestore carichi di lavoro
- Secret Manager > Funzione di accesso ai secret di Secret Manager
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 dell'agente per SAP potrebbero aggiungere o modificare le metriche utilizzate per la valutazione.

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

Installa un aggiornamento

Seleziona il tuo sistema operativo, quindi procedi nel seguente modo:

RHEL

Stabilisci una connessione SSH con la tua istanza.
Aggiorna l'istanza dell'agente:
- (Consigliato) Per eseguire l'aggiornamento alla versione 3.4 (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 Elencare tutte le versioni disponibili dell'agente.

SLES

Stabilisci una connessione SSH con la tua istanza.
Aggiorna l'istanza dell'agente:
- (Consigliato) Per eseguire l'aggiornamento alla versione 3.4 (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 Elencare tutte le versioni disponibili dell'agente.

Abilita la raccolta delle metriche di valutazione del Gestore carichi di lavoro

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

Stabilisci una connessione SSH con la tua istanza VM di Compute Engine o con il server Bare Metal Solution.
Per consentire all'agente di raccogliere le metriche di valutazione di Workload Manager:
```
sudo /usr/bin/google_cloud_sap_agent configure -feature=workload_evaluation -enable
```
Per abilitare 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 anche eseguire questa configurazione con i comandi. Per maggiori 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 e 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 sulla quale la tua istanza SAP HANA accetta le query.
  - sid: specifica il SID della tua istanza SAP HANA
  - hana_db_password_secret_name: specifica il nome del secret in Secret Manager in cui viene archiviata la password dell'account utente
    
    In alternativa al secret, 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, salti la specifica dei parametri hostname e port.
  Per informazioni su questi parametri, vedi Parametri di configurazione.
Facoltativamente, nella sezione cloud_properties puoi aggiornare i valori dei parametri impostati automaticamente. Per farlo, aggiungi la sezione cloud_properties al file di configurazione e specifica i parametri richiesti e i relativi valori.
Salva il file di configurazione.
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 per SAP di Google Cloud in esecuzione su un istanza VM Compute Engine, in cui è abilitata la raccolta delle metriche di valutazione di Workload Manager:

{
  "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",
      "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": "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 per SAP di Google Cloud in esecuzione su un server Bare Metal Solution, in cui è abilitata la raccolta delle metriche di valutazione del Gestore carichi di lavoro:

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

Parametri di configurazione

La tabella seguente spiega i parametri di configurazione dell'Agente per SAP di Google Cloud 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 da SAP Host Agent, specifica `true`. Il valore predefinito è `true`. Non impostare `provide_sap_host_agent_metrics` su `false` a meno che non sia 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 sia 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 tuo sistema SAP è in esecuzione su un server Bare Metal Solution, specifica l'ID del progetto Google Cloud che stai utilizzando con Bare Metal Solution. Quando l'agente viene eseguito su un'istanza VM, per impostazione predefinita, rileva automaticamente l'ID progetto.
`cloud_properties.instance_name`	`String` Se il sistema SAP è in esecuzione su un'istanza VM di Compute Engine, specifica il nome di questa istanza VM. L'agente rileva automaticamente il nome dell'istanza VM al momento dell'installazione. Se il sistema SAP è in esecuzione su un server Bare Metal Solution, specifica il nome di quel server.
`cloud_properties.region`	`String` Se il tuo sistema SAP è in esecuzione su un server Bare Metal Solution, specifica la regione del server Bare Metal Solution. Quando l'agente viene eseguito su un'istanza VM, per impostazione predefinita utilizza la regione dell'istanza VM su cui è installato l'agente.
`cloud_properties.zone`	`String` Per impostazione predefinita, quando l'agente viene eseguito su un'istanza VM utilizza la zona dell'istanza VM in cui è installato.
`cloud_properties.image`	`String` Specifica il nome dell'immagine del sistema operativo dell'istanza. Quando l'agente viene eseguito su un'istanza VM, per impostazione predefinita rileva l'immagine del sistema operativo dell'istanza VM su cui è installato l'agente.
`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 VM, per impostazione predefinita, rileva automaticamente l'ID progetto numerico.
`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 maggiori informazioni, consulta il codebase dell'agente nel repository GitHub di `google-cloud-sap-agent` 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 archivia le informazioni raccolte sull'host e non le invia a Cloud Logging.
`collection_configuration.collect_workload_validation_metrics`	`Boolean` Per abilitare la raccolta delle metriche di valutazione del Gestore carichi di lavoro, specifica `true`. Dalla versione 3.2, il valore predefinito è `true`. Questo parametro è applicabile solo per Linux.
`collection_configuration.workload_validation_metrics_frequency`	`Int` La frequenza di raccolta delle metriche di valutazione del Gestore carichi di lavoro in secondi. Il valore predefinito è `300` secondi. Ti consigliamo di non modificare la frequenza di raccolta predefinita, poiché potrebbe influire sull'intera funzionalità stessa. Se devi modificare la frequenza di raccolta delle metriche di Gestore carichi di lavoro, 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` e consente all'agente di raccogliere il set più recente di metriche di valutazione del Gestore carichi di lavoro senza che sia necessario aggiornare l'agente. Se vuoi disattivare questo comportamento, specifica questo parametro nel file di configurazione e impostane il 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_secret_name`	`String` Specifica il nome del secret in Secret Manager in cui è archiviata la password dell'account utente. In alternativa, puoi specificare il parametro di configurazione `hdbuserstore_key` per autenticare l'utente SAP HANA specificato.
`collection_configuration.workload_validation_db_metrics_config.hdbuserstore_key`	`String` Per connetterti in modo sicuro a un sistema SAP HANA, specifica una chiave Secure User Store (`hdbuserstore`) che hai creato per il sistema. Per utilizzare una chiave `hdbuserstore` per l'autenticazione, verifica quanto segue: Gli strumenti SAP `hdbsql` e `hdduserstore` sono installati sull'istanza di computing che ospita l'agente. La chiave `hdbuserstore` corrisponde a un'istanza SAP HANA specifica. Non puoi utilizzare chiavi che contengono nomi host di più istanze SAP HANA. Se specifichi `hdbuserstore_key`, puoi saltare la specifica dei parametri `hostname` e `port`.
`collection_configuration.workload_validation_db_metrics_config.sid`	`String` Specifica il SID della tua istanza SAP HANA.
`collection_configuration.workload_validation_db_metrics_config.hostname`	`String` Specifica l'identificatore della macchina, locale o remota, che ospita l'istanza SAP HANA. Di seguito sono riportati i valori supportati: Se l'host è una macchina locale, specifica la stringa `localhost` o l'indirizzo IP di loopback localhost, ad esempio `127.0.0.1`. Se l'host è una macchina remota, specifica il suo indirizzo IP interno o esterno.
`collection_configuration.workload_validation_db_metrics_config.port`	`String` Specifica la porta su cui la tua istanza SAP HANA accetta le query. Per la prima o unica istanza di database 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. Anche se puoi 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 parametro `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 del Gestore carichi di lavoro raccolte dall'agente, puoi:

Visualizza il file di log dell'agente:

Imposta il livello di log dell'agente su DEBUG:

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

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
```

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 Gestore carichi di lavoro 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 la tua istanza dell'agente è configurata per inviare log a Cloud Logging, puoi visualizzare i log dell'agente in Cloud Logging.
Crea ed esegui una valutazione per il carico di lavoro SAP in Workload Manager. Per maggiori 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 Best practice di Workload Manager per SAP.