Versione 1: guida alle operazioni dell'agente di Google Cloud per SAP

Questa guida tratta considerazioni operative e procedure per l'esecuzione della versione 1 dell'agente per SAP di Google Cloud su istanze VM di Compute Engine e server Bare Metal Solution.

Informazioni sul ciclo di vita dell'agente

Quando si gestiscono le operazioni dell'agente di Google Cloud per SAP, è utile capire cosa fa l'agente. Ecco come funziona in generale:

Devi installare l'agente Google Cloud per SAP su ogni istanza VM di Compute Engine o server Bare Metal Solution che ospita sistemi SAP. L'agente viene eseguito come servizio Linux o Windows.
Nelle istanze VM di Compute Engine, l'agente combina i dati di monitoraggio di Monitoring e delle API Compute Engine.
Sui server Bare Metal Solution, per la raccolta solo delle metriche dell'agente host SAP, l'agente non accede alle API Google Cloud.
L'agente host SAP esegue il polling dell'agente di Google Cloud per SAP in cerca dei dati memorizzati nella cache tramite HTTP. Aggrega le metriche dell'agente host SAP, le segnala e le archivia nel database SAP NetWeaver.
La transazione SAP ST06 o l'interfaccia a riga di comando saposcol mostra le metriche aggregate dell'agente host SAP.
Puoi visualizzare le metriche dell'agente host SAP 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 averlo riavviato, puoi verificare che l'agente funzioni come previsto.

Per verificare se l'agente è in esecuzione:

Linux

Stabilisci una connessione SSH con il server o l'istanza VM di 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 mostra Running.

Se l'agente per SAP di Google Cloud non è in esecuzione, riavvia l'agente.

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

Visualizza le metriche monitorate

Dopo aver installato o aggiornato la configurazione dell'agente di Google Cloud per SAP, puoi visualizzare le metriche dell'agente host SAP monitorate.

Per visualizzare le metriche dell'agente host SAP monitorate, 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 questo comando da PowerShell:

(Invoke-WebRequest -Uri 'http://localhost:18181').RawContent

Se le metriche sono disponibili, dovresti visualizzare 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>

Verificare le metriche di monitoraggio dei processi e le metriche di valutazione del Gestore carichi di lavoro

Dopo aver aggiornato la configurazione, devi verificare che siano disponibili le metriche di monitoraggio dei processi e di valutazione del Gestore carichi di lavoro. Puoi accedere alle metriche e alle informazioni raccolte dall'agente di Google Cloud per SAP in Cloud Monitoring.

Per verificare le metriche in Monitoring:

Nella console Google Cloud, vai alla pagina Metrics Explorer di Monitoring.

Vai a Metrics Explorer
Seleziona la scheda Configurazione.
Espandi il menu Seleziona una metrica.
Nel menu Risorse, seleziona Istanza VM.
Nel menu Categoria metrica, seleziona sap.
Nel menu Metrica, seleziona metric: workload.googleapis.com/sap/service/active o una delle nuove metriche da tracciare.
Fai clic su Applica.

Dovresti vedere un grafico con i valori delle metriche delle serie temporali.

Riavvia l'agente

Se l'agente Google Cloud per SAP smette di funzionare o ne aggiorni la configurazione, riavvia l'agente.

Seleziona il tuo sistema operativo, quindi segui i passaggi:

Linux

Stabilisci una connessione SSH con l'istanza VM host.

Esegui questo comando:

sudo systemctl restart google-cloud-sap-agent

Windows

Stabilisci una connessione RDP con l'istanza VM host.
In qualità di amministratore, esegui questo comando da PowerShell:
```
Restart-Service -Name 'google-cloud-sap-agent' -Force
```

Esegui l'upgrade all'agente di Google Cloud per SAP dall'agente di monitoraggio per SAP NetWeaver

L'installazione dell'agente Google Cloud per SAP rileva automaticamente le versioni precedenti dell'agente di monitoraggio per SAP NetWeaver, disattiva l'agente e lo rimuove dal server host durante l'installazione.

