Versione 1: installa e configura l'agente di Google Cloud per SAP in un'istanza Compute Engine

L'agente di Google Cloud per SAP è necessario per il supporto SAP dei sistemi SAP in esecuzione su Google Cloud, tra cui SAP NetWeaver, SAP HANA, SAP ASE, SAP MaxDB e altri.

Quando installi l'agente di Google Cloud per SAP su un'istanza Compute Engine, per le metriche dell'agente host SAP, l'agente combina i dati di monitoraggio di Cloud Monitoring e delle API Compute Engine e li fornisce all'agente host SAP.

Se utilizzi le seguenti immagini del sistema operativo RHEL o SLES "for SAP" fornite da Google Cloud, l'agente di Google Cloud per SAP è pacchettizzato con le immagini del sistema operativo:

• RHEL: tutte le immagini "per SAP"
• SLES: SLES 15 SP4 for SAP e versioni successive

Per informazioni sui sistemi operativi supportati dall'Agente per SAP di Google Cloud, consulta Sistemi operativi supportati.

Per installare e configurare la versione 1 dell'agente di Google Cloud per SAP su un server Bare Metal Solution, consulta Installare l'agente di Google Cloud per SAP su un server Bare Metal Solution.

Panoramica dell'installazione

Su Linux, installa l'agente di Google Cloud per SAP utilizzando i comandi di gestione dei pacchetti del sistema operativo standard: su RHEL, il comando yum; su SLES, il comando zypper. Il comando di gestione dei pacchetti completa le seguenti attività:

• Scarica l'agente di Google Cloud per SAP.
• Crea l'agente come servizio systemd Linux denominato google-cloud-sap-agent.
• Attiva e avvia il servizio google-cloud-sap-agent.

Su Windows, installa l'agente di Google Cloud per SAP utilizzando il comando di gestione del pacchetto GooGet, googet. Il comando di gestione dei pacchetti completa le seguenti attività:

• Scarica l'agente di Google Cloud per SAP.

• Crea un servizio Windows denominato google-cloud-sap-agent e un'attività pianificata che viene eseguita ogni minuto per verificare se il servizio è ancora in esecuzione e, se necessario, riavviarlo.

Prerequisiti per l'agente

Prima di installare l'agente di Google Cloud per SAP, devi assicurarti che siano soddisfatti i seguenti prerequisiti.

Imposta i ruoli IAM richiesti

Come minimo, l'account di servizio utilizzato dall'Agent for SAP di Google Cloud deve includere i ruoli Visualizzatore Compute (roles/compute.viewer), Visualizzatore monitoraggio (roles/monitoring.viewer) e Writer di Workload Manager Insights (roles/workloadmanager.insightWriter).

Per aggiungere un ruolo obbligatorio all'account di servizio:

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

4. Seleziona il ruolo richiesto dall'elenco dei ruoli disponibili:

   • Compute Engine > Visualizzatore Compute
   • Monitoraggio > Visualizzatore monitoraggio
   • Workload Manager > Workload Manager Insights Writer

5. Fai clic su Aggiungi o Salva per applicare i ruoli all'account di servizio.

Abilita l'accesso alle API Google Cloud

Compute Engine consiglia di configurare le istanze di calcolo in modo da consentire tutti gli ambiti di accesso a tutte le API Cloud e di utilizzare solo le autorizzazioni IAM dell'account di servizio dell'istanza per controllare l'accesso alle risorse Google Cloud. Per ulteriori informazioni, consulta Creare una VM che utilizza un account di servizio gestito dall'utente.

Se limiti l'accesso alle API Cloud, Agent for SAP di Google Cloud richiede i seguenti ambiti di accesso alle API Cloud minimi sull'istanza Compute Engine di hosting:

• Piattaforma cloud: Attivata
• Compute Engine: Sola lettura
• API Stackdriver Monitoring: sola lettura

