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

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:

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

  1. Nella console Google Cloud, vai alla pagina IAM.

    Vai a IAM

  2. Selezionare il tuo progetto Google Cloud.

  3. 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.
  4. 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
  5. 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

  1. Stabilisci una connessione SSH con l'istanza.
  2. 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

  1. Stabilisci una connessione SSH con la tua istanza.
  2. 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.

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

  2. 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

  3. 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.

  4. 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.

  5. Salva il file di configurazione.

  6. 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.

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:

    1. Imposta il livello di log dell'agente su DEBUG:

      sudo /usr/bin/google_cloud_sap_agent configure -loglevel=debug
    2. 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
    3. 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.