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 l'Agente per SAP di Google Cloud per raccogliere Metriche di valutazione del Gestore carichi di lavoro dai tuoi sistemi SAP.

Per informazioni su questa funzione, vedi Valutazione di Workload Manager utilizzando l'agente di Google Cloud per SAP.

Prima di iniziare

Convalida l'installazione dell'agente di Google Cloud per SAP. Per istruzioni, vedi il guida all'installazione per il tuo scenario.
Se hai installato l'agente su un server Bare Metal Solution, assicurati che di aver completato i prerequisiti richiesti e di aver configurato un servizio . Per le istruzioni, consulta Configurare l'agente di 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

Consentire all'agente Google Cloud per SAP di raccogliere il Gestore carichi di lavoro. di valutazione, devi assicurarti che l'account di servizio utilizzato L'istanza VM di Compute Engine o il server Bare Metal Solution include ruoli:

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

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 all'indirizzo email dell'account di servizio.
- Se l'account di servizio è già nell'elenco delle entità, allora ha account ruoli. Fai clic sul pulsante Modifica per l'account di servizio che vuoi modifica.
Seleziona il ruolo richiesto dall'elenco di ruoli disponibili:
- Visualizzatore Compute
- Gestione dei 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 Agente per SAP per una valutazione accurata dei tuoi carichi di lavoro SAP le versioni periodiche dell'agente per SAP potrebbero aggiungere o modificare le metriche usato per la valutazione.

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

Installa un aggiornamento

Seleziona il tuo sistema operativo, quindi segui questi passaggi:

RHEL

Stabilisci una connessione SSH con l'istanza.
Aggiorna l'istanza dell'agente:
- (Consigliato) Per eseguire l'aggiornamento alla versione 3.5 (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 l'ID dell'agente che vuoi installare, ad esempio 3.1-606637668. Per informazioni sull'agente che puoi installare, vedi Elenca tutte le opzioni disponibili tutte le versioni dell'agente.

SLES

Stabilisci una connessione SSH con la tua istanza.
Aggiorna l'istanza dell'agente:
- (Consigliato) Per eseguire l'aggiornamento alla versione 3.5 (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 l'ID dell'agente che vuoi installare, ad esempio 3.1-606637668. Per informazioni sull'agente che puoi installare, vedi Elenca tutte le opzioni disponibili tutte le versioni 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 vengono abilitate per impostazione predefinita raccolgono 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 oppure server Bare Metal Solution.
Per consentire all'agente di raccogliere Metriche di valutazione di Gestore dei carichi di lavoro:
```
sudo /usr/bin/google_cloud_sap_agent configure -feature=workload_evaluation -enable
```
Per abilitare la raccolta dei dati "SAP HANA Insights" e "Best practice sulla sicurezza SAP HANA" metriche:
1. Apri il file di configurazione dell'agente:
```
/etc/google-cloud-sap-agent/configuration.json
```
  In alternativa, puoi anche eseguire questa configurazione dei 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 e specifica quanto segue 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 che ospita la tua 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 che memorizza la password dell'account utente
    
    In alternativa al secret, puoi utilizzare hdbuserstore_key di configurazione del deployment.
  - hdbuserstore_key: specifica la chiave hdbuserstore che autentica l'utente specificato per hana_db_user
    
    Se specifichi hdbuserstore_key, salti la specifica del Parametri hostname e port.
  Per informazioni su questi parametri, consulta Parametri di configurazione.
Se vuoi, nella sezione cloud_properties puoi aggiornare i valori parametro che vengono impostati automaticamente. A questo scopo, aggiungi la sezione cloud_properties al tuo di configurazione del deployment e specificare 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 completato di Google Cloud per SAP in esecuzione su una Istanza VM Compute Engine, in cui la raccolta delle metriche di valutazione del Gestore carichi di lavoro attivato:

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

Server Bare Metal Solution

