Versione 1: guida alla risoluzione dei problemi di Agent for SAP di Google Cloud

Version 1

• Versione 3.6 (latest)
• Versione 2
• Versione 1

Avviso:il supporto per la versione 1 dell'agente di Google Cloud per SAP è terminato il 4 giugno 2024.

Se utilizzi la versione 1 dell'agente, ti consigliamo di eseguire l'aggiornamento a una versione supportata il prima possibile. Per informazioni sulle versioni supportate, vedi Versioni supportate per SAP su Google Cloud. Per informazioni su come eseguire l'aggiornamento a una versione supportata del di Google, consulta Aggiorna l'agente di Google Cloud per SAP.

Questa guida mostra come risolvere i problemi relativi a: 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 per l'agente 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 per SAP di Google Cloud mostrano IAM insufficiente errore relativo alle autorizzazioni.

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: [e-mail]. 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	Visualizzatore di calcolo (roles/compute.viewer) Visualizzatore Monitoring (roles/monitoring.viewer)
Raccolta di metriche di Process Monitoring	Visualizzatore Compute (roles/compute.viewer) Autore delle metriche di Monitoring (roles/monitoring.metricWriter) Secret Manager Secret Accessor (roles/secretmanager.secretAccessor) (obbligatorio se utilizzi Secret Manager per autenticare l'account utente del database per SAP HANA).
Raccolta delle metriche di valutazione del Gestore carichi di lavoro	Visualizzatore Compute (roles/compute.viewer) Autore delle metriche di Monitoring (roles/monitoring.metricWriter) Secret Manager Secret Accessor (roles/secretmanager.secretAccessor) (obbligatorio se utilizzi Secret Manager per autenticare l'account utente del database per SAP HANA).

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

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

• Autorizza l'agente Monitoring
• Controllo dell'accesso

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

Problema: se limiti gli ambiti di accesso sull'istanza Compute dell'host, I log dell'agente Google Cloud per SAP potrebbero mostrare IAM insufficiente errore relativo alle autorizzazioni.

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

Risoluzione: ambiti di accesso sono il metodo legacy per specificare le autorizzazioni per l'istanza Compute. 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 servizio account con i ruoli IAM. Ad esempio:

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

Se limiti gli ambiti di accesso dell'istanza Compute, devi assicurarti l'istanza Compute host ha 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 tuo progetto Google Cloud:

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

Per modificare gli ambiti di accesso, devi arrestare l'istanza Compute, le modifiche e quindi riavvia l'istanza Compute. Per istruzioni, vedi Documentazione di Compute Engine. Non è necessario apportare modifiche alle autorizzazioni per i ruoli IAM per questo problema.

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: agente host SAP o il livello minimo di patch richiesto per l'agente host SAP L'agente host SAP non è installato. Affinché l'Agente per SAP di Google Cloud funzioni, Nel sistema SAP deve essere installato SAP Host Agent e la patch minima richiesta per l'agente host sia 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 di SAP.

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

• Linux: nota SAP 2460297 - SAP su Linux sulla piattaforma Google Cloud: monitoraggio avanzato
• Windows: nota SAP 1409604 - Virtualizzazione su Windows: monitoraggio avanzato

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

Problema: l'installazione dell'agente non va a buon fine 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.

Soluzione:per risolvere il problema, configura un gateway NAT che fornisca all'host l'accesso in uscita del server a internet. Per informazioni sulla configurazione per un gateway NAT, consulta la guida al deployment per il tuo sistema SAP. Ad esempio, per SAP NetWeaver, consulta:

• Configurazione di un gateway NAT su un'istanza VM di Compute Engine
• Guida al deployment di SAP NetWeaver su Linux
• Guida al deployment di SAP NetWeaver su Windows

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 per SAP di Google Cloud rimane in ascolto delle 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.

Assistenza per l'Agente per SAP di Google Cloud

Se hai bisogno di aiuto per risolvere un problema con l'agente di Google Cloud per SAP, Raccogli le informazioni diagnostiche richieste e contatta l'assistenza clienti Google Cloud. Per saperne di più, consulta le informazioni diagnostiche dell'Agente Google Cloud per SAP.