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

Questa guida tratta considerazioni operative e procedure per l'esecuzione della versione 2 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

  1. Stabilisci una connessione SSH con il server o l'istanza VM di 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 per SAP di Google Cloud non è in esecuzione, riavvia l'agente.

Controlla la versione dell'agente

Dopo aver installato o riavviato l'agente Google Cloud per SAP, puoi verificare la versione dell'agente.

Per controllare la versione dell'agente, completa i seguenti passaggi:

Linux

Per RHEL, procedi nel seguente modo:

  1. Utilizza SSH per connetterti alla macchina host.
  2. Esegui questo comando: 
    yum info google-cloud-sap-agent

Per SLES, segui questi passaggi:

  1. Utilizza SSH per connetterti alla macchina host.
  2. Esegui questo comando: 
    zypper info google-cloud-sap-agent

Windows

  1. Utilizza RDP per la connessione alla macchina host.
  2. In qualità di amministratore, esegui questo comando da PowerShell: 
    googet installed google-cloud-sap-agent

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:

  1. Nel tuo sistema SAP, inserisci la transazione ST06.

  2. 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 dell'agente host SAP

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

Per visualizzare le metriche dell'agente host SAP raccolte dall'agente di Google Cloud per SAP, 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 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>

Visualizza le altre metriche

Dopo aver aggiornato la configurazione dell'agente di Google Cloud per SAP per raccogliere le metriche di monitoraggio dei processi, 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 per SAP di Google Cloud in Cloud Monitoring seguendo questi passaggi:

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

    Vai a Metrics Explorer

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

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

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

  2. Esegui questo comando: 

    sudo systemctl restart google-cloud-sap-agent

Windows

  1. Stabilisci una connessione RDP con l'istanza VM host.

  2. 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 da altri agenti Google Cloud

Se installi l'agente di Google Cloud per SAP, vengono rilevate automaticamente le versioni precedenti dell'agente di monitoraggio per SAP NetWeaver e l'agente di monitoraggio per SAP HANA, vengono disabilitate e quindi rimosse dalle macchine host durante l'installazione.

Se vengono rilevati questi agenti Google Cloud, viene eseguita anche la migrazione delle configurazioni nei relativi file di configurazione all'agente per SAP di Google Cloud durante l'installazione. A scopo di backup e 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 dell'agente Google Cloud per SAP, consulta la guida alla scelta dell'agente Google Cloud per la configurazione SAP.

Upgrade delle istanze abilitate per SSL

Se hai configurato l'agente di monitoraggio per SAP HANA in modo che utilizzi i certificati SSL per la comunicazione con le tue istanze SAP HANA, quando installi l'agente di Google Cloud per SAP viene eseguita la migrazione di tutta la configurazione di monitoraggio di SAP HANA, ad eccezione della configurazione SSL, all'agente per SAP di Google Cloud. In questo caso, per utilizzare l'agente per SAP di Google Cloud per il monitoraggio delle istanze SAP HANA, devi completare i seguenti passaggi:

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

  2. Apri il file di configurazione dell'agente per SAP di Google Cloud:

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

  3. Nella sezione hana_monitoring_configuration, imposta il parametro enabled su true.

  4. Nella sezione hana_monitoring_configuration.hana_instances, esegui le operazioni seguenti per ogni istanza SAP HANA che utilizza il protocollo TLS/SSL per le comunicazioni sicure:

    1. Specifica il parametro enable_ssl e impostane il valore su true.

    2. Specifica il parametro host_name_in_certificate e imposta come valore il nome host SAP HANA, come specificato nel certificato TLS/SSL.

    3. Specifica il parametro tls_root_ca_file e imposta il percorso in cui è archiviato il certificato TLS/SSL.

  5. Salva il file di configurazione.

  6. Riavvia l'agente per applicare le nuove impostazioni:

    sudo systemctl restart google-cloud-sap-agent

  7. Verifica che l'agente stia raccogliendo le metriche di monitoraggio SAP HANA. Per istruzioni, consulta Visualizzare le altre metriche.

  8. Disinstalla l'agente di monitoraggio per SAP HANA.

Se riscontri problemi di connessione con le tue istanze SAP HANA dopo questo upgrade, puoi visualizzare i log dell'agente in Logging e utilizzare la guida alla risoluzione dei problemi per risolvere il problema.

Aggiorna l'agente Google Cloud per SAP

Questa sezione fornisce i passaggi per verificare la disponibilità di una versione aggiornata dell'agente per SAP di Google Cloud e la procedura per eseguire l'aggiornamento alla versione 3.3 (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

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

  2. Esegui questo comando: 

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

SLES

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

  2. Esegui questo comando: 

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

Windows

  1. Stabilisci una connessione RDP con l'istanza VM host.

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

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

  2. Esegui questo comando: 

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

SLES

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

  2. Esegui questo comando: 

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

Windows

  1. Stabilisci una connessione RDP con l'istanza VM host.

  2. In qualità di amministratore, esegui questo comando 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'agente di monitoraggio per SAP HANA e interrompere l'utilizzo della funzionalità di monitoraggio SAP HANA dell'agente per SAP di Google Cloud, segui questi passaggi:

RHEL

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

  2. Per impedire la raccolta di metriche duplicate, disabilita la raccolta delle metriche di monitoraggio SAP HANA da parte dell'agente per SAP di Google Cloud:

    1. Apri il file di configurazione dell'agente per SAP di Google Cloud:

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

    2. Nella sezione hana_monitoring_configuration, imposta il parametro enabled su false.

    3. Salva il file di configurazione.

    4. Riavvia l'agente per applicare le nuove impostazioni:

      sudo systemctl restart google-cloud-sap-agent

  3. Copia la configurazione dell'agente di monitoraggio per SAP HANA dal seguente file:

    /etc/google-cloud-sap-agent/backup-of-hanamonitoring-configuration.yaml

  4. Installare l'agente di monitoraggio per SAP HANA versione 2. Per le istruzioni di installazione, consulta la guida all'installazione e al funzionamento dell'agente Monitoring per SAP HANA V2.0.

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

  6. Riavvia l'agente di monitoraggio per SAP HANA:

    sudo systemctl start google-saphanamonitoring-agent

SLES

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

  2. Per impedire la raccolta di metriche duplicate, disabilita la raccolta delle metriche di monitoraggio SAP HANA da parte dell'agente per SAP di Google Cloud:

    1. Apri il file di configurazione dell'agente per SAP di Google Cloud:

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

    2. Nella sezione hana_monitoring_configuration, imposta il parametro enabled su false.

    3. Salva il file di configurazione.

    4. Riavvia l'agente per applicare le nuove impostazioni:

      sudo systemctl restart google-cloud-sap-agent

  3. Copia la configurazione dell'agente di monitoraggio per SAP HANA dal seguente file:

    /etc/google-cloud-sap-agent/backup-of-hanamonitoring-configuration.yaml

  4. Installare l'agente di monitoraggio per SAP HANA versione 2. Per le istruzioni di installazione, consulta la guida all'installazione e al funzionamento dell'agente Monitoring per SAP HANA V2.0.

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

  6. Riavvia l'agente di monitoraggio per SAP HANA:

    sudo systemctl start google-saphanamonitoring-agent

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:

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

    Vai a Esplora log

  2. Vai al riquadro Query.

  3. Dal menu a discesa Risorse, seleziona Globale e 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, utilizza 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 file di configurazione seguente:

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