Configurare la raccolta delle metriche di valutazione di Workload Manager

Version 3.8 (latest)keyboard_arrow_down

• Versione 3.8 (latest)
• Versione 2
• Versione 1

Questa guida mostra come configurare l'agente per SAP di Google Cloudin modo da raccogliere le metriche di valutazione di Workload Manager dai sistemi SAP.

Per informazioni su questa funzionalità, consulta Valutazione di Workload Manager utilizzando l'agente per SAP di Google Cloud.

Prima di iniziare

• Convalida l'installazione dell'agente per SAP di Google Cloud. 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 per SAP di Google Cloudsu Linux.

• Assicurati che l'API Workload Manager sia abilitata per il tuo Google Cloud progetto.

  Abilita l'API Workload Manager

Ruoli IAM obbligatori

Per assicurarti che l'account di servizio disponga delle autorizzazioni necessarie per consentire all'agente di Google Cloudper SAP di raccogliere le metriche di valutazione di Workload Manager, chiedi all'amministratore di concedere all'account di servizio i seguenti ruoli IAM per il progetto:

• Compute Viewer (roles/compute.viewer): per raccogliere le metriche di valutazione di Workload Manager dall'istanza Compute Engine che ospita il sistema SAP.
• Workload Manager Insights Writer (roles/workloadmanager.insightWriter): per scrivere le metriche raccolte nel data warehouse di Workload Manager.
• (Facoltativo) Secret Manager Secret Accessor (roles/secretmanager.secretAccessor): se utilizzi Secret Manager per memorizzare la password per connetterti al database SAP HANA.

Per saperne di più sulla concessione dei ruoli, consulta Gestisci l'accesso a progetti, cartelle e organizzazioni.

Questi ruoli predefiniti contengono le autorizzazioni necessarie per consentire all'agente di Google Cloudper SAP di raccogliere le metriche di valutazione di Workload Manager. Per visualizzare le autorizzazioni esatte richieste, espandi la sezione Autorizzazioni richieste:

Autorizzazioni obbligatorie

Per consentire all'agente per SAP di Google Clouddi raccogliere le metriche di valutazione di Workload Manager, sono necessarie le seguenti autorizzazioni:

• Per raccogliere le metriche di valutazione del Gestore carichi di lavoro dall'istanza Compute Engine host e scriverle nel data warehouse del Gestore carichi di lavoro:
  • monitoring.timeSeries.create
  • compute.zoneOperations.list
  • compute.disks.list
  • compute.nodeGroups.get
  • workloadmanager.insights.write
• Se utilizzi Secret Manager per archiviare la password per connetterti al database SAP HANA, per accedere al secret: secretmanager.versions.access

L'amministratore potrebbe anche assegnare all'account di servizio queste autorizzazioni con ruoli personalizzati o altri ruoli predefiniti.

Ruoli SAP HANA obbligatori

Per consentire all'agente di raccogliere le metriche dal database SAP HANA, assicurati che l'utente SAP HANA specificato nel file di configurazione dell'agente abbia il ruolo MONITORING.

Per informazioni su questo ruolo, consulta il documento SAP Ruoli di database standard.

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 le release periodiche di Agent for SAP potrebbero aggiungere o modificare le metriche utilizzate per la valutazione.

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

Installare un aggiornamento

Seleziona il tuo sistema operativo e segui i passaggi:

Abilita la raccolta delle metriche di valutazione del Gestore workload

Dalla versione 3.2, le nuove installazioni dell'agente per SAP di Google Cloudsono attivate per impostazione predefinita per raccogliere le metriche di valutazione di Workload Manager. Se stai eseguendo l'aggiornamento alla versione 3.2 da una versione precedente, puoi anche attivare esplicitamente la funzionalità. Per farlo, segui questa procedura.

1. Stabilisci una connessione SSH con l'istanza Compute Engine o con il server Bare Metal Solution.

2. Per consentire all'agente di raccogliere le metriche di valutazione del Gestore workload:

   sudo /usr/bin/google_cloud_sap_agent configure -feature=workload_evaluation -enable

3. Per attivare 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 anche tramite comandi. Per ulteriori informazioni, consulta Comandi di configurazione per l'agente per SAP di Google Cloud.

   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.
      • hostname: specifica l'identificatore della macchina, locale o remota, che ospita l'istanza SAP HANA.
      • port: specifica la porta del database su cui l'istanza SAP HANA accetta le query. Ad esempio, inserisci 30015 se il database del tenant è in ascolto sulla porta 30015.
      • sid: specifica l'SID dell'istanza SAP HANA

      • hana_db_password_secret_name: specifica il nome del segreto in Secret Manager che memorizza la password dell'account utente

        In alternativa al segreto, puoi utilizzare il parametro di configurazione hdbuserstore_key.

      • hdbuserstore_key: specifica la chiave hdbuserstore che autentica l'utente specificato per hana_db_user

        Se specifichi hdbuserstore_key, salta la specifica dei parametri hostname e port.

      Per informazioni su questi parametri, consulta Parametri di configurazione.

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

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