Se esegui applicazioni SAP su un'istanza di calcolo che non ha un indirizzo IP esterno, devi attivare l'accesso privato Google nella sottorete dell'istanza di calcolo in modo che l'agente di Google Cloud per SAP possa accedere alle API e ai servizi Google. Per abilitare l'accesso privato Google su una subnet, consulta la sezione Configurare l'accesso privato Google.

Installa l'agente

Ti consigliamo di installare la versione più recente dell'agente di Google Cloud per SAP, che supporta più funzionalità. Per le istruzioni, consulta Installare e configurare l'agente di Google Cloud per SAP in un'istanza Compute Engine.

Per installare la versione 1 dell'agente di Google Cloud per SAP, contatta assistenza clienti Google Cloud.

Dopo aver installato l'agente di Google Cloud per SAP e l'agente host SAP, convalida l'installazione dell'agente di Google Cloud per SAP, come descritto in Convalidare l'installazione dell'agente.

Convalida l'installazione dell'agente

Per verificare che l'agente sia in esecuzione, seleziona il tuo sistema operativo e segui i passaggi:

Se l'agente non è in esecuzione, riavvialo.

Verificare che l'agente host SAP riceva le metriche

Per verificare che le metriche dell'infrastruttura vengano raccolte dall'agente di Google Cloud per SAP e inviate correttamente all'agente host SAP, segui questi passaggi:

1. Nel sistema SAP, inserisci la transazione ST06.

2. Nel riquadro di panoramica, controlla la disponibilità e i contenuti dei seguenti campi per la configurazione end-to-end corretta dell'infrastruttura di monitoraggio di SAP e Google:

   • Fornitore di servizi cloud: Google Cloud Platform
   • Accesso al monitoraggio avanzato: TRUE
   • Dettagli sul monitoraggio migliorato: ACTIVE

Configurare l'agente di Google Cloud per SAP su Linux

Dopo aver installato l'agente di Google Cloud per SAP, facoltativamente puoi configurarlo per abilitare la raccolta delle metriche di monitoraggio dei processi e delle metriche di valutazione di Workload Manager. Per impostazione predefinita, è abilitata la raccolta solo delle metriche dell'agente host SAP.

Le metriche di monitoraggio dei processi e la raccolta delle metriche di valutazione di Workload Manager sono supportate solo su Linux.

Se attivi la raccolta delle metriche di monitoraggio dei processi e delle metriche di valutazione del Gestore carichi di lavoro, l'account di servizio dell'istanza di calcolo host deve includere il ruolo IAM Monitoring Metric Writer (roles/monitoring.metricWriter).

Se utilizzi Secret Manager per memorizzare la password del database SAP HANA, assicurati che l'account di servizio dell'istanza di calcolo host disponga del ruolo IAM Accesso ai secret di Secret Manager (roles/secretmanager.secretAccessor).

Gli ambiti di accesso dell'istanza di calcolo host devono avere l'accesso in scrittura per pubblicare i dati metrici nei tuoi progetti Google Cloud. Quando crei una nuova istanza di calcolo Compute Engine, viene automaticamente configurata con l'ambito di accesso in scrittura https://www.googleapis.com/auth/monitoring.write.

Imposta i ruoli IAM richiesti

Per aggiungere un ruolo obbligatorio all'account di servizio:

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

4. Seleziona il ruolo richiesto dall'elenco dei ruoli disponibili:

   • Monitoraggio > Monitoring Metric Writer
   • Secret Manager > Secret Manager Secret Accessor

5. Fai clic su Aggiungi o Salva per applicare i ruoli all'account di servizio.

Abilita la raccolta delle metriche di monitoraggio dei processi e delle metriche di valutazione di Workload Manager

Per attivare la raccolta delle metriche di monitoraggio dei processi e delle metriche di valutazione di Workload Manager:

1. Stabilisci una connessione SSH con l'istanza di calcolo host.

2. Apri il seguente file di configurazione:

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

