L'agente di Google Cloud per SAP è richiesto 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 per SAP di Google Cloud su un'istanza VM di 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 fornisce questi dati all'agente host SAP.
Se utilizzi le seguenti immagini RHEL o SLES "for SAP" per sistema operativo fornite da Google Cloud, l'agente per SAP di Google Cloud viene pacchettizzato con le immagini del sistema operativo:
- RHEL: tutte le immagini "for SAP"
- SLES: SLES 15 SP4 per SAP e versioni successive
Per informazioni sui sistemi operativi supportati da Agent for SAP di Google Cloud, consulta Sistemi operativi supportati.
Per installare e configurare la versione 1 dell'agente per SAP di Google Cloud su un server Bare Metal Solution, consulta Installare l'agente Google Cloud per SAP su un server Bare Metal Solution.
Panoramica dell'installazione
In Linux, l'agente per SAP di Google Cloud viene installato 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 Linux
systemd, denominatogoogle-cloud-sap-agent. - Abilita e avvia il servizio
google-cloud-sap-agent.
Su Windows, installa l'agente per SAP di Google Cloud utilizzando il comando di gestione dei pacchetti 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-agente 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 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'agente di Google Cloud per SAP deve includere i ruoli Visualizzatore Compute (roles/compute.viewer), Visualizzatore Monitoring (roles/monitoring.viewer) e Writer Workload Manager Insights (roles/workloadmanager.insightWriter).
Per aggiungere un ruolo obbligatorio al tuo account di servizio:
Nella console Google Cloud, vai alla pagina 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 avrà alcun ruolo assegnato. Fai clic su Aggiungi e inserisci l'indirizzo email dell'account di servizio.
- Se l'account di servizio è già nell'elenco delle entità, ha ruoli esistenti. Fai clic sul pulsante Modifica per l'account di servizio che vuoi modificare.
Seleziona il ruolo richiesto dall'elenco di ruoli disponibili:
- Compute Engine > Visualizzatore Compute
- Monitoring > Visualizzatore Monitoring
- Gestore carichi di lavoro > Writer insight Gestore carichi di lavoro
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 VM 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 maggiori informazioni, consulta Creare una VM che utilizza un account di servizio gestito dall'utente.
Se limiti l'accesso alle API Cloud, l'agente per SAP di Google Cloud richiede i seguenti ambiti minimi di accesso all'API Cloud sull'istanza VM host:
- Cloud Platform: abilitato
- Compute Engine: sola lettura
- API Stackdriver Monitoring: sola lettura
Se esegui applicazioni SAP su un'istanza VM che non ha un indirizzo IP esterno, devi abilitare l'accesso privato Google nella subnet della VM 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 Configurazione dell'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 su un'istanza VM di Compute Engine.
Per installare la versione 1 dell'agente di Google Cloud per SAP, contatta l'assistenza clienti Google Cloud.
Dopo aver installato l'agente Google Cloud per SAP e l'agente host SAP, convalida l'installazione dell'agente Google Cloud per SAP, come descritto nella sezione Convalidare l'installazione dell'agente.
Convalida l'installazione dell'agente
Per verificare che l'agente sia in esecuzione, seleziona il sistema operativo, quindi segui questi passaggi:
Linux
Stabilisci una connessione SSH con la tua istanza VM host.
Esegui questo comando:
systemctl status google-cloud-sap-agent
Se l'agente funziona correttamente, l'output contiene
active (running). Ad esempio:google-cloud-sap-agent.service - Google Cloud Agent for SAP Loaded: loaded (/usr/lib/systemd/system/google-cloud-sap-agent.service; enabled; vendor preset: disabled) Active: active (running) since Fri 2022-12-02 07:21:42 UTC; 4 days ago Main PID: 1337673 (google-cloud-sa) Tasks: 9 (limit: 100427) Memory: 22.4 M (max: 1.0G limit: 1.0G) CGroup: /system.slice/google-cloud-sap-agent.service └─1337673 /usr/bin/google-cloud-sap-agent
Windows
Utilizza RDP per la connessione all'istanza VM.
In qualità di amministratore, esegui questo comando da PowerShell:
$(Get-Service -Name 'google-cloud-sap-agent' -ErrorAction Ignore).Status
Se l'agente è in esecuzione, lo stato mostraRunning.
Se l'agente non è in esecuzione, riavvialo.
Verificare che l'agente host SAP stia ricevendo le metriche
Per verificare che le metriche dell'infrastruttura vengano raccolte dall'agente per SAP di Google Cloud e inviate correttamente all'agente host SAP, segui questi passaggi:
- Nel tuo sistema SAP, inserisci la transazione
ST06. Nel riquadro Panoramica, controlla la disponibilità e il contenuto dei seguenti campi per la corretta configurazione end-to-end dell'infrastruttura di monitoraggio SAP e Google:
- Cloud Provider:
Google Cloud Platform - Accesso a Monitoring avanzato:
TRUE - Dettagli sul monitoraggio avanzato:
ACTIVE
- Cloud Provider:
Configura l'agente di Google Cloud per SAP su Linux
Dopo aver installato l'agente per SAP di Google Cloud, facoltativamente puoi configurare l'agente per abilitare la raccolta di metriche di monitoraggio dei processi e di metriche di valutazione di Workload Manager. Per impostazione predefinita, è abilitata solo la raccolta delle metriche dell'agente host SAP.
Le metriche di monitoraggio dei processi e la raccolta di metriche di valutazione del Gestore carichi di lavoro sono supportate solo su Linux.
Se abiliti la raccolta delle metriche di monitoraggio dei processi e la raccolta delle metriche di valutazione del Gestore carichi di lavoro, l'account di servizio dell'istanza VM host deve includere il ruolo IAM Writer metriche Monitoring (roles/monitoring.metricWriter).
Se utilizzi Secret Manager per archiviare la password del database SAP HANA, assicurati che l'account di servizio dell'istanza VM host abbia il ruolo IAM Accessore ai secret (roles/secretmanager.secretAccessor) di Secret Manager.
Gli ambiti di accesso dell'istanza VM host devono disporre dell'accesso in scrittura per pubblicare i dati delle metriche nei progetti Google Cloud.
Quando crei una nuova istanza VM di Compute Engine, questa viene configurata automaticamente con l'ambito di accesso in scrittura, https://www.googleapis.com/auth/monitoring.write.
Imposta i ruoli IAM richiesti
Per aggiungere un ruolo obbligatorio al tuo account di servizio:
Nella console Google Cloud, vai alla pagina 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 avrà alcun ruolo assegnato. Fai clic su Aggiungi e inserisci l'indirizzo email dell'account di servizio.
- Se l'account di servizio è già nell'elenco delle entità, ha ruoli esistenti. Fai clic sul pulsante Modifica per l'account di servizio che vuoi modificare.
Seleziona il ruolo richiesto dall'elenco di ruoli disponibili:
- Monitoring > Writer metriche Monitoring
- Secret Manager > Funzione di accesso ai secret di Secret Manager
Fai clic su Aggiungi o Salva per applicare i ruoli all'account di servizio.
Abilita metriche di monitoraggio dei processi e raccolta di metriche di valutazione del Gestore carichi di lavoro
Per abilitare la raccolta delle metriche di monitoraggio dei processi e del Gestore carichi di lavoro:
- Stabilisci una connessione SSH con l'istanza VM host.
Apri il file di configurazione seguente:
/etc/google-cloud-sap-agent/configuration.json
Nella sezione
collection_configuration, imposta i seguenti parametri sutrue:collect_process_metrics: consente all'agente di raccogliere metriche di monitoraggio dei processi. Per la raccolta delle metriche del database SAP HANA, per accedere al database SAP HANA ed eseguire query è necessario configurare parametri aggiuntivi nella sezionehana_metrics_config.collect_workload_validation_metrics: consente all'agente di raccogliere metriche di valutazione di Workload Manager.
Per saperne di più sui parametri, consulta la tabella seguente.
Facoltativamente, in
cloud_propertiespuoi aggiornare i valori dei parametri impostati automaticamente. Per farlo, aggiungi la sezionecloud_propertiesal 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
Parametri di configurazione
La tabella seguente illustra i parametri di configurazione della versione 1 dell'agente per SAP di Google Cloud.
| Parametri | |
|---|---|
provide_sap_host_agent_metrics |
Per abilitare la raccolta delle metriche richieste dall'agente host SAP, specifica |
bare_metal |
Quando l'agente viene installato su un server Bare Metal Solution, specifica |
log_level |
Per impostare il livello di logging dell'agente, imposta il valore richiesto. I livelli di log disponibili sono i seguenti:
Il valore predefinito è |
log_to_cloud |
Per reindirizzare i log dell'agente a
Cloud Logging, specifica
|
cloud_properties.project_id |
Se il tuo sistema SAP è in esecuzione su un server Bare Metal Solution, specifica l'ID del progetto Google Cloud che stai utilizzando con Bare Metal Solution. |
cloud_properties.instance_name
|
Specifica il nome dell'istanza VM di Compute Engine. L'agente lo rileva automaticamente al momento dell'installazione. |
cloud_properties.region |
Se il sistema SAP è in esecuzione su un server Bare Metal Solution, specifica la regione del server Bare Metal Solution. |
cloud_properties.zone |
Per impostazione predefinita, quando l'agente viene eseguito su un'istanza VM utilizza la zona dell'istanza VM in cui è installato. |
cloud_properties.image |
Specifica il nome dell'immagine del sistema operativo per l'istanza. |
cloud_properties.numeric_project_id |
Specifica l'ID numerico del progetto Google Cloud in cui è in esecuzione il sistema SAP. |
collection_configuration.collect_process_metrics |
Per abilitare la raccolta delle metriche di monitoraggio dei processi, specifica |
collection_configuration.process_metrics_frequency |
Specifica la frequenza di raccolta delle metriche di Process Monitoring in secondi. Il valore predefinito di questo parametro è di Sebbene sia possibile aggiornare la frequenza di raccolta delle metriche di monitoraggio dei processi, ti consigliamo di utilizzare il valore predefinito. Se devi modificare il valore predefinito, aggiungi il parametro |
collection_configuration.hana_metrics_config.hana_db_user |
Specifica l'account utente del database che l'agente utilizza per eseguire query su SAP HANA. Il valore predefinito è |
collection_configuration.hana_metrics_config.hana_db_password |
Specifica la password in testo normale per l'account utente del database che l'agente utilizza per eseguire query su SAP HANA. |
collection_configuration.hana_metrics_config.hana_db_password_secret_name |
Per fornire in modo sicuro la password per l'account utente del database che l'agente utilizza per eseguire query su SAP HANA, specifica il nome del secret che contiene le credenziali di sicurezza per l'account utente del database. Le metriche relative a SAP HANA vengono raccolte solo se è impostata l'opzione |
collection_configuration.collect_workload_validation_metrics |
Per abilitare la raccolta delle metriche di valutazione del Gestore carichi di lavoro, specifica |
collection_configuration.workload_validation_metrics_frequency |
La frequenza di raccolta delle metriche di valutazione del Gestore carichi di lavoro in secondi. Il valore predefinito è Se devi modificare la frequenza di raccolta delle metriche
del Gestore carichi di lavoro, aggiungi il parametro
|
collection_configuration.workload_validation_db_metrics_config.hana_db_user |
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_secret_name |
Specifica il nome del secret in Secret Manager in cui è archiviata la password dell'account utente. |
collection_configuration.workload_validation_db_metrics_config.hostname |
Specifica l'identificatore della macchina, locale o remota, che ospita la tua istanza SAP HANA. Di seguito sono riportati i valori supportati:
|
collection_configuration.workload_validation_db_metrics_config.port |
Specifica la porta su cui la tua istanza SAP HANA accetta le query. Per
la prima o la sola istanza di database tenant, la porta è
|
collection_configuration.workload_validation_db_metrics_frequency |
La frequenza di raccolta delle metriche del database SAP HANA, in secondi, per la valutazione di Workload Manager.
Il valore predefinito è |
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 l'installazione dell'agente su un'istanza VM di 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 installare l'agente su un'istanza VM di Compute Engine.
{
"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:
Agent for SAP - HANA Overview: Questa dashboard fornisce grafici che mostrano una panoramica dello stato per le seguenti metriche: Disponibilità SAP HANA, Disponibilità SAP HANA HA, Replica SAP HANA HA, Stato del servizio SAP HANA, Cluster ad alta disponibilità - Stato del nodo e Cluster ad alta disponibilità - Stato risorsa per le istanze SAP.
Il file JSON per questa dashboard è
sap-agent-status-overview.json.Agente per SAP - Metriche non elaborate di HANA: Questa dashboard fornisce grafici che mostrano valori delle metriche non elaborati per le seguenti metriche: Disponibilità SAP HANA , Disponibilità SAP HANA HA, Replica SAP HANA HA, Stato del servizio SAP HANA, Cluster ad alta disponibilità - Stato del nodo e Cluster ad alta disponibilità - Stato della risorsa per le istanze SAP.
Il file JSON per questa dashboard è
sap-agent-raw-metrics.json.
Installa dashboard
Per installare una dashboard personalizzata, completa i seguenti passaggi:
Console Google Cloud
Nella console Google Cloud, vai alla pagina Monitoring:
Nel pannello di navigazione di Monitoring, fai clic su Dashboard.
Fai clic sulla scheda Raccolta di esempio.
Per filtrare le dashboard personalizzate specifiche dell'agente, digita
Agent for SAPnel campo Filtro.(Facoltativo) Per visualizzare i dettagli di una dashboard o per visualizzarne l'anteprima, fai clic su Anteprima.
Seleziona la dashboard da installare.
Fai clic su Importa e poi su Conferma.
La dashboard viene aggiunta alle dashboard disponibili nel progetto Google Cloud. Per vedere la dashboard, segui le istruzioni in Visualizzare la dashboard installata.
Google Cloud CLI
Apri Cloud Shell:
In Cloud Shell, clona o scarica il repository:
git clone https://github.com/GoogleCloudPlatform/monitoring-dashboard-samples/
In Cloud Shell, installa la dashboard richiesta utilizzando il file JSON corrispondente:
gcloud monitoring dashboards create --config-from-file=CONFIG_FROM_FILE
Sostituisci
CONFIG_FROM_FILEcon il percorso del file JSON che contiene la configurazione della dashboard. I file di configurazione della dashboard possono essere trovati nel percorso:monitoring-dashboard-samples/dashboards/google-cloud-agent-for-sap.La dashboard viene aggiunta alle dashboard disponibili nel tuo progetto Google Cloud. Per vedere la dashboard, segui le istruzioni in Visualizzare la dashboard installata.
Visualizza le dashboard installate
Per visualizzare le dashboard installate:
Nella console Google Cloud, vai alla pagina Monitoring:
Nel pannello di navigazione di Monitoring, fai clic su Dashboard.
Fai clic sul nome della dashboard nell'elenco.
Se disponi di 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 sulla diagnosi e sulla risoluzione dei problemi che potresti riscontrare durante l'installazione e la configurazione di Agent for SAP di Google Cloud, consulta la guida alla risoluzione dei problemi di Google Cloud Agent for SAP.
Richiedere assistenza
Se hai bisogno di aiuto per risolvere problemi con l'agente di Google Cloud per SAP, raccogli tutte le informazioni di diagnostica disponibili e contatta l'assistenza clienti Google Cloud. Per informazioni su come contattare l'assistenza clienti, vedi Ricevere assistenza per SAP su Google Cloud.