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

Questa guida illustra le considerazioni e le procedure operative per eseguire la versione 1 di Agent for SAP di Google Cloud su istanze VM Compute Engine, istanze bare metal Compute Engine e server Bare Metal Solution.

Informazioni sul ciclo di vita degli agenti

Quando gestisci 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 Compute Engine o server Bare Metal Solution che ospita i sistemi SAP. L'agente viene eseguito come servizio Linux o Windows.
  • Nelle istanze 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 di Google Cloud.
  • L'agente host SAP esegue il polling dell'agente di Google Cloud per SAP per i suoi dati memorizzati nella cache tramite HTTP. Aggrega le metriche di SAP Host Agent, le registra e le archivia nel database SAP NetWeaver.
  • La transazione ST06 di SAP o l'interfaccia a riga di comando saposcol visualizzano le metriche aggregate di SAP Host Agent.
  • Puoi visualizzare le metriche dell'agente host SAP dall'agente di Google Cloud per SAP eseguendo un comando in una finestra del terminale.

Verifica che l'agente sia in esecuzione

Dopo aver installato o riavviato l'agente, puoi verificare che sia in esecuzione come previsto.

Per verificare se l'agente è in esecuzione:

Linux

  1. Stabilisci una connessione SSH con il server Bare Metal Solution o l'istanza Compute Engine.

  2. 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

  1. Utilizza RDP per connetterti all'istanza Compute Engine.

  2. In qualità di amministratore, esegui il seguente 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 di Google Cloud per SAP non è in esecuzione, riavvialo.

Verificare che l'agente host SAP riceva 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:

  1. Nel sistema SAP, inserisci la transazione ST06.

  2. 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:

    • Fornitore di servizi cloud: Google Cloud Platform
    • Accesso al monitoraggio avanzato: TRUE
    • Dettagli sul monitoraggio migliorato: ACTIVE

Visualizzare 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 monitorate di SAP Host Agent:

Linux

  1. Stabilisci una connessione SSH con l'istanza Compute Engine o il server Bare Metal Solution di destinazione.

  2. 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

  1. Utilizza RDP per connetterti all'istanza Compute Engine.

  2. In qualità di amministratore, esegui il seguente 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>

Verifica le metriche di monitoraggio dei processi e le metriche di valutazione di Workload Manager

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

Per verificare le metriche in Monitoraggio:

  1. Nella console Google Cloud, vai alla pagina Esplora metriche di Monitoring.

    Vai a Esplora metriche

  2. Seleziona la scheda Configurazione.

  3. Espandi il menu Seleziona una metrica.

  4. Nel menu Risorse, seleziona Istanza VM.

  5. Nel menu Categoria metrica, seleziona sap.

  6. Nel menu Metrica, seleziona metric: workload.googleapis.com/sap/service/active o una delle nuove metriche da includere nel grafico.

  7. Fai clic su Applica.

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

Riavvia l'agente

Se l'agente di Google Cloud per SAP smette di funzionare o se aggiorni la relativa configurazione, riavvialo.

Seleziona il tuo sistema operativo e segui i passaggi:

Linux

  1. Stabilisci una connessione SSH con l'istanza di calcolo host.

  2. Esegui questo comando: 

    sudo systemctl restart google-cloud-sap-agent

Windows

  1. Stabilisci una connessione RDP con l'istanza di calcolo host.

  2. In qualità di amministratore, esegui il seguente comando da PowerShell: 

    Restart-Service -Name 'google-cloud-sap-agent' -Force

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

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

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

Per istruzioni su come installare e configurare l'agente di Google Cloud per SAP, consulta la guida all'installazione e alla configurazione dell'agente di Google Cloud per SAP.

Aggiorna l'agente di Google Cloud per SAP

Questa sezione illustra i passaggi per verificare se è disponibile una versione aggiornata dell'agente di Google Cloud per SAP e come eseguire l'aggiornamento alla versione 3.6 (ultima) dell'agente di Google Cloud per SAP.

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

Cerca aggiornamenti

Seleziona il tuo sistema operativo e segui i passaggi:

RHEL

  1. Stabilisci una connessione SSH con l'istanza di calcolo host.

  2. Esegui questo comando: 

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

SLES

  1. Stabilisci una connessione SSH con l'istanza di calcolo host.

  2. Esegui questo comando: 

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

Windows

  1. Stabilisci una connessione RDP con l'istanza di calcolo host.

  2. In qualità di amministratore, esegui il seguente comando da PowerShell: 

    googet latest google-cloud-sap-agent

Installare un aggiornamento

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

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

RHEL

  1. Stabilisci una connessione SSH con l'istanza di calcolo host.

  2. Esegui questo comando: 

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

SLES

  1. Stabilisci una connessione SSH con l'istanza di calcolo host.

  2. Esegui questo comando: 

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

Windows

  1. Stabilisci una connessione RDP con l'istanza di calcolo host.

  2. In qualità di amministratore, esegui il seguente comando da PowerShell: 

    googet install google-cloud-sap-agent

Eseguire 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 e segui i passaggi:

RHEL

  1. Stabilisci una connessione SSH con l'istanza di calcolo host.

  2. Esegui questo comando: 

    sudo yum remove google-cloud-sap-agent

  3. Installa 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 Scegli l'agente di monitoraggio per SAP NetWeaver.

SLES

  1. Stabilisci una connessione SSH con l'istanza di calcolo host.

  2. Esegui questo comando: 

    sudo zypper remove google-cloud-sap-agent

  3. Installa 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 Scegli l'agente di monitoraggio per SAP NetWeaver.

Windows

  1. Stabilisci una connessione RDP con l'istanza di calcolo host.

  2. In qualità di amministratore, esegui il seguente comando da PowerShell: 

    googet remove google-cloud-sap-agent

  3. Installa 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 Scegli l'agente di monitoraggio per SAP NetWeaver.

Visualizza i log dell'agente in Cloud Logging

Per impostazione predefinita, i log dell'agente per SAP di Google Cloud vengono reindirizzati dalle istanze Compute Engine e dai server Bare Metal Solution a Cloud Logging.

Per visualizzare i log dell'agente in Log:

  1. Nella console Google Cloud, vai alla pagina Esplora log.

    Vai a Esplora log

  2. Vai al riquadro Query.

  3. Nel menu a discesa Risorse, seleziona Globale e poi fai clic su Applica.

  4. Nell'editor delle query, inserisci google-cloud-sap-agent.

  5. Fai clic su Esegui query.

Visualizzi i log generati dalle istanze dell'agente in esecuzione su tutte le tue istanze Compute Engine o sui server Bare Metal Solution. Per filtrare i log di una macchina specifica, utilizza i filtri disponibili nell'interfaccia.

Puoi disattivare questo reindirizzamento predefinito dei log dell'agente. Per farlo, segui questi passaggi:

  1. Stabilisci una connessione SSH con l'istanza Compute Engine di hosting del server Bare Metal Solution.

  2. Apri il seguente file di configurazione:

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

  3. Per il parametro log_to_cloud, aggiorna il valore in false.

  4. Salva il file di configurazione.

  5. Riavvia l'agente per applicare la modifica.