L'agente di Google Cloud per SAP è richiesto per il supporto SAP dei sistemi SAP in esecuzione su un server Bare Metal Solution.
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 disponibili per l'esecuzione di SAP sui server Bare Metal Solution, consulta quanto segue:
- Per SAP HANA, consulta la pagina relativa ai sistemi operativi certificati.
- Per SAP NetWeaver, consulta la pagina relativa ai sistemi operativi certificati.
Per installare e configurare la versione 2 dell'agente per SAP di Google Cloud su un'istanza VM di Compute Engine, consulta Installare l'agente per SAP di Google Cloud su un'istanza VM di Compute Engine.
Panoramica dell'installazione
Puoi installare l'agente di Google Cloud per SAP utilizzando i comandi standard di gestione dei pacchetti del sistema operativo: 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
.
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 Google Cloud per SAP su un server Bare Metal Solution.
Per installare la versione 2 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
Stabilisci una connessione SSH con il tuo server Bare Metal Solution.
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
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 raccogliere metriche di monitoraggio dei processi, metriche di valutazione di Workload Manager e metriche di monitoraggio di SAP HANA. Per impostazione predefinita, è abilitata solo la raccolta delle metriche dell'agente host SAP.
Prerequisiti
Per abilitare queste funzionalità per l'istanza dell'agente in esecuzione sul server Bare Metal Solution, devi completare i seguenti prerequisiti:
- Creare un account di servizio IAM affinché l'agente possa accedere alle risorse Google Cloud, quindi concedere i ruoli IAM richiesti all'account di servizio. Per i dettagli, consulta Configurare un account di servizio.
- Sul server Bare Metal Solution, installa gcloud CLI. Per maggiori dettagli, consulta Installare gcloud CLI.
- Per accedere a Google Cloud, autorizza gcloud CLI. Per maggiori dettagli, consulta Autorizzare gcloud CLI.
- Stabilire una connessione alle API Google Cloud. Per i dettagli, consulta Configurazione dell'accesso privato Google per gli host on-premise.
Configurare un account di servizio
Per consentire all'agente di accedere alle risorse Google Cloud da un ambiente Bare Metal Solution, devi configurare un account di servizio IAM.
Come minimo, l'account di servizio utilizzato dall'agente deve includere il ruolo Writer metriche Monitoring (roles/monitoring.metricWriter
).
Per creare un account di servizio:
-
Crea un account di servizio:
-
Nella console Google Cloud, vai alla pagina Crea account di servizio.
Vai a Crea account di servizio - Seleziona il progetto.
-
Nel campo Nome account di servizio, inserisci un nome. La console Google Cloud compila il campo ID account di servizio in base a questo nome.
Nel campo Descrizione account di servizio, inserisci una descrizione. Ad esempio,
Service account for quickstart
. - Fai clic su Crea e continua.
-
Concedi il ruolo Monitoring > Monitoring Metric Writer all'account di servizio.
Per concedere il ruolo, trova l'elenco Seleziona un ruolo e scegli Monitoring > Monitoring Metric Writer.
- Fai clic su Continua.
-
Fai clic su Fine per completare la creazione dell'account di servizio.
Non chiudere la finestra del browser. La utilizzerai nel passaggio successivo.
-
-
Crea una chiave dell'account di servizio:
- Nella console Google Cloud, fai clic sull'indirizzo email dell'account di servizio che hai creato.
- Fai clic su Chiavi.
- Fai clic su Aggiungi chiave, quindi su Crea nuova chiave.
- Fai clic su Crea. Un file della chiave JSON viene scaricato sul computer.
- Fai clic su Chiudi.
Dopo aver creato l'account di servizio, assicurati di caricare il relativo file di chiavi JSON in una posizione sicura sul server Bare Metal Solution accessibile all'agente.
Abilita le funzionalità
Dopo aver impostato un account di servizio per la tua Bare Metal Solution e avergli concesso i ruoli richiesti, puoi abilitare altre funzionalità dell'agente di Google Cloud per SAP eseguendo le seguenti configurazioni:
- Configura la raccolta di metriche per il monitoraggio dei processi
- Configura la raccolta delle metriche di valutazione del Gestore carichi di lavoro
- Configura la raccolta delle metriche di monitoraggio SAP HANA.
File di configurazione predefinito
Lo snippet seguente è un esempio della configurazione predefinita della versione 2 dell'agente per SAP di Google Cloud:
{ "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 illustra i parametri di configurazione della versione 2 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
|
sap_system_discovery |
Per attivare il rilevamento del sistema SAP, 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 del server Bare Metal Solution su cui hai installato l'agente. Nella versione 2.5 dell'agente o precedenti, specifica il nome del server Bare Metal Solution per la proprietà |
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 |
Dalla versione 2.6, questo parametro determina la frequenza di raccolta in secondi delle metriche di monitoraggio dei processi in rapida evoluzione. Le metriche di monitoraggio dei processi in rapida evoluzione sono: Il valore predefinito di questo parametro è
Tutte le altre metriche di monitoraggio dei processi (a lenta modifica) vengono raccolte con una frequenza predefinita di 30 secondi. Per modificare la frequenza di raccolta delle metriche di monitoraggio dei processi che cambiano lenta, utilizza il parametro |
collection_configuration.slow_process_metrics_frequency |
Specifica la frequenza di raccolta delle metriche di monitoraggio dei processi in lenta modifica, in secondi. Il valore predefinito di questo parametro è di |
collection_configuration.process_metrics_to_skip |
Specifica le metriche di monitoraggio dei processi che non vuoi che l'agente raccolga. Questo parametro accetta un valore separato da virgole dei nomi delle metriche di monitoraggio dei processi. Ad esempio:
|
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 è |
hana_monitoring_configuration.enabled |
Facoltativo. Per consentire all'agente di Google Cloud per SAP di raccogliere le metriche di monitoraggio SAP HANA, specifica hana_monitoring_configuration.enabled: true .
|
hana_monitoring_configuration.sample_interval_sec |
Facoltativo. Specifica l'intervallo di campionamento, in secondi, che determina la frequenza con cui l'agente per SAP di Google Cloud esegue query sulle tue istanze SAP HANA per raccogliere le metriche di monitoraggio di SAP HANA. Il valore predefinito è 300 secondi. Per ogni query definita nel file di configurazione dell'agente per SAP di Google Cloud, puoi sovrascrivere l'intervallo di campionamento globale specificando l'intervallo richiesto per il parametro |
hana_monitoring_configuration.query_timeout_sec |
Facoltativo. Specifica il timeout per ogni query effettuata alle istanze SAP HANA. Il valore predefinito è 300 secondi. |
hana_monitoring_configuration.execution_threads |
Facoltativo. Specifica il numero di thread utilizzati per inviare query alle 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 l'istanza SAP HANA. |
hana_monitoring_configuration.hana_instances.sid |
Specifica il SID della tua istanza SAP HANA. Questa stringa viene aggiunta come etichetta a tutte le metriche risultanti dalle query sulle tue istanze SAP HANA. |
hana_monitoring_configuration.hana_instances.host |
Specifica l'identificatore della macchina, locale o remota, 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 la sola 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, come testo normale, che autentica l'account utente per le query sull'istanza SAP HANA. Per attivare l'autenticazione, devi specificare una delle seguenti opzioni:
Se utilizzi entrambi i parametri, viene utilizzato il parametro |
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 nella tua istanza SAP HANA. 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 hai definito query personalizzate nel file di configurazione, devi specificare un nome univoco per ogni query personalizzata. Il nome della query deve essere univoco perché viene utilizzato per creare l'URL predefinito della metrica in Monitoring. |
hana_monitoring_configuration.queries.sql |
Specifica l'istruzione SQL inviata dall'agente alle tue istanze SAP HANA. L'istruzione SQL deve essere conforme alla sintassi SQL definita da SAP nel documento SAP HANA SQL and System Visualizzazioni. |
hana_monitoring_configuration.queries.sample_interval_sec |
Facoltativo. Specifica l'intervallo di esempio per la query SQL. Questa operazione sostituisce l'intervallo di campionamento globale. Il valore deve durare almeno 5 secondi. |
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 l'URL predefinito della metrica in Monitoring. |
hana_monitoring_configuration.queries.columns.metric_type |
Per la gestione da parte di Monitoring, specifica uno dei seguenti
tipi di metriche: Le metriche di tipo |
hana_monitoring_configuration.queries.columns.value_type |
Per la gestione da parte di Monitoring, specifica un tipo di dati supportato dal tipo di metrica. I tipi di dati supportati sono i seguenti: |
hana_monitoring_configuration.queries.columns.name_override |
Facoltativo. Per la gestione da parte di Monitoring, specifica il percorso da visualizzare nell'URL della metrica anziché i nomi della query e della colonna. Ad esempio:
|
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.