3. Nella sezione collection_configuration, imposta i seguenti parametri su true:

   • collect_process_metrics: consente all'agente di raccogliere le metriche di monitoraggio dei processi. Per la raccolta delle metriche del database SAP HANA, per accedere al database SAP HANA ed eseguire query, devi configurare parametri aggiuntivi nella sezione hana_metrics_config.
   • collect_workload_validation_metrics: consente all'agente di raccogliere le metriche di valutazione di Workload Manager.

   Per ulteriori informazioni sui parametri, consulta la tabella seguente.

4. Se vuoi, in 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 obbligatori 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

Parametri di configurazione

La tabella seguente illustra i parametri di configurazione della versione 1 dell'agente di Google Cloud per SAP.

Configurazione predefinita

{
  "provide_sap_host_agent_metrics": true,
  "log_level": "INFO",
  "log_to_cloud": true,
  "collection_configuration": {
    "collect_workload_validation_metrics": false,
    "collect_process_metrics": false
  }
}

Configurazione di esempio

Per installare l'agente su un'istanza Compute Engine, tutti i parametri e i valori di configurazione sono facoltativi. Se il file di configurazione non viene modificato, viene utilizzata la configurazione predefinita. L'esempio seguente mostra un file di configurazione completato per l'installazione dell'agente in un'istanza di calcolo.

{
  "provide_sap_host_agent_metrics": true,
  "bare_metal": false,
  "log_level": "INFO",
  "log_to_cloud": true,
  "collection_configuration": {
    "collect_workload_validation_metrics": false,
    "collect_process_metrics": true,
    "hana_metrics_config": {
      "hana_db_user": "user",
      "hana_db_password_secret_name": "secret-name"
      }
    }
}

Visualizzare le metriche raccolte

Per visualizzare le metriche di monitoraggio dei processi raccolte dall'agente, puoi utilizzare le seguenti dashboard personalizzate fornite da Google Cloud:

• Agente per SAP - Panoramica di HANA: Questa dashboard fornisce grafici che mostrano una panoramica dello stato per le seguenti metriche: Disponibilità SAP HANA, Disponibilità SAP HANA HA, Repliche SAP HANA HA, Stato servizio SAP HANA, Cluster HA - Stato nodo e Cluster HA - Stato risorsa per le istanze SAP.

  Il file JSON di questa dashboard è sap-agent-status-overview.json.

• Agente per SAP - Metriche non elaborate di HANA: Questa dashboard fornisce grafici che mostrano i valori non elaborati delle seguenti metriche: Disponibilità SAP HANA, Disponibilità HA SAP HANA, Repliche HA SAP HANA, Stato servizio SAP HANA, Cluster HA - Stato del nodo e Cluster HA - Stato della risorsa per le istanze SAP.

  Il file JSON di questa dashboard è sap-agent-raw-metrics.json.

Installare le dashboard

Per installare una dashboard personalizzata:

Visualizzare le dashboard installate

Per visualizzare le dashboard installate:

1. Nella console Google Cloud, vai alla pagina Monitoraggio:

   Vai a Monitoring

2. Nel pannello di navigazione Monitoraggio, fai clic su Dashboard.

3. Fai clic sul nome della dashboard nell'elenco.

Se hai molte dashboard, puoi filtrare in base alle dashboard personalizzate o al nome della nuova dashboard. Per informazioni su come filtrare questo elenco, consulta Visualizzare le dashboard personalizzate.

L'immagine seguente è un esempio che mostra una parte della dashboard personalizzata per le metriche SAP HANA in Monitoring.

Risoluzione dei problemi

Per informazioni su come diagnosticare e risolvere i problemi che potresti riscontrare durante l'installazione e la configurazione dell'agente di Google Cloud per SAP, consulta la guida alla risoluzione dei problemi dell'agente di Google Cloud per SAP.

Assistenza

Se hai bisogno di aiuto per risolvere i problemi relativi all'agente per SAP di Google Cloud, raccogli tutte le informazioni di diagnostica disponibili e contatta l'assistenza clienti Google Cloud. Per informazioni su come contattare il team dell'assistenza clienti, consulta Assistenza per SAP su Google Cloud.