Parametri di configurazione

La tabella seguente illustra i parametri di configurazione dell'agente per SAP diGoogle Cloudspecifici 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.
cloud_properties.project_id	String Se il sistema SAP è in esecuzione su un server Bare Metal Solution, specifica l'ID progetto del Google Cloud progetto che stai utilizzando 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.
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 Google Cloud progetto 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.
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, consulta il codice dell'agente nel google-cloud-sap-agent repository GitHub 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 memorizza le informazioni raccolte sull'host e non le invia a Cloud Logging.
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. 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_collection_definition.fetch_latest_config	Boolean Facoltativo. Il valore predefinito è true, che consente all'agente di raccogliere l'ultimo insieme di metriche di valutazione di Workload Manager senza che tu debba aggiornarlo. 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	String Specifica la password per l'account utente utilizzato per eseguire query sull'istanza SAP HANA. Per l'autenticazione SAP HANA, l'agente utilizza il seguente ordine di preferenza: se specificato, il parametro di configurazione hdbuserstore_key è preferito rispetto al parametro hana_db_password, che è preferito rispetto al parametro hana_db_password_secret_name. Ti consigliamo di impostare una sola opzione di autenticazione nel file di configurazione.
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 parametro di configurazione hdbuserstore_key per autenticare l'utente SAP HANA specificato. Per l'autenticazione SAP HANA, l'agente utilizza il seguente ordine di preferenza: se specificato, il parametro di configurazione hdbuserstore_key è preferito rispetto al parametro hana_db_password, che è preferito rispetto al parametro hana_db_password_secret_name. Ti consigliamo di impostare una sola opzione di autenticazione nel file di configurazione.
collection_configuration.workload_validation_db_metrics_config.hdbuserstore_key	String Per connetterti in sicurezza a un sistema SAP HANA, specifica una chiave Secure User Store (hdbuserstore) che hai creato per quel sistema. 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 gli hostname di più istanze SAP HANA. L'utente SIDadm può eseguire query sul database SAP HANA utilizzando questa chiave. Qui SID si riferisce al valore specificato per il parametro sid. Puoi verificarlo eseguendo il seguente comando come utente SIDadm: 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 specifica dei parametri hostname e port. Per l'autenticazione SAP HANA, l'agente utilizza il seguente ordine di preferenza: se specificato, il parametro di configurazione hdbuserstore_key è preferito rispetto al parametro hana_db_password, che è preferito rispetto al parametro hana_db_password_secret_name. Ti consigliamo di impostare una sola opzione di autenticazione nel file di configurazione.
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.

Convalida la configurazione per la raccolta delle metriche di valutazione di Workload Manager

Puoi verificare se hai eseguito la Google Cloud configurazione corretta per la raccolta delle metriche di valutazione di Workload Manager eseguendo il comando status dell'agente. Questo comando è supportato dalla versione 3.7 dell'agente.

Per convalidare la Google Cloud configurazione, completa i seguenti passaggi:

1. Stabilisci una connessione SSH con l'istanza Compute Engine.
2. Esegui questo comando:

   sudo /usr/bin/google_cloud_sap_agent status

   Se la Google Cloud configurazione per la raccolta delle metriche di valutazione di Workload Manager è corretta, l'output include quanto segue. La configurazione potrebbe avere valori diversi da quelli di default.

       Agent Status:
           ...
           Systemd Service Enabled: True
           Systemd Service Running: True
           Cloud API Full Scopes: True
           Configuration File: /etc/google-cloud-sap-agent/configuration.json
           Configuration Valid: True
       ...
       ----------------------------------------------------------------------------
       System Discovery: Enabled
           Status: Fully Functional
           IAM Permissions: All granted
           Configuration:
               enable_discovery:                  true  (default)
               enable_workload_discovery:         true  (default)
               sap_instances_update_frequency:    60    (default)
               system_discovery_update_frequency: 14400 (default)
       ----------------------------------------------------------------------------
       Workload Manager Evaluation: Enabled
           Status: Fully Functional
           IAM Permissions: All granted
           Configuration:
               collect_workload_validation_metrics:      true       (default)
               config_target_environment:                PRODUCTION (default)
               fetch_latest_config:                      true       (default)
               workload_validation_db_metrics_frequency: 3600       (default)
               workload_validation_metrics_frequency:    300        (default)
       ...
       

3. Se l'output indica che manca una configurazione, esamina le informazioni fornite nelle sezioni precedenti, esegui le azioni richieste, quindi esegui di nuovo il comando status per convalidare nuovamente la configurazione.

Visualizzare le metriche raccolte

Per visualizzare le metriche di valutazione di Workload Manager raccolte dall'agente:

• 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 file di log dell'agente:

     /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 le metriche di valutazione di Workload Manager 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 tuo carico di lavoro SAP in Workload Manager. Per ulteriori informazioni, consulta Creare ed eseguire una valutazione.

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