L'esempio seguente è un file di configurazione completato di Google Cloud per SAP in esecuzione su una Server Bare Metal Solution, in cui la raccolta delle metriche di valutazione del Gestore carichi di lavoro attivato:

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

Parametri di configurazione

La tabella seguente illustra i parametri di configurazione di Google Cloud per SAP specifici per la raccolta Metriche di valutazione del Gestore carichi di lavoro.

Parametri
`provide_sap_host_agent_metrics`	`Boolean` Per abilitare la raccolta delle metriche richieste dalla 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 è 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 sono gestite 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: specificare l'ID del progetto Google Cloud che stai 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, e specificare il nome dell'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 sistema SAP è in esecuzione su un server Bare Metal Solution, e specifica l'area geografica del server Bare Metal Solution. Quando l'agente viene eseguito su un'istanza VM, per impostazione predefinita utilizza dell'istanza VM su cui è installato l'agente.
`cloud_properties.zone`	`String` Quando l'agente viene eseguito su un'istanza VM, per impostazione predefinita utilizza la zona dell'istanza VM su cui è installato l'agente.
`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 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 che il sistema SAP è in esecuzione. 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 ulteriori informazioni, controlla il codebase dell'agente nella `google-cloud-sap-agent` repository GitHub in GoogleCloudPlatform/sapagent.
`discovery_configuration.enable_discovery`	`Boolean` a inviare a Cloud Logging le informazioni raccolte dall'agente. per i prodotti SAP in esecuzione sull'host, specifica `true`. La il valore predefinito è `true`. Se specifichi il valore `false`, l'agente archivia il valore ha raccolto informazioni 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, specificare `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 del Gestore carichi di lavoro le metriche di valutazione in pochi secondi. Il valore predefinito è `300` secondi. Ti consigliamo di non modificare il valore predefinito la frequenza di raccolta dei dati, poiché potrebbe influire sull'intera funzionalità stessa. Se devi modificare la frequenza di raccolta del le metriche di Gestore carichi di lavoro, quindi aggiungi `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 per raccogliere l'ultimo set di valutazioni del Gestore carichi di lavoro senza dover aggiornare l'agente. Se vuoi disattivare questo comportamento, specifica questo parametro nel file di configurazione e e imposta il suo 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 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. In alternativa, puoi specificare il valore `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 un Chiave di archivio utenti sicuro (`hdbuserstore`) che hai creato di un sistema operativo completo. 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 nomi host di più istanze SAP HANA. L'utente `SIDadm` può eseguire query su SAP HANA utilizzando questa chiave. In questo caso `SID` si riferisce specificato per il parametro `sid`. Puoi per verificarlo eseguendo questo comando come `SIDadm` utente: 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 procedura i 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 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 localhost, ad esempio `127.0.0.1`. Se l'host è un computer remoto, specifica il suo interno all'indirizzo IP 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 l'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 del Gestore carichi di lavoro. Il valore predefinito è `3600` secondi. Sebbene sia possibile aggiornare la frequenza di raccolta Metriche del database SAP HANA, ti consigliamo di utilizzare il valore predefinito. Se devi modificare il valore predefinito, aggiungi il parametro Parametro `workload_validation_db_metrics_frequency` in alla sezione `collection_configuration` e fornisci i requisiti valore. Assicurati di non impostare una frequenza di raccolta maggiore di `3600` secondi.

Visualizzare le metriche raccolte

a visualizzare le metriche di valutazione del Gestore carichi di lavoro che l'agente raccolte, puoi effettuare le seguenti operazioni:

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 log dell'agente file:
```
/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 il Gestore carichi di lavoro metriche di valutazione 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 carico di lavoro SAP in Gestore carichi di lavoro. Per ulteriori informazioni, vedi Crea ed esegui una valutazione.

Per informazioni sulle best practice utilizzate da Workload Manager per la valutazione dei carichi di lavoro SAP in esecuzione su Google Cloud, vedi Best practice di Workload Manager per SAP.