Questa pagina è stata tradotta dall'API Cloud Translation.

Versione 2: configura la raccolta delle metriche di valutazione di Workload Manager

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 sistemi SAP.

Per informazioni su questa funzionalità, consulta Valutazione di Workload Manager mediante 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 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 di Google Cloud per SAP su Linux.

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:

Visualizzatore di calcolo (roles/compute.viewer)
Monitoring Metric Writer (roles/monitoring.metricWriter)
Secret Manager Secret Accessor (roles/secretmanager.secretAccessor), se utilizzi Secret Manager per memorizzare la password del database SAP HANA.

Per aggiungere questi ruoli obbligatori al tuo account di servizio:

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à 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.
Seleziona il ruolo richiesto dall'elenco dei ruoli disponibili:
- Visualizzatore Compute
- Monitoraggio > Monitoring Metric Writer
- Secret Manager > Secret Manager Secret Accessor
Fai clic su Aggiungi o Salva per applicare i ruoli all'account di servizio.

Abilita la raccolta delle metriche di valutazione del Gestore workload

Per attivare la raccolta delle metriche di valutazione di Workload Manager utilizzando l'agente di Google Cloud per SAP:

Stabilisci una connessione SSH con l'istanza 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 attivare la raccolta della metrica workload.googleapis.com/sap/validation/hanasecurity che attiva le regole di valutazione della sicurezza in Workload Manager, 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 utilizzato per eseguire query sull'istanza SAP HANA.
- hana_db_password_secret_name: specifica il nome del segreto in Secret Manager che memorizza la password dell'account utente.
- 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.
Per informazioni su questi parametri, consulta Parametri di configurazione.
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.
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 Compute Engine

L'esempio seguente è un file di configurazione completo della versione 2 dell'agente di Google Cloud per SAP in esecuzione su un , in cui è attivata 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",
      "hana_db_password_secret_name": "instance-id-hana-db-password-secret",
      "hostname": "localhost",
      "port": "30015"
    },
    "collect_process_metrics": false,
    "sap_system_discovery": true
  },
  "hana_monitoring_configuration": {
    "enabled": false
  }
}

Server Bare Metal Solution

L'esempio seguente è un file di configurazione completo della versione 2 dell'agente di Google Cloud per SAP in esecuzione su un server Bare Metal Solutiondi Compute Engine, in cui è attivata 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",
      "sid": "DEH",
      "hana_db_password_secret_name": "instance-id-hana-db-password-secret",
      "hostname": "localhost",
      "port": "30015"
    },
    "collect_process_metrics": false,
    "sap_system_discovery": true
  },
  "cloud_properties": {
    "project_id": "my-project",
    "instance_name": "bms-machine-1",
    "region": "us-central1"
    "image": "rhel-8"
  },
  "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`.
`sap_system_discovery`	`Boolean` Per attivare il rilevamento del sistema SAP, 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. Nell'agente versione 2.5 o precedente, specifica il nome del server Bare Metal Solution per la proprietà `instance_id`.
`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.
`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. 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 di Workload Manager, 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`	`String` Specifica la password per l'account utente utilizzato per eseguire query sull'istanza SAP HANA.
`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.
`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.