Questa guida mostra come risolvere i problemi relativi alla versione 1 dell'agente Google Cloud per SAP.
Logging
Controlla i log nella directory specifica del 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 un errore di autorizzazioni IAM insufficienti.
Causa: l'account di servizio non dispone delle autorizzazioni IAM necessarie per accedere all'API Cloud Monitoring.
Soluzione: nella pagina dei dettagli dell'istanza VM della console Google Cloud, annota il nome dell'account di servizio 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 di SAP Host Agent | |
Raccolta di metriche di Process Monitoring |
|
Raccolta delle metriche di valutazione del Gestore carichi di lavoro |
|
Per ulteriori informazioni sull'autenticazione richiesta per l'agente di Google Cloud per SAP, consulta Autenticazione e accesso.
Per confermare le autorizzazioni richieste dall'agente Cloud Monitoring, consulta la seguente documentazione di Monitoring:
Problema: Ambiti di accesso errati per l'account di servizio VM
Problema: se limiti gli ambiti di accesso sull'istanza VM host, i log dell'Agente per SAP di Google Cloud potrebbero mostrare un errore di autorizzazioni IAM insufficienti.
Causa: l'agente per SAP di Google Cloud richiede ambiti di accesso API Cloud minimi sull'istanza VM host. Questo errore si verifica quando l'account di servizio non dispone degli ambiti di accesso richiesti.
Soluzione: gli ambiti di accesso sono il metodo legacy per specificare le autorizzazioni per l'istanza VM. Compute Engine consiglia di configurare le istanze VM per consentire tutti gli ambiti di accesso a tutte le API Cloud e di utilizzare solo le autorizzazioni IAM dell'account di servizio VM per controllare l'accesso alle risorse Google Cloud.
Per risolvere il problema, come best practice, imposta l'ambito di accesso a tutti i cloud-platform
sull'istanza VM, quindi limita in modo sicuro l'accesso API dell'account di servizio con i ruoli IAM. Ad esempio:
https://www.googleapis.com/auth/cloud-platform
Se limiti gli ambiti di accesso della tua istanza VM, devi assicurarti che l'istanza VM 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 abilitato la raccolta delle metriche di Process Monitoring o la raccolta delle metriche di valutazione di Workload Manager, gli ambiti di accesso dell'istanza VM 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 VM, apportare le modifiche necessarie e quindi riavviare l'istanza VM. Per le istruzioni, consulta la documentazione di Compute Engine. Per questo problema non è necessario apportare modifiche alle autorizzazioni per i ruoli IAM.
Problema: SAP Host Agent mancante o errato
Problema: i log dell'agente Google Cloud per SAP mostrano un errore di SAP Host Agent 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 per SAP di Google Cloud funzioni, nel sistema SAP deve essere installato SAP Host Agent e viene mantenuto il livello minimo di patch richiesto per l'agente host.
Soluzione: per risolvere il problema, installa la versione richiesta di SAP Host Agent. Per istruzioni sull'installazione di SAP Host Agent, consulta la documentazione SAP.
Per i requisiti di versione per l'agente host SAP, consulta le seguenti note per SAP:
- Linux: nota SAP 2460297 - SAP su Linux su Google Cloud Platform: monitoraggio avanzato
- Windows: SAP Note 1409604 - Virtualizzazione su Windows: monitoraggio avanzato
Problema: 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 di pacchetti (yum
, zypper
o googet
).
Causa: l'installazione dell'agente non riesce perché il server host che esegue l'agente è stato creato senza un indirizzo IP pubblico o esterno.
Soluzione: per risolvere il problema, configura un gateway NAT che conceda al server host l'accesso a internet in uscita. Per informazioni su come configurare un gateway NAT, vedi 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: non è possibile avviare l'agente di Google Cloud per SAP 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.
Soluzione: per risolvere il problema, assicurati che la porta 18181
sia disponibile per l'agente Google Cloud per SAP. Se un altro servizio sta utilizzando la porta 18181
, potrebbe essere necessario riavviarlo o riconfigurarlo in modo che utilizzi un'altra porta.
Assistenza per l'Agente per SAP di Google Cloud
Se hai bisogno di aiuto per risolvere un problema con l'agente Google Cloud per SAP, raccogli le informazioni di diagnostica necessarie e contatta l'assistenza clienti Google Cloud. Per saperne di più, consulta le informazioni diagnostiche dell'Agente Google Cloud per SAP.