Questa pagina è stata tradotta dall'API Cloud Translation.

Versione 2: configura la raccolta delle metriche di valutazione del Gestore carichi di lavoro

Questa guida mostra come configurare la versione 2 dell'Agente di 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 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.

Imposta ruoli IAM

Per consentire all'agente di Google Cloud per SAP di raccogliere le metriche di valutazione di Workload Manager, 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)
Autore delle metriche di Monitoring (roles/monitoring.metricWriter)
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
- Monitoring > Writer metriche Monitoring
- Secret Manager > Funzione di accesso ai secret di Secret Manager
Fai clic su Aggiungi o Salva per applicare i ruoli all'account di servizio.

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

Per attivare la raccolta delle metriche di valutazione del Gestore carichi di lavoro utilizzando l'agente di Google Cloud per SAP, segui questi passaggi:

Stabilisci una connessione SSH con la tua istanza VM di Compute Engine o con il server Bare Metal Solution.

Apri il file di configurazione dell'agente:

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

Nella sezione collection_configuration, per il parametro collect_workload_validation_metrics, imposta il valore true.
Per abilitare la raccolta della metrica workload.googleapis.com/sap/validation/hanasecurity che abilita le regole di valutazione della sicurezza in Workload Manager, 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 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 l'istanza SAP HANA.
- port: specifica la porta sulla quale la tua istanza SAP HANA accetta le query.
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`.
`sap_system_discovery`	`Boolean` Per abilitare il rilevamento del sistema SAP, 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. Nella versione 2.5 o precedenti dell'agente, specifica il nome del server Bare Metal Solution per la proprietà `instance_id`.
`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.
`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_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 autenticare l'utente SAP HANA specificato per `hana_db_user`, specifica una chiave `hdbuserstore` che hai creato per l'utente. Per utilizzare una chiave `hdbuserstore` per l'autenticazione, assicurati di soddisfare le seguenti condizioni: 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.