Versione 1: guida alla risoluzione dei problemi dell'agente di Google Cloud per SAP

Questa guida mostra come risolvere i problemi relativi alla versione 1 dell'agente di Google Cloud per SAP.

Logging

Controlla i log nella directory specifica per il tuo sistema operativo.

Per visualizzare i log dell'agente di Google Cloud per SAP, vai ai seguenti percorsi:

Linux

/var/log/google-cloud-sap-agent.log

Windows

C:\Program Files\Google\google-cloud-sap-agent\logs\google-cloud-sap-agent.log

Problemi comuni

Problema: autorizzazioni IAM insufficienti

Problema: i log dell'agente di Google Cloud per SAP mostrano un errore di autorizzazioni IAM insufficienti.

Causa: l'account di servizio non dispone delle autorizzazioni IAM richieste per accedere all'API Cloud Monitoring.

Risoluzione: nella console Google Cloud, nella pagina dei dettagli dell'istanza VM, prendi nota del nome dell'account di servizio della VM. Ad esempio: sap-example@example-project-123456.iam.gserviceaccount.com. Nella home page di IAM e amministrazione, assicurati che l'account di servizio includa i seguenti ruoli IAM:

Funzionalità Ruoli IAM richiesti
Raccolta delle metriche dell'agente host SAP
Raccolta delle metriche di monitoraggio dei processi
Raccolta delle metriche di valutazione di Workload Manager

Per ulteriori informazioni sull'autenticazione richiesta per Agent for SAP di Google Cloud, consulta Autenticazione e accesso.

Per confermare le autorizzazioni richieste dall'agente Cloud Monitoring, consulta la seguente documentazione di monitoraggio:

Problema: ambiti di accesso errati per l'account di servizio Compute

Problema: se limiti gli ambiti di accesso nell'istanza di calcolo host, i log dell'agente di Google Cloud per SAP potrebbero mostrare un errore di autorizzazioni IAM insufficienti.

Causa: l'agente di Google Cloud per SAP richiede ambiti di accesso minimi alle API Cloud sull'istanza di calcolo host. Questo errore si verifica quando l'account di servizio non possiede gli ambiti di accesso richiesti.

Risoluzione: gli ambiti di accesso sono il metodo legacy per specificare le autorizzazioni per l'istanza di calcolo. Compute Engine consiglia di configurare le istanze di calcolo in modo da consentire tutti gli ambiti di accesso a tutte le API Cloud e di utilizzare solo le autorizzazioni IAM dell'account di servizio di calcolo per controllare l'accesso alle risorse Google Cloud.

Per risolvere il problema, come best practice, imposta l'ambito di accesso all'cloud-platform completo sull'istanza di calcolo, quindi limita in modo sicuro l'accesso API del account di servizio account con i ruoli IAM. Ad esempio:

  • https://www.googleapis.com/auth/cloud-platform

Se limiti gli ambiti di accesso dell'istanza di calcolo, devi assicurarti che l'istanza di calcolo host abbia i seguenti ambiti di accesso:

  • https://www.googleapis.com/auth/source.read_write
  • https://www.googleapis.com/auth/compute
  • https://www.googleapis.com/auth/servicecontrol
  • https://www.googleapis.com/auth/service.management.readonly
  • https://www.googleapis.com/auth/logging.admin
  • https://www.googleapis.com/auth/monitoring
  • https://www.googleapis.com/auth/trace.append
  • https://www.googleapis.com/auth/devstorage.full_control

Se hai attivato la raccolta di metriche di monitoraggio dei processi o la raccolta di metriche di valutazione di Workload Manager, gli ambiti di accesso dell'istanza di calcolo host devono disporre anche dell'accesso in scrittura per pubblicare i dati delle metriche nel progetto Google Cloud:

  • https://www.googleapis.com/auth/monitoring.write

Per modificare gli ambiti di accesso, devi arrestare l'istanza di calcolo, apportare le modifiche e riavviare l'istanza di calcolo. Per le istruzioni, consulta la documentazione di Compute Engine. Per questo problema non è necessario apportare modifiche alle autorizzazioni per i ruoli IAM.

Problema: agente host SAP mancante o errato

Problema: i log dell'agente di Google Cloud per SAP mostrano un errore dell'agente host SAP mancante o errato.

Causa: l'agente host SAP o il livello di patch minimo richiesto per l'agente host SAP non è installato. Affinché l'agente di Google Cloud per SAP funzioni, il sistema SAP deve avere installato l'agente host SAP e il livello minimo di patch richiesto per l'agente host deve essere mantenuto.

Risoluzione: per risolvere il problema, installa la versione richiesta dell'agente host SAP. Per istruzioni su come installare l'agente host SAP, consulta la documentazione SAP.

Per i requisiti di versione dell'agente host SAP, consulta le seguenti note SAP:

Problema: l'installazione dell'agente di Google Cloud per SAP non è riuscita

Problema: l'installazione dell'agente non riesce quando viene eseguito il comando di installazione del gestore dei pacchetti (yum, zypper o googet).

Causa: l'installazione dell'agente non riesce perché il server host su cui è in esecuzione l'agente è stato creato senza un indirizzo IP pubblico o esterno.

Risoluzione: per risolvere il problema, configura un gateway NAT che consenta al server host di accedere a internet in uscita. Per informazioni su come configurare un gateway NAT, consulta la guida all'implementazione del sistema SAP. Ad esempio, per SAP NetWeaver, consulta:

Problema: errore di connessione rifiutata

Problema:i log di SAP Host Agent mostrano l'errore di connessione rifiutata.

Causa: l'agente di Google Cloud per SAP non può avviarsi perché la porta 18181 non è disponibile. L'agente di Google Cloud per SAP ascolta le richieste sulla porta 18181. Questa porta deve essere disponibile per l'avvio dell'agente.

Risoluzione: per risolvere il problema, assicurati che la porta 18181 sia disponibile per l'agente di Google Cloud per SAP. Se un altro servizio utilizza la porta 18181, potrebbe essere necessario riavviare l'altro servizio o riconfigurarlo in modo da utilizzare un'altra porta.

Ricevere assistenza per l'agente di Google Cloud per SAP

Se hai bisogno di aiuto per risolvere un problema con l'Agente per SAP di Google Cloud, raccoglie le informazioni di diagnostica richieste e contatta l'assistenza clienti Google Cloud. Per ulteriori informazioni, consulta le informazioni di diagnostica dell'agente di Google Cloud per SAP.