Se viene rilevato l'agente di monitoraggio per SAP NetWeaver e viene rilevato un file di configurazione esistente durante l'installazione, il processo di installazione esegue automaticamente la migrazione delle configurazioni esistenti all'agente per SAP di Google Cloud.

Per istruzioni sull'installazione e la configurazione dell'agente Google Cloud per SAP, consulta la guida alla scelta dell'agente Google Cloud per la configurazione SAP.

Aggiorna l'agente Google Cloud per SAP

Questa sezione fornisce i passaggi per verificare se è disponibile una versione aggiornata dell'agente per SAP di Google Cloud e come eseguire l'aggiornamento alla versione 3.2 (più recente) dell'agente per SAP di Google Cloud.

Se devi eseguire l'aggiornamento a una versione dell'agente diversa da quella più recente, contatta l'assistenza clienti Google Cloud.

Verifica la disponibilità di aggiornamenti

Seleziona il tuo sistema operativo, quindi segui i passaggi:

RHEL

Stabilisci una connessione SSH con l'istanza VM host.

Esegui questo comando:

sudo yum check-update google-cloud-sap-agent

SLES

Stabilisci una connessione SSH con l'istanza VM host.

Esegui questo comando:

sudo zypper list-updates -r google-cloud-sap-agent

Windows

Stabilisci una connessione RDP con l'istanza VM host.
In qualità di amministratore, esegui questo comando da PowerShell:
```
googet latest google-cloud-sap-agent
```

Installa un aggiornamento

Per aggiornare l'istanza dell'agente per SAP di Google Cloud alla versione 3.2 (più recente), seleziona il sistema operativo, quindi segui i passaggi.

Se devi installare una versione dell'agente non più recente, contatta l'assistenza clienti Google Cloud.

RHEL

Stabilisci una connessione SSH con l'istanza VM host.

Esegui questo comando:

sudo yum --nogpgcheck update google-cloud-sap-agent

SLES

Stabilisci una connessione SSH con l'istanza VM host.

Esegui questo comando:

sudo zypper --no-gpg-checks update google-cloud-sap-agent

Windows

Stabilisci una connessione RDP con l'istanza VM host.
In qualità di amministratore, esegui questo comando da PowerShell:
```
googet install google-cloud-sap-agent
```

Esegui il rollback a una versione precedente

Se necessario, puoi eseguire il rollback dell'agente di Google Cloud per SAP versione 1 all'agente di monitoraggio per SAP NetWeaver versione 2.

Seleziona il tuo sistema operativo, quindi segui i passaggi:

RHEL

Stabilisci una connessione SSH con l'istanza VM host.
Esegui questo comando:
```
sudo yum remove google-cloud-sap-agent
```
Installare l'agente di monitoraggio per SAP NetWeaver versione 2. Per istruzioni su come installare l'agente di monitoraggio per SAP NetWeaver, consulta la guida all'installazione dell'agente di monitoraggio per SAP NetWeaver.

SLES

Stabilisci una connessione SSH con l'istanza VM host.

Esegui questo comando:

sudo zypper remove google-cloud-sap-agent

Installare l'agente di monitoraggio per SAP NetWeaver versione 2. Per istruzioni su come installare l'agente di monitoraggio per SAP NetWeaver, consulta la guida all'installazione dell'agente di monitoraggio per SAP NetWeaver.

Windows

Stabilisci una connessione RDP con l'istanza VM host.
In qualità di amministratore, esegui questo comando da PowerShell:
```
googet remove google-cloud-sap-agent
```
Installare l'agente di monitoraggio per SAP NetWeaver versione 2. Per istruzioni su come installare l'agente di monitoraggio per SAP NetWeaver, consulta la guida all'installazione dell'agente di monitoraggio per SAP NetWeaver.

Visualizza i log dell'agente in Cloud Logging

Per impostazione predefinita, i log dell'agente di Google Cloud per SAP 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 a Esplora log
Vai al riquadro Query.
Dal menu a discesa Risorse, seleziona Globale e 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, utilizza 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 file di configurazione seguente:

/etc/google-cloud-sap-agent/configuration.json

Per il parametro log_to_cloud, aggiorna il valore in false.
Salva il file di configurazione.
Riavvia l'agente per applicare la modifica.