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

Questa guida tratta considerazioni operative e procedure per che esegue la versione 2 dell'agente Google Cloud per SAP Istanze VM di Compute Engine e server Bare Metal Solution.

Comprendi il ciclo di vita degli agenti

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

  • Devi installare l'agente di Google Cloud per SAP su ogni un'istanza VM di Compute Engine o un server Bare Metal Solution. i sistemi SAP. L'agente viene eseguito come servizio Linux o Windows completamente gestito di Google Cloud.
  • Nelle istanze VM di Compute Engine, l'agente combina il monitoraggio dei dati 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 verificare la sua cache tramite HTTP. Aggrega le metriche di SAP Host Agent, le riporta, e li archivia nel database SAP NetWeaver.
  • Transazione di SAP ST06 o interfaccia a riga di comando saposcol visualizza 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 l'agente o riavviato l'agente, puoi verificare l'agente sia in esecuzione come previsto.

Per verificare se l'agente è in esecuzione, segui questi passaggi:

Linux

  1. Stabilisci una connessione SSH un'istanza VM o un server 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. Come amministratore, esegui il comando seguente da PowerShell: 

    $(Get-Service -Name 'google-cloud-sap-agent' -ErrorAction Ignore).Status
    Se l'agente è in esecuzione, lo stato è Running.

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

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

Linux

Per RHEL, segui questi passaggi:

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

Per SLES:

  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. Come 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 siano raccolte l'agente Google Cloud per SAP e inviato correttamente a SAP Host Agent. segui questi passaggi:

  1. Nel sistema SAP, inserisci la transazione ST06.

  2. Nel riquadro Panoramica, verifica la disponibilità e il contenuto i seguenti campi per la corretta configurazione end-to-end di SAP e di Google dell'infrastruttura di monitoraggio:

    • Provider cloud: Google Cloud Platform
    • Accesso a monitoraggio avanzato: TRUE
    • Dettagli sul monitoraggio avanzato: ACTIVE

Visualizza le metriche di SAP Host Agent

Dopo aver installato o aggiornato la configurazione dell'agente di Google Cloud 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

  1. Stabilisci una connessione SSH con l'istanza VM host di 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. Come 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 Google Cloud per SAP per raccogliere metriche di Process Monitoring, metriche di valutazione del Gestore carichi di lavoro o le metriche di monitoraggio SAP HANA, devi visualizzarle per verificare che mentre l'agente sta raccogliendo le metriche come previsto.

Puoi visualizzare le metriche e le informazioni raccolte dall'agente di Google Cloud per SAP in Cloud Monitoring svolgendo i seguenti 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 qualsiasi delle nuove metriche da rappresentare su 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, quindi riavvia l'agente.

Seleziona il tuo sistema operativo, quindi procedi nel seguente modo:

Linux

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

  2. Esegui questo comando: 

    sudo systemctl restart google-cloud-sap-agent

Windows

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

  2. Come 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 di Google Cloud Agent for SAP rileva automaticamente le versioni precedenti di il di monitoraggio per SAP NetWeaver e agente di monitoraggio per SAP HANA, le disabilita, e poi li rimuove dalle macchine host durante l'installazione.

Se vengono rilevati questi agenti Google Cloud, le configurazioni in dei file di configurazione viene inoltre eseguita la migrazione all'Agente per SAP di Google Cloud la sua installazione. A scopo di backup e di riferimento, la configurazione l'agente Monitoring per SAP HANA viene copiato 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 Scegli la guida all'installazione e alla configurazione dell'Agente per SAP di Google Cloud.

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 installare l'agente di Google Cloud per SAP, tutte le configurazioni di monitoraggio SAP HANA tranne la migrazione della configurazione SSL all'agente di Google Cloud per SAP. In queste per utilizzare l'Agente per SAP di Google Cloud per monitorare SAP HANA devi completare questi passaggi:

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

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

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

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

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

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

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

    3. Specifica il parametro tls_root_ca_file e imposta il percorso, dove il valore il certificato TLS/SSL viene archiviato, come relativo valore.

  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 di SAP HANA. Per istruzioni, consulta Visualizzare le altre metriche.

  8. Disinstalla l'agente Monitoring per SAP HANA.

Se dopo questo passaggio si verificano problemi di connessione con le tue istanze SAP HANA eseguire l'upgrade, visualizza i log dell'agente in Logging e utilizza 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 una versione aggiornata L'agente Google Cloud per SAP è disponibile e spiega come eseguire l'aggiornamento versione 3.4 (più recente) dell'agente 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 l'istanza VM host oppure 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 oppure server Bare Metal Solution.

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

  1. Stabilisci una connessione SSH con l'istanza VM host oppure 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 oppure 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 la tua istanza VM host.

  2. Come 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 Google Cloud per SAP, quindi segui questi passaggi:

RHEL

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

  2. Per impedire la raccolta di metriche duplicate, disattiva la di metriche di monitoraggio SAP HANA Agente Google Cloud per SAP:

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

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

    2. Nella sezione hana_monitoring_configuration, imposta il parametro enabled a 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 da quanto segue file:

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

  4. Installa l'agente Monitoring per SAP HANA versione 2. Per installazione istruzioni, vedi Guida all'installazione e al funzionamento dell'agente di monitoraggio per SAP HANA V2.0.

  5. Nel file seguente, incolla la configurazione del 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 Monitoring per SAP HANA:

    sudo systemctl start google-saphanamonitoring-agent

SLES

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

  2. Per impedire la raccolta di metriche duplicate, disattiva la di metriche di monitoraggio SAP HANA Agente Google Cloud per SAP:

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

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

    2. Nella sezione hana_monitoring_configuration, imposta il parametro enabled a 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 da quanto segue file:

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

  4. Installa l'agente Monitoring per SAP HANA versione 2. Per installazione istruzioni, vedi Guida all'installazione e al funzionamento dell'agente di monitoraggio per SAP HANA V2.0.

  5. Nel file seguente, incolla la configurazione del 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 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 Google Cloud per SAP vengono reindirizzati dalla tua di Compute Engine e i server Bare Metal Solution 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 vedere i log generati dalle istanze dell'agente in esecuzione su tutti i tuoi di istanze VM o server Bare Metal Solution. Per filtrare i log da una specifica puoi utilizzare i filtri disponibili nell'interfaccia.

Puoi disabilitare questo reindirizzamento predefinito dei log dell'agente. Per farlo, segui queste istruzioni: passaggi:

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

  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 affinché la modifica abbia effetto.