Versione 1: guida alle operazioni di Agente Google Cloud per SAP

Questa guida illustra le considerazioni operative e le 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.

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 comando saposcol 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

  1. Stabilisci una connessione SSH con il tuo server o la tua istanza VM Bare Metal Solution.

  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 la connessione all'istanza VM.

  2. 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 di Google Cloud per SAP non è in esecuzione, riavvia l'agente.

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:

  1. Nel sistema SAP, inserisci la transazione ST06.

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

Visualizzare le metriche monitorate

Dopo aver installato o aggiornato la configurazione di Google Cloud Agent per SAP, puoi visualizzare le metriche di SAP Host Agent monitorate.

Per visualizzare le metriche monitorate di SAP Host Agent, segui questi passaggi:

Linux

  1. Stabilisci una connessione SSH con l'istanza VM host del server Bare Metal Solution.

  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 la connessione all'istanza VM.

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

Verificare le metriche di Process Monitoring e le metriche di valutazione del Gestore carichi di lavoro

Dopo aver aggiornato la configurazione, devi verificare che le metriche di monitoraggio dei processi e 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 Monitoring, segui questi passaggi:

  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 di metrica, seleziona sap.

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

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

  1. Stabilisci una connessione SSH con la tua istanza VM host.

  2. Esegui questo comando: 

    sudo systemctl restart google-cloud-sap-agent

Windows

  1. Stabilisci una connessione RDP con la tua istanza VM host.

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

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

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

L'installazione dell'agente per SAP di Google Cloud rileva automaticamente le versioni precedenti dell'agente di monitoraggio per SAP NetWeaver, disattiva l'agente e poi rimuove l'agente 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, durante il processo di installazione le configurazioni esistenti vengono migrate automaticamente nell'agente per SAP di Google Cloud.

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.

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.3 (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

  1. Stabilisci una connessione SSH con la tua istanza VM host.

  2. Esegui questo comando: 

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

SLES

  1. Stabilisci una connessione SSH con la tua istanza VM host.

  2. Esegui questo comando: 

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

Windows

  1. Stabilisci una connessione RDP con la tua istanza VM host.

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

  1. Stabilisci una connessione SSH con la tua istanza VM host.

  2. Esegui questo comando: 

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

SLES

  1. Stabilisci una connessione SSH con la tua istanza VM host.

  2. Esegui questo comando: 

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

Windows

  1. Stabilisci una connessione RDP con la tua istanza VM host.

  2. In qualità di amministratore, esegui il comando seguente 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 procedi nel seguente modo:

RHEL

  1. Stabilisci una connessione SSH con la tua istanza VM host.

  2. Esegui questo comando: 

    sudo yum remove google-cloud-sap-agent

  3. Installa l'agente Monitoring per SAP NetWeaver versione 2. Per istruzioni sull'installazione dell'agente Monitoring per SAP NetWeaver, consulta la Guida all'installazione dell'agente Monitoring per SAP NetWeaver.

SLES

  1. Stabilisci una connessione SSH con la tua istanza VM host.

  2. Esegui questo comando: 

    sudo zypper remove google-cloud-sap-agent

  3. Installa l'agente Monitoring per SAP NetWeaver versione 2. Per istruzioni su come installare l'agente Monitoring per SAP NetWeaver, consulta la guida all'installazione dell'agente Monitoring per SAP NetWeaver.

Windows

  1. Stabilisci una connessione RDP con la tua istanza VM host.

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

    googet remove google-cloud-sap-agent

  3. Installa l'agente Monitoring per SAP NetWeaver versione 2. Per istruzioni su come installare l'agente Monitoring per SAP NetWeaver, consulta la Guida all'installazione dell'agente Monitoring 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 VM e dai server Bare Metal Solution a Cloud Logging.

Per visualizzare i log dell'agente in Logging, segui questi passaggi:

  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, quindi fai clic su Applica.

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

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

  1. Stabilisci una connessione SSH con l'istanza VM host 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. Per applicare questa modifica, riavvia l'agente.