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

Questa guida mostra come risolvere i problemi relativi a: versione 2 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 IAM insufficiente errore relativo alle autorizzazioni.

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

Soluzione:nella pagina dei dettagli dell'istanza VM della console Google Cloud, tieni presente dell'account di servizio della VM. Ad esempio: sap-example@example-project-123456.iam.gserviceaccount.com. Nella piattaforma IAM e Home page 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
Raccolta delle metriche di monitoraggio SAP HANA

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

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

Problema: Ambiti di accesso errati per l'account di servizio VM

Problema: se limiti gli ambiti di accesso sulla tua istanza VM 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 VM 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 un'istanza VM. Compute Engine consiglia di configurare le istanze VM per consentire di accedere agli ambiti di accesso a tutte le API Cloud utilizzando solo le autorizzazioni IAM dell'account di servizio VM per controllare l'accesso alle risorse Google Cloud.

Per risolvere il problema, imposta l'accesso a tutti i cloud-platform come best practice sull'istanza VM, quindi limita in modo sicuro l'accesso all'API dell'account di servizio 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 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 abilitato la raccolta delle metriche di Process Monitoring, le metriche di valutazione del Gestore carichi di lavoro o le metriche di monitoraggio SAP HANA anche gli ambiti di accesso dell'istanza VM host devono avere 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, quindi le modifiche, quindi riavvia l'istanza VM. Per istruzioni, vedi Documentazione di Compute Engine. Non è necessario apportare modifiche alle autorizzazioni per i ruoli IAM per questo problema.

Problema: SAP Host Agent mancante o errato

Problema: i log dell'agente Google Cloud per SAP mostrano che l'host SAP risulta mancante o errato Errore dell'agente.

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 di SAP Host Agent. Per istruzioni sull'installazione dell'agente host SAP, consulta documentazione SAP.

Per i requisiti di versione per l'agente host SAP, vedi quanto segue SAP Note

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

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

Causa: l'installazione dell'agente non riesce perché l'host il server che esegue l'agente è stato creato senza un indirizzo IP pubblico.

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:

Problema: raccolta delle metriche di monitoraggio SAP HANA non riuscita

Problema: durante l'upgrade dall'agente di monitoraggio per SAP HANA, dopo installare l'agente di Google Cloud per SAP, viene visualizzato un messaggio di errore simile seguenti:

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 di SAP HANA monitorare le metriche perché le istanze SAP HANA di destinazione utilizzano i certificati SSL specificati con il nome comune (CN).

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

  1. Per le istanze SAP HANA che vuoi monitorare utilizzando di Google Cloud per SAP, devi passare all'utilizzo di un nome alternativo del soggetto (SAN) anziché i certificati SSL specificati con Nome comune (CN).

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

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

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

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

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

  6. Salva il file di configurazione.

  7. Riavvia l'agente Google Cloud per SAP per applicare le nuove impostazioni:

    sudo systemctl restart google-cloud-sap-agent

  8. Verifica che l'agente stia raccogliendo le metriche di monitoraggio di SAP HANA. Per istruzioni, consulta Visualizzare le altre metriche.

  9. Disinstalla l'agente Monitoring per SAP HANA.

Problema: errore di connessione rifiutata

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

Causa: non è possibile avviare l'agente 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 dell'agente Google Cloud per SAP. Se un altro servizio utilizza la porta 18181, potrebbe essere necessario riavviare l'altro servizio o riconfigurarlo per utilizzare in un'altra porta.

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

Problema: quando si utilizza lo strumento SLES "for SAP" immagini sistema operativo, L'Agente per SAP di Google Cloud è preinstallato. Ma per le immagini del sistema operativo SLES 15 SP4 for SAP e successivi, l'agente preinstallato per SAP non inizia da solo.

Per verificare che l'agente sia in esecuzione o meno, segui questi passaggi:

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

  2. 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 automaticamente a causa di un problema con la pacchettizzazione del sistema operativo.

Risoluzione: Per risolvere il problema:

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

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

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

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 ulteriori informazioni, vedi Versione 2: informazioni diagnostiche dell'agente Google Cloud per SAP.