L'agente di Google Cloud per SAP è necessario per l'assistenza SAP dei sistemi SAP in esecuzione su un server Bare Metal Solution.
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: tutte le immagini "for SAP"
- SLES: SLES 15 SP4 for SAP e versioni successive
Per informazioni sui sistemi operativi disponibili per l'esecuzione di SAP su server Bare Metal Solution, consulta quanto segue:
- Per SAP HANA, vedi Sistemi operativi certificati.
- Per SAP NetWeaver, vedi Sistemi operativi certificati.
Per installare e configurare la versione 2 dell'agente di Google Cloud per SAP su un'istanza VM Compute Engine, consulta Installare l'agente di Google Cloud per SAP su un'istanza VM Compute Engine.
Panoramica dell'installazione
L'agente di Google Cloud per SAP 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
systemd
Linux denominatogoogle-cloud-sap-agent
. - Attiva 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 di Google Cloud per SAP su un server Bare Metal Solution.
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, convalida l'installazione dell'agente di Google Cloud per SAP, come descritto in Convalidare l'installazione dell'agente.
Convalida l'installazione dell'agente
Stabilisci una connessione SSH con il 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 riceva 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 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:
- Provider cloud:
Google Cloud Platform
- Accesso a monitoraggio avanzato:
TRUE
- Dettagli sul monitoraggio avanzato:
ACTIVE
- Provider cloud:
Configurare l'agente di Google Cloud per SAP su Linux
Dopo aver installato l'agente per SAP di Google Cloud, facoltativamente, puoi configurare per la raccolta delle metriche di monitoraggio dei processi, Workload Manager metriche di valutazione e metriche di monitoraggio SAP HANA. Per impostazione predefinita, dei dati che compongono Metriche dell'agente host SAP sia abilitato.
Prerequisiti
Per abilitare queste funzionalità per l'istanza dell'agente in esecuzione sul tuo Bare Metal Solution, devi completare i seguenti prerequisiti:
- Crea un account di servizio IAM per consentire all'agente di accedere alle risorse Google Cloud, quindi concedi all'account di servizio i ruoli IAM richiesti. Consulta Configurare un account di servizio per maggiori dettagli.
- Sul server Bare Metal Solution, installa l'interfaccia a riga di comando gcloud. Consulta Installa l'interfaccia a riga di comando gcloud per maggiori dettagli.
- Per accedere a Google Cloud, autorizza gcloud CLI. Consulta Autorizza gcloud CLI per maggiori dettagli.
- Stabilisci una connessione alle API Google Cloud. Per maggiori dettagli, consulta la sezione Configurare l'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 monitoraggio (roles/monitoring.metricWriter
).
Per creare un account di servizio, segui questi passaggi:
-
Create a service account:
-
In the Google Cloud console, go to the Create service account page.
Go to Create service account - Select your project.
-
In the Service account name field, enter a name. The Google Cloud console fills in the Service account ID field based on this name.
In the Service account description field, enter a description. For example,
Service account for quickstart
. - Click Create and continue.
-
Grant the Monitoring > Monitoring Metric Writer role to the service account.
To grant the role, find the Select a role list, then select Monitoring > Monitoring Metric Writer.
- Click Continue.
-
Click Done to finish creating the service account.
Do not close your browser window. You will use it in the next step.
-
-
Create a service account key:
- In the Google Cloud console, click the email address for the service account that you created.
- Click Keys.
- Click Add key, and then click Create new key.
- Click Create. A JSON key file is downloaded to your computer.
- Click Close.
Dopo aver creato l'account di servizio, assicurati di caricare il relativo file di chiave JSON in una posizione sicura sul server Bare Metal Solution accessibile all'utente dell'agente.
Abilita le funzionalità
Dopo aver configurato un account di servizio per la tua soluzione Bare Metal Solution e avergli concesso il ruoli richiesti, puoi abilitare altre funzionalità dell'agente Google Cloud per SAP eseguendo le seguenti configurazioni:
- 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
Lo snippet che segue è un esempio della configurazione predefinita di 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 illustra i parametri di configurazione della versione 2 dell'agente di Google Cloud per SAP.
Parametri | |
---|---|
provide_sap_host_agent_metrics |
Per abilitare la raccolta delle metriche richieste dall'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
|
Specifica il nome del server Bare Metal Solution su cui disponi ha installato l'agente. Nella versione 2.5 dell'agente o in quelle precedenti, specifica
Nome del server Bare Metal Solution per la proprietà |
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 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 del
metriche di Process Monitoring in rapida evoluzione,
in pochi secondi. Le metriche di monitoraggio dei processi in rapida evoluzione sono: Il valore predefinito per 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 metriche di Process Monitoring che cambiano lentamente, in pochi secondi. Il valore predefinito per questo parametro è |
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 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 relative a SAP HANA solo se specifichi |
collection_configuration.hana_metrics_config.sid |
Specifica il SID della tua istanza SAP HANA. |
collection_configuration.collect_workload_validation_metrics |
Per attivare la raccolta delle metriche di valutazione di Workload Manager,
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 di Workload Manager, 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 SAP HANA. |
collection_configuration.workload_validation_db_metrics_config.hana_db_password |
Specifica la password per l'account utente utilizzato per eseguire query sull'istanza 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 l'SID dell'istanza SAP HANA. |
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 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. Per consentire all'agente di Google Cloud per SAP di raccogliere le metriche di monitoraggio di SAP HANA, 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 è 300 secondi. Per ogni query definita nel file di configurazione
con l'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 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 l'SID dell'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 del database del tenant, la porta è
|
hana_monitoring_configuration.hana_instances.user |
Specifica l'account utente utilizzato per eseguire query sull'istanza SAP HANA. Assicurati che questo utente abbia il privilegio di leggere le viste di monitoraggio nel tuo database SAP HANA. Se questo privilegio non viene concesso, le metriche di monitoraggio di SAP HANA relative alle viste di monitoraggio non contengono dati. |
hana_monitoring_configuration.hana_instances.password |
Facoltativo. Specifica la password, in testo normale, che autentica l'account utente per eseguire query sull'istanza SAP HANA. Per l'autenticazione, devi specificare uno dei seguenti elementi:
|
hana_monitoring_configuration.hana_instances.secret_name |
Facoltativo. Specifica il nome del segreto in Secret Manager che memorizza 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 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 Monitoraggio. |
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 da SAP nel SAP HANA SQL and System Views Reference. |
hana_monitoring_configuration.queries.sample_interval_sec |
Facoltativo. Specifica l'intervallo di campionamento per la query SQL. Questo sostituisce l'intervallo di campionamento globale. Il valore deve essere almeno di 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 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 da parte di Monitoraggio, specifica un tipo di dati supportato dal tipo di metrica. I tipi di dati supportati sono: |
hana_monitoring_configuration.queries.columns.name_override |
Facoltativo. Per la gestione da parte di Monitoraggio, specifica il percorso da 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 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 Per l'assistenza clienti, vedi Ottenere assistenza per SAP su Google Cloud.