Questa pagina è stata tradotta dall'API Cloud Translation.

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

Questa guida mostra come configurare l'agente Google Cloud per SAP 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 per SAP di Google Cloud.

Prima di iniziare

Convalida l'installazione dell'agente di Google Cloud per SAP. Per 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 Google Cloud per SAP su Linux.
Assicurati che l'API Workload Manager sia abilitata per il tuo progetto. Per le istruzioni, consulta 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 seguenti ruoli:

Visualizzatore Compute (roles/compute.viewer)
Writer insight su Workload Manager (roles/workloadmanager.insightWriter)
Funzione di accesso ai secret di Secret Manager (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 avrà alcun ruolo assegnato. Fai clic su Aggiungi e inserisci l'indirizzo email dell'account di servizio.
- Se l'account di servizio è già nell'elenco delle entità, ha 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
- Gestore 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 release periodiche dell'agente per SAP potrebbero aggiungere o modificare le metriche utilizzate per la valutazione.

Per assicurarti di disporre della 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 segui i passaggi:

RHEL

Stabilisci una connessione SSH con l'istanza.
Aggiorna l'istanza dell'agente:
- (Consigliato) Per eseguire l'aggiornamento alla versione 3.2 (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

Stabilisci una connessione SSH con l'istanza.
Aggiorna l'istanza dell'agente:
- (Consigliato) Per eseguire l'aggiornamento alla versione 3.2 (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 di metriche di valutazione del Gestore carichi di lavoro

A partire dalla versione 3.2, le nuove installazioni dell'agente per SAP di Google Cloud sono abilitate per impostazione predefinita per raccogliere le metriche di valutazione di Workload Manager. Se esegui 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 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_validation -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 eseguire questa configurazione tramite 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, quindi specifica i seguenti parametri:
  - hana_db_user: specifica l'account utente del database SAP HANA utilizzato per eseguire query sull'istanza SAP HANA.
  - hana_db_password_secret_name: specifica il nome del secret in Secret Manager in cui è archiviata la password dell'account utente.
  - hostname: specifica l'identificatore della macchina, locale o remota, che ospita la tua istanza SAP HANA.
  - port: specifica la porta su cui l'istanza SAP HANA accetta le query.
  Per informazioni su questi parametri, consulta Parametri di configurazione.
Se vuoi, 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 di 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",
      "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 di Workload Manager:

{
  "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",
      "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 seguente tabella 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 richiesto dall'assistenza clienti Google Cloud o dall'Assistenza SAP.
`bare_metal`	`Boolean` Quando l'agente viene 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 richiesto 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 tuo sistema SAP è in esecuzione su un'istanza VM di Compute Engine, specifica il nome dell'istanza VM. L'agente rileva automaticamente il nome dell'istanza VM al momento dell'installazione. Se il tuo 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. Quando l'agente viene eseguito su un'istanza VM, per impostazione predefinita utilizza la regione dell'istanza VM in cui è installato.
`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 per l'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.
`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 a 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, in quanto potrebbe influire sull'intera funzionalità. Se devi modificare la frequenza di raccolta delle metriche del 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`, che 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 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_secret_name`	`String` Specifica il nome del secret in Secret Manager in cui è archiviata la password dell'account utente.
`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 è una macchina locale, specifica la stringa `localhost` o l'indirizzo IP di loopback del 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 la tua istanza SAP HANA accetta le query. Per la prima o la sola 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.