Questa guida illustra le considerazioni operative e le procedure per l'esecuzione della versione 2 dell'agente Google Cloud per SAP su istanze VM di Compute Engine e server Bare Metal Solution.
Comprendi il ciclo di vita degli agenti
Quando si gestisce le operazioni dell'agente di Google Cloud per SAP, è utile comprendere cosa fa l'agente. In generale, ecco come funziona:
- Devi installare l'agente di Google Cloud per SAP su ogni istanza VM di Compute Engine o server Bare Metal Solution che ospita i sistemi SAP. L'agente viene eseguito come servizio Linux o Windows.
- Nelle istanze VM di Compute Engine, l'agente combina i dati di monitoraggio provenienti da Monitoring e dalle API Compute Engine.
- Sui server Bare Metal Solution, per la raccolta delle sole metriche dell'agente SAP Host, l'agente non accede alle API Google Cloud.
- SAP Host Agent esegue il polling dell'agente Google Cloud per SAP per trovare i dati memorizzati nella cache tramite HTTP. Aggrega le metriche di SAP Host Agent, le segnala e le archivia nel database SAP NetWeaver.
- La transazione SAP
ST06
o l'interfaccia a riga di comandosaposcol
mostra le metriche aggregate di SAP Host Agent. - Puoi visualizzare le metriche di SAP Host Agent dall'Agente per SAP di Google Cloud eseguendo un comando in una finestra del terminale.
Verifica che l'agente sia in esecuzione
Dopo aver installato l'agente o riavviato l'agente, puoi verificare che quest'ultimo sia in esecuzione come previsto.
Per verificare se l'agente è in esecuzione, segui questi passaggi:
Linux
Stabilisci una connessione SSH con il tuo server o la tua istanza VM 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
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 di Google Cloud per SAP non è in esecuzione, riavvia l'agente.
Controlla la versione dell'agente
Dopo aver installato o riavviato l'agente di Google Cloud per SAP, puoi controllare la versione dell'agente.
Per verificare la versione dell'agente, completa i seguenti passaggi:
Linux
Per RHEL, segui questi passaggi:
- Utilizza SSH per connetterti alla macchina host.
- Esegui questo comando:
yum info google-cloud-sap-agent
Per SLES:
- Utilizza SSH per connetterti alla macchina host.
- Esegui questo comando:
zypper info google-cloud-sap-agent
Windows
- Utilizza RDP per la connessione alla macchina host.
- In qualità di amministratore, esegui il comando seguente da PowerShell:
googet installed google-cloud-sap-agent
Verifica che l'agente host SAP stia ricevendo 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:
- Nel sistema SAP, inserisci la transazione
ST06
. Nel riquadro Panoramica, verifica la disponibilità e il contenuto dei seguenti campi per la corretta configurazione end-to-end dell'infrastruttura di monitoraggio SAP e Google:
- Provider cloud:
Google Cloud Platform
- Accesso a monitoraggio avanzato:
TRUE
- Dettagli sul monitoraggio avanzato:
ACTIVE
- Provider cloud:
Visualizza le metriche di SAP Host Agent
Dopo aver installato o aggiornato la configurazione di Google Cloud Agent per SAP, puoi visualizzare le metriche di SAP Host Agent raccolte.
Per visualizzare le metriche dell'agente host SAP raccolte dall'agente di Google Cloud per SAP, segui questi passaggi:
Linux
Stabilisci una connessione SSH con l'istanza VM host del server Bare Metal Solution.
Esegui questo comando:
curl http://localhost:18181
Se le metriche sono disponibili, dovresti ricevere un output XML contenente informazioni sul tuo sistema. Ad esempio:
<?xml version="1.0" encoding="UTF-8" standalone="yes"?> <metrics> <metric category="cpu" context="vm" type="double" unit="Percent" last-refresh="1670422670" refresh-interval="60"> <name>VM Processing Power Consumption</name> <value>0.0</value> </metric>
Windows
Utilizza RDP per la connessione all'istanza VM.
In qualità di amministratore, esegui il comando seguente da PowerShell:
(Invoke-WebRequest -Uri 'http://localhost:18181').RawContent
Se le metriche sono disponibili, dovresti vedere un output XML contenente informazioni sul tuo sistema. Ad esempio:
<?xml version="1.0" encoding="UTF-8" standalone="yes"?> <metrics> <metric category="cpu" context="vm" type="double" unit="Percent" last-refresh="1670422528" refresh-interval="60"> <name>VM Processing Power Consumption</name> <value>10.0</value> </metric>
Visualizza le altre metriche
Dopo aver aggiornato la configurazione dell'agente per SAP di Google Cloud per raccogliere le metriche di Process Monitoring, le metriche di valutazione di Workload Manager o le metriche di monitoraggio di SAP HANA, devi visualizzarle per verificare che l'agente stia raccogliendo le metriche come previsto.
Puoi visualizzare le metriche e le informazioni raccolte dall'agente di Google Cloud per SAP in Cloud Monitoring completando i seguenti passaggi:
Nella console Google Cloud, vai alla pagina Esplora metriche di Monitoring.
Seleziona la scheda Configurazione.
Espandi il menu Seleziona una metrica.
Nel menu Risorse, seleziona Istanza VM.
Nel menu Categoria di metrica, seleziona sap.
Nel menu Metrica, seleziona
metric: workload.googleapis.com/sap/service/active
o una delle nuove metriche da rappresentare in un grafico.Fai clic su Applica.
Dovresti visualizzare un grafico con i valori delle metriche delle serie temporali.
Riavvia l'agente
Se l'agente per SAP di Google Cloud smette di funzionare o ne aggiorni la configurazione, riavvia l'agente.
Seleziona il tuo sistema operativo, quindi procedi nel seguente modo:
Linux
Stabilisci una connessione SSH con l'istanza VM host o il server Bare Metal Solution.
Esegui questo comando:
sudo systemctl restart google-cloud-sap-agent
Windows
Stabilisci una connessione RDP con la tua istanza VM host.
In qualità di amministratore, esegui il comando seguente da PowerShell:
Restart-Service -Name 'google-cloud-sap-agent' -Force
Esegui l'upgrade all'agente Google Cloud per SAP da altri agenti Google Cloud
L'installazione dell'agente di Google Cloud per SAP rileva automaticamente le versioni precedenti dell'agente di monitoraggio per SAP NetWeaver e dell'agente di monitoraggio per SAP HANA, le disattiva e le rimuove dalle macchine host durante l'installazione.
Se vengono rilevati questi agenti Google Cloud, anche le configurazioni nei relativi file di configurazione vengono migrate all'Agente per SAP di Google Cloud durante l'installazione. A scopo di backup e di riferimento, la configurazione dell'agente di monitoraggio per SAP HANA viene copiata nel seguente file:
/etc/google-cloud-sap-agent/backup-of-hanamonitoring-configuration.yaml
Per istruzioni sull'installazione e la configurazione di Agent di Google Cloud per SAP, consulta la guida all'installazione e alla configurazione dell'agente Google Cloud per SAP.
Upgrade di istanze abilitate per SSL
Se hai configurato l'agente di monitoraggio per SAP HANA in modo da utilizzare i certificati SSL per la comunicazione con le tue istanze SAP HANA, quando installi l'Agent di Google Cloud per SAP, viene eseguita la migrazione di tutte le configurazioni di monitoraggio SAP HANA, ad eccezione della configurazione SSL, nell'agente per SAP di Google Cloud. In questo caso, per utilizzare l'agente per SAP di Google Cloud per monitorare le istanze SAP HANA, devi completare i seguenti passaggi:
Stabilisci una connessione SSH con l'istanza VM host o il server Bare Metal Solution.
Apri il file di configurazione dell'agente di Google Cloud per SAP:
/etc/google-cloud-sap-agent/configuration.json
Nella sezione
hana_monitoring_configuration
, imposta il parametroenabled
sutrue
.Nella sezione
hana_monitoring_configuration.hana_instances
, esegui le operazioni seguenti per ogni istanza SAP HANA che utilizza il protocollo TLS/SSL per una comunicazione sicura:Specifica il parametro
enable_ssl
e imposta il valore sutrue
.Specifica il parametro
host_name_in_certificate
e imposta come valore il nome host SAP HANA, come specificato nel certificato TLS/SSL.Specifica il parametro
tls_root_ca_file
e imposta il percorso in cui è archiviato il certificato TLS/SSL come valore.
Salva il file di configurazione.
Riavvia l'agente per applicare le nuove impostazioni:
sudo systemctl restart google-cloud-sap-agent
Verifica che l'agente stia raccogliendo le metriche di monitoraggio di SAP HANA. Per le istruzioni, consulta Visualizzare le altre metriche.
Disinstalla l'agente Monitoring per SAP HANA.
Se dopo questo upgrade si verificano problemi di connessione con le tue istanze SAP HANA, puoi visualizzare i log dell'agente in Logging e utilizzare la guida alla risoluzione dei problemi per risolvere il problema.
Aggiorna l'agente di Google Cloud per SAP
Questa sezione fornisce la procedura per verificare se è disponibile una versione aggiornata dell'Agente di Google Cloud per SAP e come eseguire l'aggiornamento alla versione 3.4 (più recente) dell'Agente di Google Cloud per SAP.
Se devi eseguire l'aggiornamento a una versione dell'agente non quella più recente, contatta l'assistenza clienti Google Cloud.
Verifica la disponibilità di aggiornamenti
Seleziona il tuo sistema operativo, quindi procedi nel seguente modo:
RHEL
Stabilisci una connessione SSH con l'istanza VM host o il server Bare Metal Solution.
Esegui questo comando:
sudo yum check-update google-cloud-sap-agent
SLES
Stabilisci una connessione SSH con l'istanza VM host o il server Bare Metal Solution.
Esegui questo comando:
sudo zypper list-updates -r google-cloud-sap-agent
Windows
Stabilisci una connessione RDP con la tua istanza VM host.
In qualità di amministratore, esegui il comando seguente da PowerShell:
googet latest google-cloud-sap-agent
Installa un aggiornamento
Per aggiornare l'istanza dell'agente Google Cloud per SAP alla versione 3.4 (più recente), seleziona il tuo sistema operativo e segui i passaggi.
Se devi installare una versione dell'agente non quella più recente, contatta l'assistenza clienti Google Cloud.
RHEL
Stabilisci una connessione SSH con l'istanza VM host o il server Bare Metal Solution.
Esegui questo comando:
sudo yum --nogpgcheck update google-cloud-sap-agent
SLES
Stabilisci una connessione SSH con l'istanza VM host o il server Bare Metal Solution.
Esegui questo comando:
sudo zypper --no-gpg-checks update google-cloud-sap-agent
Windows
Stabilisci una connessione RDP con la tua istanza VM host.
In qualità di amministratore, esegui il comando seguente da PowerShell:
googet install google-cloud-sap-agent
Esegui il rollback all'utilizzo dell'agente di monitoraggio per SAP HANA
Se vuoi eseguire il rollback all'utilizzo dell'agente di monitoraggio per SAP HANA e smettere di utilizzare la funzionalità di monitoraggio SAP HANA dell'agente di Google Cloud per SAP, segui questi passaggi:
RHEL
Stabilisci una connessione SSH con l'istanza VM host o il server Bare Metal Solution.
Per impedire la raccolta di metriche duplicate, disabilita la raccolta delle metriche di monitoraggio SAP HANA da parte dell'agente di Google Cloud per SAP:
Apri il file di configurazione dell'agente di Google Cloud per SAP:
/etc/google-cloud-sap-agent/configuration.json
Nella sezione
hana_monitoring_configuration
, imposta il parametroenabled
sufalse
.Salva il file di configurazione.
Riavvia l'agente per applicare le nuove impostazioni:
sudo systemctl restart google-cloud-sap-agent
Copia la configurazione dell'agente di monitoraggio per SAP HANA dal seguente file:
/etc/google-cloud-sap-agent/backup-of-hanamonitoring-configuration.yaml
Installa l'agente Monitoring per SAP HANA versione 2. Per le istruzioni di installazione, consulta la guida all'installazione e alle operazioni dell'agente Monitoring per SAP HANA V2.0.
Nel file seguente, incolla la configurazione dell'agente di monitoraggio per SAP HANA che hai copiato in un passaggio precedente:
/usr/sap/google-saphanamonitoring-agent/conf/configuration.yaml
Riavvia l'agente Monitoring per SAP HANA:
sudo systemctl start google-saphanamonitoring-agent
SLES
Stabilisci una connessione SSH con l'istanza VM host o il server Bare Metal Solution.
Per impedire la raccolta di metriche duplicate, disabilita la raccolta delle metriche di monitoraggio SAP HANA da parte dell'agente di Google Cloud per SAP:
Apri il file di configurazione dell'agente di Google Cloud per SAP:
/etc/google-cloud-sap-agent/configuration.json
Nella sezione
hana_monitoring_configuration
, imposta il parametroenabled
sufalse
.Salva il file di configurazione.
Riavvia l'agente per applicare le nuove impostazioni:
sudo systemctl restart google-cloud-sap-agent
Copia la configurazione dell'agente di monitoraggio per SAP HANA dal seguente file:
/etc/google-cloud-sap-agent/backup-of-hanamonitoring-configuration.yaml
Installa l'agente Monitoring per SAP HANA versione 2. Per le istruzioni di installazione, consulta la guida all'installazione e alle operazioni dell'agente Monitoring per SAP HANA V2.0.
Nel file seguente, incolla la configurazione dell'agente di monitoraggio per SAP HANA che hai copiato in un passaggio precedente:
/usr/sap/google-saphanamonitoring-agent/conf/configuration.yaml
Riavvia l'agente Monitoring per SAP HANA:
sudo systemctl start google-saphanamonitoring-agent
Visualizza i log dell'agente in Cloud Logging
Per impostazione predefinita, i log dell'agente per SAP di Google Cloud vengono reindirizzati dalle istanze VM e dai server Bare Metal Solution a Cloud Logging.
Per visualizzare i log dell'agente in Logging, segui questi passaggi:
Nella console Google Cloud, vai alla pagina Esplora log.
Vai al riquadro Query.
Nel menu a discesa Risorse, seleziona Globale, quindi fai clic su Applica.
Nell'editor query, inserisci
google-cloud-sap-agent
.Fai clic su Esegui query.
Dovresti visualizzare i log generati dalle istanze dell'agente in esecuzione su tutte le istanze VM o sui server Bare Metal Solution. Per filtrare i log da una macchina specifica, usa i filtri disponibili nell'interfaccia.
Puoi disabilitare questo reindirizzamento predefinito dei log dell'agente. Per farlo, segui questi passaggi:
Stabilisci una connessione SSH con l'istanza VM host del server Bare Metal Solution.
Apri il seguente file di configurazione:
/etc/google-cloud-sap-agent/configuration.json
Per il parametro
log_to_cloud
, aggiorna il valore infalse
.Salva il file di configurazione.
Per applicare questa modifica, riavvia l'agente.