Per il supporto SAP dei sistemi SAP in esecuzione, è richiesto l'agente Google Cloud per SAP su Google Cloud, tra cui SAP NetWeaver, SAP HANA, SAP ASE, SAP MaxDB, e altri.
Quando installi Agent for SAP di Google Cloud su una VM di Compute Engine per le metriche di SAP Host Agent, combina i dati di monitoraggio di Cloud Monitoring e alle API Compute Engine e fornisce questi dati al SAP Host Agent.
Se utilizzi le seguenti RHEL o SLES "for SAP" Immagini del sistema operativo che Google Cloud l'agente per SAP di Google Cloud viene pacchettizzato con le immagini del sistema operativo:
- RHEL: tutto "per SAP" immagini
- SLES: SLES 15 SP4 per SAP e versioni successive
Per informazioni sui sistemi operativi supportati dall'agente di Google Cloud per SAP, vedi Sistemi operativi supportati.
Per installare e configurare la versione 2 di Agente Google Cloud per SAP su una Bare Metal Solution un server web, consulta Installa l'agente Google Cloud per SAP su un server Bare Metal Solution.
Panoramica dell'installazione
Su Linux, devi installare l'Agente di Google Cloud per SAP utilizzando sistemi operativi standard
per la gestione dei pacchetti di sistema: su RHEL, il comando yum
; su SLES,
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, denominatogoogle-cloud-sap-agent
. - Abilita e avvia il servizio,
google-cloud-sap-agent
.
Su Windows, puoi installare l'agente di Google Cloud per SAP utilizzando il 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 una pianificazione che viene eseguita ogni minuto per verificare se il servizio è ancora in esecuzione se necessario, riavvialo.
Prerequisiti per l'agente
Prima di installare l'agente di Google Cloud per SAP, devi assicurarti che sono soddisfatti i seguenti prerequisiti.
Imposta i ruoli IAM richiesti
Come minimo,
account di servizio
che l'agente Google Cloud per SAP utilizza deve includere
Visualizzatore Compute (roles/compute.viewer
),
Visualizzatore Monitoring (roles/monitoring.viewer
),
e Workload Manager Insights Writer (roles/workloadmanager.insightWriter
)
ruoli.
Per aggiungere un ruolo obbligatorio al tuo account di servizio, segui questi passaggi:
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 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 dispone di account ruoli. Fai clic sul pulsante Modifica per l'account di servizio che desideri modificare.
Seleziona il ruolo richiesto dall'elenco di ruoli disponibili:
- Compute Engine > Visualizzatore Compute
- Monitoraggio > Visualizzatore Monitoring
- Gestione dei 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 per consentire di accedere agli ambiti di accesso a tutte le API Cloud utilizzando solo le autorizzazioni IAM dell'account di servizio dell'istanza per controllare l'accesso alle risorse Google Cloud. Per ulteriori informazioni, vedi Crea una VM che utilizza un account di servizio gestito dall'utente.
Se limiti l'accesso alle API Cloud, allora l'agente di Google Cloud per SAP richiede i seguenti ambiti minimi di accesso alle 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 dispone un indirizzo IP esterno, dovrai abilitare l'accesso privato Google sulla subnet della VM in modo che l'agente Google Cloud per SAP possono 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 Google Cloud per SAP, che supporta più funzionalità. Per istruzioni, vedi Installa e configura l'agente di Google Cloud per SAP su un'istanza VM di Compute Engine.
Per installare la versione 2 dell'agente Google Cloud per SAP, contatta Assistenza clienti Google Cloud.
Dopo aver installato l'agente di Google Cloud per SAP e l'agente host SAP, convalidare dell'agente Google Cloud per SAP, come descritto in Convalida l'installazione dell'agente.
Convalida l'installazione dell'agente
Per verificare che l'agente sia in esecuzione, seleziona il tuo sistema operativo e quindi segui questi passaggi:
Linux
Stabilisci una connessione SSH di un'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.
Come amministratore, esegui il comando seguente da PowerShell:
$(Get-Service -Name 'google-cloud-sap-agent' -ErrorAction Ignore).Status
Se l'agente è in esecuzione, lo stato èRunning
.
Se l'agente non è in esecuzione, riavvialo.
Verifica che l'agente host SAP stia ricevendo le metriche
Per verificare che le metriche dell'infrastruttura siano raccolte l'agente Google Cloud per SAP e inviato correttamente a SAP Host Agent. segui questi passaggi:
- Nel sistema SAP, inserisci la transazione
ST06
. Nel riquadro Panoramica, verifica la disponibilità e il contenuto i seguenti campi per la corretta configurazione end-to-end di SAP e di Google dell'infrastruttura di monitoraggio:
- Provider cloud:
Google Cloud Platform
- Accesso a monitoraggio avanzato:
TRUE
- Dettagli sul monitoraggio avanzato:
ACTIVE
- Provider cloud:
Configura l'agente Google Cloud per SAP su Linux
Dopo aver installato l'agente per SAP di Google Cloud, facoltativamente, puoi abilitare altre delle funzionalità dell'agente eseguendo le configurazioni riportate di seguito. Per impostazione predefinita, la raccolta dei soli dati Metriche dell'agente host SAP sia abilitato.
- Configura la raccolta delle metriche di Process Monitoring
- Configura la raccolta delle metriche di valutazione del Gestore carichi di lavoro
- Configura la raccolta delle metriche di monitoraggio di SAP HANA.
File di configurazione predefinito
Il seguente snippet è un esempio della configurazione predefinita versione 2 dell'agente Google Cloud per SAP:
{ "provide_sap_host_agent_metrics": true, "bare_metal": , "log_level": "INFO", "log_to_cloud": true, "collection_configuration": { "collect_workload_validation_metrics": false, "collect_process_metrics": false, "sap_system_discovery": true }, "hana_monitoring_configuration": { "enabled": false } }
Parametri di configurazione
La tabella seguente spiega i parametri di configurazione della versione 2 dell'agente Google Cloud per SAP.
Parametri | |
---|---|
provide_sap_host_agent_metrics |
Per abilitare la raccolta delle metriche richieste dalla
Agente host SAP, specifica |
bare_metal |
Quando l'agente è 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
|
sap_system_discovery |
Per abilitare il rilevamento del sistema SAP, specifica |
cloud_properties.project_id |
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. |
cloud_properties.instance_name
|
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 |
Se il sistema SAP è in esecuzione su un server Bare Metal Solution,
e specifica l'area geografica del server Bare Metal Solution. |
cloud_properties.zone |
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 |
Specifica il nome dell'immagine del sistema operativo dell'istanza. |
cloud_properties.numeric_project_id |
Specifica l'ID numerico del progetto Google Cloud che il sistema SAP
è in esecuzione. |
collection_configuration.collect_process_metrics |
Per abilitare la raccolta delle metriche di Process Monitoring, specifica |
collection_configuration.process_metrics_frequency |
Dalla versione 2.6, questo parametro determina la frequenza di raccolta del
metriche di Process Monitoring in rapida evoluzione,
in pochi secondi. Le metriche di monitoraggio dei processi in rapida evoluzione sono: Il valore predefinito di questo parametro è
Tutte le altre metriche di Process Monitoring (in lento cambiamento) vengono raccolte in un
frequenza predefinita di 30 secondi. Per modificare la frequenza di raccolta
le metriche di Process Monitoring che cambiano lentamente, usa il parametro
|
collection_configuration.slow_process_metrics_frequency |
Specifica la frequenza di raccolta del le metriche di Process Monitoring cambiano lentamente, in pochi secondi. Il valore predefinito di questo parametro è |
collection_configuration.process_metrics_to_skip |
Specifica
Metriche di monitoraggio dei processi
che non vuoi vengano raccolte dall'agente. Questo parametro accetta un parametro
valore separato da virgole dei nomi delle metriche di Process Monitoring. Ad esempio:
|
collection_configuration.hana_metrics_config.hana_db_user |
Specifica l'account utente del database che l'agente utilizza per eseguire la query
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 che l'agente utilizza per eseguire query su SAP HANA. Invece di specificare una password in testo normale, ti consigliamo di utilizzare una delle seguenti opzioni:
|
collection_configuration.hana_metrics_config.hana_db_password_secret_name |
Per fornire in modo sicuro la password per l'account utente del database che che l'agente utilizza per eseguire query su SAP HANA, specifica il nome secret che contiene le credenziali di sicurezza per l'account utente del database. L'agente raccoglie le metriche correlate a SAP HANA solo quando specifichi
|
collection_configuration.hana_metrics_config.sid |
Specifica il SID della tua istanza SAP HANA. |
collection_configuration.collect_workload_validation_metrics |
Per abilitare la raccolta delle metriche di valutazione del Gestore carichi di lavoro,
specificare |
collection_configuration.workload_validation_metrics_frequency |
La frequenza di raccolta del Gestore carichi di lavoro
le metriche di valutazione in pochi secondi. Il valore predefinito è Se devi modificare la frequenza di raccolta del
le metriche di Gestore carichi di lavoro, quindi aggiungi
|
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 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.sid |
Specifica il SID della tua istanza SAP HANA. |
collection_configuration.workload_validation_db_metrics_config.hostname |
Specifica l'identificatore della macchina, locale o remota, che 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 l'unica 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 del Gestore carichi di lavoro.
Il valore predefinito è |
hana_monitoring_configuration.enabled |
Facoltativo. Consenti all'agente di Google Cloud per SAP di raccogliere i dati SAP HANA
di monitoraggio delle metriche, specifica hana_monitoring_configuration.enabled: true .
|
hana_monitoring_configuration.sample_interval_sec |
Facoltativo. Specifica l'intervallo campione, in secondi, che determina la frequenza con cui l'agente Google Cloud per SAP esegue query su SAP HANA per raccogliere le metriche di monitoraggio SAP HANA. Il valore predefinito è di 300 secondi. Per ogni query definita nel file di configurazione
Agente Google Cloud per SAP, puoi sovrascrivere l'intervallo globale di esempio
specificando l'intervallo richiesto al parametro
|
hana_monitoring_configuration.query_timeout_sec |
Facoltativo. Specifica il timeout per ogni query effettuata sulle istanze SAP HANA. Il valore predefinito è 300 secondi. |
hana_monitoring_configuration.execution_threads |
Facoltativo. Specifica il numero di thread utilizzati per inviare query al Istanze SAP HANA. Ogni query viene eseguita sul proprio thread. Il valore predefinito è 10. |
hana_monitoring_configuration.hana_instances.name |
Specifica l'identificatore del nome per la tua istanza SAP HANA. |
hana_monitoring_configuration.hana_instances.sid |
Specifica il SID della tua istanza SAP HANA. Questa stringa viene aggiunta come a tutte le metriche risultanti dall'esecuzione di query sulle tue istanze SAP HANA. |
hana_monitoring_configuration.hana_instances.host |
Specifica l'identificatore della macchina, locale o remota, che che ospita la tua istanza SAP HANA. Di seguito sono riportati i valori supportati:
|
hana_monitoring_configuration.hana_instances.port |
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
|
hana_monitoring_configuration.hana_instances.user |
Specifica l'account utente utilizzato per eseguire query sull'istanza SAP HANA. |
hana_monitoring_configuration.hana_instances.password |
Facoltativo. Specifica la password, in testo normale, che esegue l'autenticazione l'account utente per eseguire query sull'istanza SAP HANA. Per l'autenticazione, devi specificare una delle seguenti opzioni:
|
hana_monitoring_configuration.hana_instances.secret_name |
Facoltativo. Specifica il nome del secret in Secret Manager in cui è archiviata la password dell'account utente. |
hana_monitoring_configuration.hana_instances.enable_ssl |
Facoltativo. Specifica se SSL è abilitato o meno in SAP HANA
in esecuzione in un'istanza Compute Engine. Il valore predefinito è |
hana_monitoring_configuration.hana_instances.host_name_in_certificate |
Se specifichi |
hana_monitoring_configuration.hana_instances.tls_root_ca_file |
Se specifichi |
hana_monitoring_configuration.queries.enabled |
Facoltativo. Per abilitare una query SQL per tutte le tue istanze SAP HANA,
specifica il valore |
hana_monitoring_configuration.queries.name |
Se nel file di configurazione hai definito query personalizzate, devi specificare un nome univoco per ogni query personalizzata. Il nome della query deve essere univoco perché viene utilizzato per creare il predefinito della metrica in Monitoring. |
hana_monitoring_configuration.queries.sql |
Specifica l'istruzione SQL che l'agente invia a SAP HANA di Compute Engine. L'istruzione SQL deve essere conforme alla sintassi SQL definita SAP in Riferimento SQL di SAP HANA e visualizzazioni di sistema. |
hana_monitoring_configuration.queries.sample_interval_sec |
Facoltativo. Specifica l'intervallo di esempio per la query SQL. Questo sostituisce l'intervallo di campionamento globale. Il valore deve essere di 5 secondi o più a lungo. |
hana_monitoring_configuration.queries.columns.name |
Specifica un nome che identifichi in modo univoco ogni colonna. Il nome della colonna deve essere univoco perché viene utilizzato per creare la predefinito della metrica in Monitoring. |
hana_monitoring_configuration.queries.columns.metric_type |
Per la gestione tramite Monitoring, specifica una delle seguenti opzioni
tipi di metriche: Le metriche di tipo |
hana_monitoring_configuration.queries.columns.value_type |
Per la gestione tramite Monitoring, specifica un tipo di dati che sia supportate dal tipo di metrica. I tipi di dati supportati sono i seguenti: |
hana_monitoring_configuration.queries.columns.name_override |
Facoltativo. Per la gestione tramite Monitoring, specifica percorso che vuoi mostrare nell'URL della metrica anziché i nomi delle query e delle colonne. Ad esempio:
|
Risoluzione dei problemi
Per informazioni su come diagnosticare e risolvere problemi che potresti incontrati quando installi e configuri l'agente di Google Cloud per SAP, consulta Guida alla risoluzione dei problemi di Agent for SAP di Google Cloud.
Assistenza
Se hai bisogno di aiuto per risolvere problemi con con l'agente Google Cloud per SAP, quindi raccogli tutte le informazioni diagnostiche disponibili e contatta l'assistenza clienti Google Cloud. Per informazioni su come contattare Per l'assistenza clienti, vedi Ottenere assistenza per SAP su Google Cloud.