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

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

Logging

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

Per visualizzare i log per l'agente per SAP di Google Cloud, 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 l'errore di autorizzazioni IAM insufficienti.

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

Risoluzione: nella pagina dei dettagli dell'istanza VM della console Google Cloud, prendi nota del 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 obbligatori
Raccolta delle metriche dell'agente host SAP	Visualizzatore Compute (`roles/compute.viewer`) Visualizzatore Monitoring (`roles/monitoring.viewer`)
Raccolta delle metriche di monitoraggio dei processi	Visualizzatore Compute (`roles/compute.viewer`) Writer metriche Monitoring (`roles/monitoring.metricWriter`) Accessore ai secret di Secret Manager (`roles/secretmanager.secretAccessor`) (obbligatorio quando utilizzi Secret Manager per autenticare l'account utente del database per SAP HANA).
Raccolta di metriche di valutazione del Gestore carichi di lavoro	Visualizzatore Compute (`roles/compute.viewer`) Writer metriche Monitoring (`roles/monitoring.metricWriter`) Accessore ai secret di Secret Manager (`roles/secretmanager.secretAccessor`) (obbligatorio quando utilizzi Secret Manager per autenticare l'account utente del database per SAP HANA).
Raccolta delle metriche di monitoraggio SAP HANA	Visualizzatore Compute (`roles/compute.viewer`) Writer metriche Monitoring (`roles/monitoring.metricWriter`) Accessore ai secret di Secret Manager (`roles/secretmanager.secretAccessor`) (obbligatorio quando utilizzi Secret Manager per autenticare l'account utente del database per SAP HANA).

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 non corretti 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 all'API Cloud minimi sull'istanza VM host. Questo errore si verifica quando l'account di servizio non dispone degli ambiti di accesso richiesti.

Risoluzione: gli ambiti di accesso sono il metodo precedente per specificare le autorizzazioni per l'istanza VM. Compute Engine consiglia di configurare le istanze VM 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 VM per controllare l'accesso alle risorse Google Cloud.

Per risolvere il problema, come best practice, imposta l'intero ambito di accesso 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 dell'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 monitoraggio dei processi, delle metriche di valutazione di Workload Manager o delle metriche di monitoraggio di SAP HANA, anche gli ambiti di accesso dell'istanza VM host devono disporre 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 VM, apportare le modifiche, 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: Agente host SAP mancante o errato

Problema: i log dell'agente per SAP di Google Cloud mostrano un errore di SAP Host Agent mancante o non corretto.

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, nel sistema SAP deve essere installato l'agente host SAP e viene mantenuto il livello minimo di patch richiesto per l'agente host.

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

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

Linux: nota SAP 2460297 - SAP su Linux su Google Cloud Platform: 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 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 è in esecuzione l'agente è stato creato senza un indirizzo IP pubblico.

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

Problema: raccolta delle metriche di monitoraggio SAP HANA non riuscita

Problema: durante l'upgrade dall'agente di monitoraggio per SAP HANA, dopo aver installato l'agente di Google Cloud per SAP, viene visualizzato un messaggio di errore simile al seguente:

tls: failed to verify certificate: x509: certificate relies on legacy Common Name field, use SANs instead

Causa:l'agente di Google Cloud per SAP non può avviare la raccolta delle metriche di monitoraggio SAP HANA perché le istanze SAP HANA di destinazione utilizzano i certificati SSL specificati con Common Name (CN).

Soluzione:per risolvere il problema, completa la procedura seguente:

Per le istanze SAP HANA che vuoi monitorare utilizzando l'agente di Google Cloud per SAP, devi passare a un certificato SSL SAN (Subject Alternative Name) anziché a certificati SSL specificati con il nome comune (CN).
Stabilisci una connessione SSH con l'istanza VM host o il server Bare Metal Solution.
Apri il file di configurazione dell'agente per SAP di Google Cloud:
```
/etc/google-cloud-sap-agent/configuration.json
```
Nella sezione hana_monitoring_configuration, imposta il parametro enabled su true.
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 il nome host SAP HANA, come specificato nel certificato TLS/SSL, come valore.
3. Specifica il parametro tls_root_ca_file e imposta il percorso in cui è archiviato il certificato TLS/SSL.
Salva il file di configurazione.
Riavvia l'agente Google Cloud per SAP per applicare le nuove impostazioni:
```
sudo systemctl restart google-cloud-sap-agent
```
Verifica che l'agente stia raccogliendo le metriche di monitoraggio SAP HANA. Per istruzioni, consulta Visualizzare le altre metriche.
Disinstalla l'agente di monitoraggio per SAP HANA.

Problema: errore di connessione rifiutata

Problema:i log dell'agente host SAP mostrano l'errore di connessione rifiutata.

Causa:l'agente Google Cloud per SAP non può essere avviato perché la porta 18181 non è disponibile. L'agente di Google Cloud per SAP rimane in ascolto delle richieste sulla porta 18181. Questa porta deve essere disponibile per consentire l'avvio dell'agente.

Soluzione: 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 che utilizzi un'altra porta.

Problema: per le immagini sistema operativo SLES 15 SP4 per SAP e versioni successive, l'agente per SAP di Google Cloud non è in esecuzione

Problema: quando utilizzi le immagini sistema operativo SLES "for SAP", l'agente per SAP di Google Cloud è preinstallato. Tuttavia, per le immagini sistema operativo SLES 15 SP4 per SAP e versioni successive, l'Agente per SAP preinstallato non si avvia da solo.

Per verificare che l'agente sia in esecuzione o meno:

Connettiti all'istanza VM host o al server Bare Metal Solution.

Esegui questo comando:

systemctl status google-cloud-sap-agent

Se l'agente non è in esecuzione, l'output contiene inactive (dead). Ad esempio:

google-cloud-sap-agent.service - Google Cloud Agent for SAP
 Loaded: loaded (/usr/lib/systemd/system/google-cloud-sap-agent.service; disabled; vendor preset: disabled)
 Active: inactive (dead)

Causa: l'agente per SAP non si avvia da solo a causa di un problema con la pacchettizzazione del sistema operativo.

Soluzione: per risolvere il problema, svolgi i seguenti passaggi:

Connettiti all'istanza VM host o al server Bare Metal Solution.

Esegui questi comandi:

sudo sed -i 's~ /usr/sap~ -/usr/sap~g' /usr/lib/systemd/system/google-cloud-sap-agent.service
sudo systemctl restart google-cloud-sap-agent

Verifica che l'agente sia in esecuzione:

systemctl status google-cloud-sap-agent

Dovresti vedere un output simile al seguente:

google-cloud-sap-agent.service - Google Cloud Agent for SAP
  Loaded: loaded (/usr/lib/systemd/system/google-cloud-sap-agent.service; disabled; vendor preset: disabled)
  Active: active (running) since Wed 2023-07-12 03:07:23 UTC; 7s ago
Main PID: 6117 (google_cloud_sa)
   Tasks: 6
  Memory: 8.8M (max: 1.0G limit: 1.0G available: 1015.1M)
  CGroup: /system.slice/google-cloud-sap-agent.service
           └─ 6117 /usr/bin/google_cloud_sap_agent startdaemon

Ottenere assistenza per l'agente di Google Cloud per SAP

Se hai bisogno di aiuto per risolvere un problema con l'agente di Google Cloud per SAP, raccogli le informazioni di diagnostica richieste e contatta l'assistenza clienti Google Cloud. Per maggiori informazioni, consulta Versione 2: informazioni diagnostiche sull'agente Google Cloud per SAP.