Installa e configura l'agente di Google Cloud per SAP su un'istanza VM di Compute Engine

L'agente di Google Cloud per SAP è necessario per il supporto SAP di sistemi SAP in esecuzione su Google Cloud, tra cui SAP NetWeaver, SAP HANA, SAP ASE, SAP MaxDB e altri.

Quando installi Agent for SAP di Google Cloud su un'istanza VM di Compute Engine, per le metriche di SAP Host Agent, l'agente combina i dati di monitoraggio di Cloud Monitoring e delle API Compute Engine e fornisce questi dati al SAP Host Agent.

Se utilizzi le seguenti immagini di sistema operativo RHEL o SLES "for SAP" fornite da Google Cloud, l'agente di Google Cloud per SAP viene pacchettizzato con le immagini del sistema operativo:

  • RHEL: tutte le immagini "per SAP"
  • SLES: SLES 15 SP4 per SAP e versioni successive

Per informazioni sui sistemi operativi supportati dall'Agente di Google Cloud per SAP, consulta Sistemi operativi supportati.

Per installare e configurare la versione 2 dell'Agente per SAP di Google Cloud su un server Bare Metal Solution, consulta Installare l'Agent di Google Cloud per SAP su un server Bare Metal Solution.

Panoramica dell'installazione

Su Linux, puoi installare l'Agente per SAP di Google Cloud utilizzando i comandi standard per la gestione dei pacchetti del sistema operativo: su RHEL, il comando yum; su SLES, il comando zypper. Il comando di gestione dei pacchetti completa le seguenti attività:

  • Scarica l'agente di Google Cloud per SAP.
  • Crea l'agente come servizio systemd Linux, denominato google-cloud-sap-agent.
  • Abilita e avvia il servizio, google-cloud-sap-agent.

Su Windows, puoi installare l'agente di Google Cloud per SAP utilizzando il comando di gestione dei pacchetti GooGet, googet. Il comando di gestione dei pacchetti completa le seguenti attività:

  • Scarica l'agente di Google Cloud per SAP.
  • Crea un servizio Windows denominato google-cloud-sap-agent e un'attività pianificata che viene eseguita ogni minuto per verificare se il servizio è ancora in esecuzione e, se necessario, riavviarlo.

Prerequisiti per l'agente

Prima di installare l'agente di Google Cloud per SAP, devi assicurarti che siano soddisfatti i prerequisiti seguenti.

Imposta i ruoli IAM richiesti

Come minimo, l'account di servizio utilizzato dall'Agente di Google Cloud per SAP deve includere i ruoli Visualizzatore Compute (roles/compute.viewer), Visualizzatore Monitoring (roles/monitoring.viewer) e Workload Manager Insights Writer (roles/workloadmanager.insightWriter).

Per aggiungere un ruolo obbligatorio al tuo account di servizio, segui questi passaggi:

  1. Nella console Google Cloud, vai alla pagina IAM.

    Vai a IAM

  2. Selezionare il tuo progetto Google Cloud.

  3. Identifica l'account di servizio a cui vuoi aggiungere un ruolo.

    • Se l'account di servizio non è già nell'elenco delle entità, non gli sono stati assegnati ruoli. Fai clic su Aggiungi e inserisci l'indirizzo email dell'account di servizio.
    • Se l'account di servizio è già nell'elenco delle entità, ha i ruoli esistenti. Fai clic sul pulsante Modifica per l'account di servizio che vuoi modificare.
  4. Seleziona il ruolo richiesto dall'elenco di ruoli disponibili:

    • Compute Engine > Visualizzatore Compute
    • Monitoring > Visualizzatore Monitoring
    • Gestione carichi di lavoro > Writer insight gestore carichi di lavoro
  5. Fai clic su Aggiungi o Salva per applicare i ruoli all'account di servizio.

Abilita l'accesso alle API Google Cloud

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 dell'istanza per controllare l'accesso alle risorse Google Cloud. Per ulteriori informazioni, consulta Creare una VM che utilizza un account di servizio gestito dall'utente.

Se limiti l'accesso alle API Cloud, l'agente Google Cloud per SAP richiederà i seguenti ambiti minimi di accesso alle API Cloud sull'istanza VM host:

  • Cloud Platform: Abilitato
  • Compute Engine: sola lettura
  • API Stackdriver Monitoring: sola lettura

Se esegui applicazioni SAP su un'istanza VM che non ha un indirizzo IP esterno, devi abilitare l'accesso privato Google sulla subnet della VM in modo che l'agente Google Cloud per SAP possa accedere alle API e ai servizi Google. Per abilitare l'accesso privato Google su una subnet, consulta Configurazione dell'accesso privato Google.

Installa l'agente

Ti consigliamo di installare la versione più recente dell'agente di Google Cloud per SAP, che supporta altre funzionalità. Per le istruzioni, consulta Installare e configurare l'agente di Google Cloud per SAP su un'istanza VM di Compute Engine.

Per installare la versione 2 dell'agente Google Cloud per SAP, contatta l'assistenza clienti Google Cloud.

Dopo aver installato l'agente di Google Cloud per SAP e l'agente host SAP, convalida l'installazione dell'agente di Google Cloud per SAP, come descritto in Convalidare l'installazione dell'agente.

Convalida l'installazione dell'agente

Per verificare che l'agente sia in esecuzione, seleziona il tuo sistema operativo, quindi segui questi passaggi:

Linux

  1. Stabilisci una connessione SSH con la tua istanza VM host.

  2. Esegui questo comando:

    systemctl status google-cloud-sap-agent

    Se l'agente funziona correttamente, l'output contiene active (running). Ad esempio:

    google-cloud-sap-agent.service - Google Cloud Agent for SAP
    Loaded: loaded (/usr/lib/systemd/system/google-cloud-sap-agent.service; enabled; vendor preset: disabled)
    Active:  active (running)  since Fri 2022-12-02 07:21:42 UTC; 4 days ago
    Main PID: 1337673 (google-cloud-sa)
    Tasks: 9 (limit: 100427)
    Memory: 22.4 M (max: 1.0G limit: 1.0G)
    CGroup: /system.slice/google-cloud-sap-agent.service
           └─1337673 /usr/bin/google-cloud-sap-agent
    

Windows

  1. Utilizza RDP per la connessione all'istanza VM.

  2. In qualità di amministratore, esegui questo comando da PowerShell:

    $(Get-Service -Name 'google-cloud-sap-agent' -ErrorAction Ignore).Status
    Se l'agente è in esecuzione, lo stato mostra Running.

Se l'agente non è in esecuzione, riavvialo.

Verifica che l'agente host SAP stia ricevendo le metriche

Per verificare che le metriche dell'infrastruttura vengano raccolte dall'agente di Google Cloud per SAP e inviate correttamente all'agente host SAP, segui questi passaggi:

  1. Nel sistema SAP, inserisci la transazione ST06.
  2. Nel riquadro Panoramica, verifica la disponibilità e il contenuto dei seguenti campi per la corretta configurazione end-to-end dell'infrastruttura di monitoraggio SAP e Google:

    • Provider cloud: Google Cloud Platform
    • Accesso a monitoraggio avanzato: TRUE
    • Dettagli sul monitoraggio avanzato: ACTIVE

Configura l'agente Google Cloud per SAP su Linux

Dopo aver installato l'agente per SAP di Google Cloud, facoltativamente, puoi abilitare altre funzionalità dell'agente eseguendo le seguenti configurazioni. Per impostazione predefinita, è abilitata la raccolta solo delle metriche dell'agente host SAP.

File di configurazione predefinito

Lo snippet seguente è un esempio della configurazione predefinita della versione 2 dell'agente di Google Cloud per SAP:

{
  "provide_sap_host_agent_metrics": true,
  "bare_metal": ,
  "log_level": "INFO",
  "log_to_cloud": true,
  "collection_configuration": {
    "collect_workload_validation_metrics": false,
    "collect_process_metrics": false,
    "sap_system_discovery": true
  },
  "hana_monitoring_configuration": {
    "enabled": false
  }
}

Parametri di configurazione

La tabella seguente spiega i parametri di configurazione della versione 2 dell'agente di Google Cloud per SAP.

Parametri
provide_sap_host_agent_metrics

Boolean

Per abilitare la raccolta delle metriche richieste da SAP Host Agent, specifica true. Il valore predefinito è true.
Non impostare provide_sap_host_agent_metrics su false a meno che non sia indicato dall'assistenza clienti Google Cloud o dall'assistenza SAP.

bare_metal

Boolean

Quando l'agente è installato su un server Bare Metal Solution, specifica true. Il valore predefinito è false.

log_level

String

Per impostare il livello di logging dell'agente, imposta il valore richiesto. I livelli di log disponibili sono i seguenti:

  • DEBUG
  • INFO
  • WARNING
  • ERROR

Il valore predefinito è INFO. Non modificare il livello di logging a meno che non sia indicato dall'assistenza clienti Google Cloud.

log_to_cloud

Boolean

Per reindirizzare i log dell'agente a Cloud Logging, specifica true. Il valore predefinito è true.

sap_system_discovery

Boolean

Per abilitare il rilevamento del sistema SAP, specifica true. Il valore predefinito è true.

cloud_properties.project_id

String

Se il tuo sistema SAP è in esecuzione su un server Bare Metal Solution, specifica l'ID del progetto Google Cloud che stai utilizzando con Bare Metal Solution.

Quando l'agente viene eseguito su un'istanza VM, per impostazione predefinita, rileva automaticamente l'ID progetto.

cloud_properties.instance_name

String

Se il sistema SAP è in esecuzione su un'istanza VM di Compute Engine, specifica il nome di questa istanza VM. L'agente rileva automaticamente il nome dell'istanza VM al momento dell'installazione.

Se il sistema SAP è in esecuzione su un server Bare Metal Solution, specifica il nome di quel server.

cloud_properties.region

String

Se il tuo sistema SAP è in esecuzione su un server Bare Metal Solution, specifica la regione del server Bare Metal Solution.

Quando l'agente viene eseguito su un'istanza VM, per impostazione predefinita utilizza la regione dell'istanza VM su cui è installato l'agente.

cloud_properties.zone

String

Per impostazione predefinita, quando l'agente viene eseguito su un'istanza VM utilizza la zona dell'istanza VM in cui è installato.

cloud_properties.image

String

Specifica il nome dell'immagine del sistema operativo dell'istanza.

Quando l'agente viene eseguito su un'istanza VM, per impostazione predefinita rileva l'immagine del sistema operativo dell'istanza VM su cui è installato l'agente.

cloud_properties.numeric_project_id

String

Specifica l'ID numerico del progetto Google Cloud in cui è in esecuzione il sistema SAP.

Quando l'agente viene eseguito su un'istanza VM, per impostazione predefinita, rileva automaticamente l'ID progetto numerico.

collection_configuration.collect_process_metrics

Boolean

Per abilitare la raccolta delle metriche di Process Monitoring, specifica true. Il valore predefinito è false.
Questo parametro è applicabile solo per Linux.

Se abiliti la raccolta delle metriche di processo per SAP HANA, devi configurare parametri aggiuntivi elencati in hana_metrics_config.

collection_configuration.process_metrics_frequency

Int

A partire dalla versione 2.6, questo parametro determina la frequenza di raccolta in secondi delle metriche di Process Monitoring in rapida evoluzione. Le metriche di monitoraggio dei processi in rapida evoluzione sono: sap/hana/availability, sap/hana/ha/availability e sap/nw/availability.

Il valore predefinito di questo parametro è 5 secondi. Ti consigliamo di utilizzare questo valore predefinito.

Tutte le altre metriche di Process Monitoring (in lento cambiamento) vengono raccolte con una frequenza predefinita di 30 secondi. Per modificare la frequenza di raccolta delle metriche di Process Monitoring che cambiano lentamente, utilizza il parametro slow_process_metrics_frequency.

collection_configuration.slow_process_metrics_frequency

Int

Specifica la frequenza di raccolta delle metriche di Process Monitoring che cambiano lentamente, in secondi.

Il valore predefinito di questo parametro è 30 secondi.

collection_configuration.process_metrics_to_skip

Array

Specifica le metriche di monitoraggio dei processi che non vuoi che l'agente raccolga. Questo parametro accetta un valore separato da virgole dei nomi delle metriche di Process Monitoring. Ad esempio: "process_metrics_to_skip": ["/sap/nw/abap/sessions", "/sap/nw/abap/rfc"].

collection_configuration.hana_metrics_config.hana_db_user

String

Specifica l'account utente del database che l'agente utilizza per eseguire query su SAP HANA. Il valore predefinito è SYSTEM.

collection_configuration.hana_metrics_config.hana_db_password

String

Specifica la password in testo normale per l'account utente del database che l'agente utilizza per eseguire query su SAP HANA.

Anziché specificare una password in testo normale, ti consigliamo di utilizzare una delle seguenti opzioni:

collection_configuration.hana_metrics_config.hana_db_password_secret_name

String

Per fornire in modo sicuro la password per l'account utente del database che l'agente utilizza per eseguire query su SAP HANA, specifica il nome del secret che contiene le credenziali di sicurezza per l'account utente del database.

L'agente raccoglie le metriche correlate a SAP HANA solo se specifichi hana_db_password_secret_name, hdbuserstore_key o hana_db_password.

collection_configuration.hana_metrics_config.hdbuserstore_key

String

Per autenticare l'utente SAP HANA specificato per hana_db_user, specifica una chiave hdbuserstore che hai creato per l'utente.

Per utilizzare una chiave hdbuserstore per l'autenticazione, assicurati di soddisfare le seguenti condizioni:

  • Gli strumenti SAP hdbsql e hdduserstore sono installati sull'istanza di computing che ospita l'agente.
  • La chiave hdbuserstore corrisponde a un'istanza SAP HANA specifica. Non puoi utilizzare chiavi che contengono nomi host di più istanze SAP HANA.
collection_configuration.hana_metrics_config.sid

String

Specifica il SID della tua istanza SAP HANA.

collection_configuration.collect_workload_validation_metrics

Boolean

Per abilitare la raccolta delle metriche di valutazione del Gestore carichi di lavoro, specifica true. Dalla versione 3.2, il valore predefinito è true.
Questo parametro è applicabile solo per Linux.

collection_configuration.workload_validation_metrics_frequency

Int

La frequenza di raccolta delle metriche di valutazione del Gestore carichi di lavoro in secondi. Il valore predefinito è 300 secondi.

Se devi modificare la frequenza di raccolta delle metriche di Gestore carichi di lavoro, aggiungi il parametro workload_validation_metrics_frequency nella sezione collection_configuration e fornisci il valore richiesto.

collection_configuration.workload_validation_db_metrics_config.hana_db_user

String

Specifica l'account utente utilizzato per eseguire query sull'istanza SAP HANA. L'account utente deve disporre dell'autorizzazione di lettura per il database SAP HANA.

collection_configuration.workload_validation_db_metrics_config.hana_db_password_secret_name

String

Specifica il nome del secret in Secret Manager in cui è archiviata la password dell'account utente.

In alternativa, puoi specificare il parametro di configurazione hdbuserstore_key per autenticare l'utente SAP HANA specificato.

collection_configuration.workload_validation_db_metrics_config.hdbuserstore_key

String

Per autenticare l'utente SAP HANA specificato per hana_db_user, specifica una chiave hdbuserstore che hai creato per l'utente.

Per utilizzare una chiave hdbuserstore per l'autenticazione, assicurati di soddisfare le seguenti condizioni:

  • Gli strumenti SAP hdbsql e hdduserstore sono installati sull'istanza di computing che ospita l'agente.
  • La chiave hdbuserstore corrisponde a un'istanza SAP HANA specifica. Non puoi utilizzare chiavi che contengono nomi host di più istanze SAP HANA.

Se specifichi hdbuserstore_key, puoi saltare la specifica dei parametri hostname e port.

collection_configuration.workload_validation_db_metrics_config.sid

String

Specifica il SID della tua istanza SAP HANA.

collection_configuration.workload_validation_db_metrics_config.hostname

String

Specifica l'identificatore della macchina, locale o remota, che ospita l'istanza SAP HANA. Di seguito sono riportati i valori supportati:

  • Se l'host è una macchina locale, specifica la stringa localhost o l'indirizzo IP di loopback localhost, ad esempio 127.0.0.1.
  • Se l'host è una macchina remota, specifica il suo indirizzo IP interno o esterno.
collection_configuration.workload_validation_db_metrics_config.port

String

Specifica la porta su cui la tua istanza SAP HANA accetta le query. Per la prima o unica istanza di database tenant, la porta è 3NN15, dove NN è il numero di istanza dell'istanza SAP HANA.

collection_configuration.workload_validation_db_metrics_frequency

Int

La frequenza di raccolta delle metriche del database SAP HANA, in secondi, per la valutazione di Workload Manager. Il valore predefinito è 3600 secondi.

Anche se puoi aggiornare la frequenza di raccolta delle metriche del database SAP HANA, ti consigliamo di utilizzare il valore predefinito. Se devi modificare il valore predefinito, aggiungi il parametro workload_validation_db_metrics_frequency nella sezione collection_configuration e fornisci il valore richiesto. Assicurati di non impostare una frequenza di raccolta superiore a 3600 secondi.

hana_monitoring_configuration.enabled

Boolean

Facoltativo. Per consentire all'agente di Google Cloud per SAP di raccogliere le metriche di monitoraggio SAP HANA, specifica true. Il valore predefinito è false.

I seguenti parametri secondari sono applicabili solo quando specifichi hana_monitoring_configuration.enabled: true.
hana_monitoring_configuration.sample_interval_sec

Int

Facoltativo. Specifica l'intervallo di esempio, in secondi, che determina la frequenza con cui l'Agente per SAP di Google Cloud esegue query sulle tue istanze SAP HANA per raccogliere le metriche di monitoraggio SAP HANA. Il valore predefinito è 300 secondi.

Per ogni query definita nel file di configurazione dell'agente per SAP di Google Cloud, puoi sovrascrivere l'intervallo di campionamento globale specificando l'intervallo richiesto per il parametro sample_interval_sec. Gli intervalli di campionamento devono essere di almeno 5 secondi.

hana_monitoring_configuration.query_timeout_sec

Int

Facoltativo. Specifica il timeout per ogni query effettuata sulle istanze SAP HANA. Il valore predefinito è 300 secondi.

hana_monitoring_configuration.execution_threads

Int

Facoltativo. Specifica il numero di thread utilizzati per inviare query alle istanze SAP HANA. Ogni query viene eseguita sul proprio thread. Il valore predefinito è 10.

hana_monitoring_configuration.hana_instances.name

String

Specifica l'identificatore del nome per la tua istanza SAP HANA.

hana_monitoring_configuration.hana_instances.sid

String

Specifica il SID della tua istanza SAP HANA. Questa stringa viene aggiunta come etichetta a tutte le metriche risultanti dalle query sulle tue istanze SAP HANA.

hana_monitoring_configuration.hana_instances.host

String

Specifica l'identificatore della macchina, locale o remota, che ospita l'istanza SAP HANA. Di seguito sono riportati i valori supportati:

  • Se l'host è una macchina locale, specifica la stringa localhost o l'indirizzo IP di loopback localhost, ad esempio 127.0.0.1.
  • Se l'host è una macchina remota, specifica il suo indirizzo IP interno o esterno.
hana_monitoring_configuration.hana_instances.port

String

Specifica la porta su cui la tua istanza SAP HANA accetta le query. Per la prima o unica istanza di database tenant, la porta è 3NN15, dove NN è il numero di istanza dell'istanza SAP HANA.

hana_monitoring_configuration.hana_instances.user

String

Specifica l'account utente utilizzato per eseguire query sull'istanza SAP HANA.

hana_monitoring_configuration.hana_instances.password

String

Facoltativo. Specifica la password, come testo normale, che autentica l'account utente per eseguire query sull'istanza SAP HANA.

Per l'autenticazione, devi specificare una delle seguenti opzioni:

  • La password in testo normale per il parametro password.
  • (Consigliato) Se utilizzi Secret Manager per archiviare la password come secret, devi specificare il nome del secret corrispondente per il parametro secret_name.
  • (Consigliato) Una chiave hdbuserstore per il parametro hdbuserstore_key.
hana_monitoring_configuration.hana_instances.secret_name

String

Facoltativo. Specifica il nome del secret in Secret Manager in cui è archiviata la password dell'account utente.

hana_monitoring_configuration.hana_instances.hdbuserstore_key

String

Per autenticare l'utente SAP HANA specificato per user, specifica una chiave hdbuserstore che hai creato per l'utente.

Per utilizzare una chiave hdbuserstore per l'autenticazione, assicurati di soddisfare le seguenti condizioni:

  • Gli strumenti SAP hdbsql e hdduserstore sono installati sull'istanza di computing che ospita l'agente.
  • La chiave hdbuserstore corrisponde a un'istanza SAP HANA specifica. Non puoi utilizzare chiavi che contengono nomi host di più istanze SAP HANA.

Se specifichi hdbuserstore_key, puoi saltare i parametri host e port.

hana_monitoring_configuration.hana_instances.enable_ssl

Boolean

Facoltativo. Specifica se SSL è abilitato o meno nella tua istanza SAP HANA. Il valore predefinito è false.

hana_monitoring_configuration.hana_instances.host_name_in_certificate

String

Se specifichi enable_ssl: true per un'istanza SAP HANA, devi specificare il nome host impostato nel certificato SSL.

hana_monitoring_configuration.hana_instances.tls_root_ca_file

String

Se specifichi enable_ssl: true per un'istanza SAP HANA, devi specificare il percorso del certificato di sicurezza.

hana_monitoring_configuration.queries.enabled

Boolean

Facoltativo. Per abilitare una query SQL per tutte le tue istanze SAP HANA, specifica il valore true per il parametro enabled per la query SQL.

hana_monitoring_configuration.queries.name

String

Se hai definito query personalizzate nel file di configurazione, devi specificare un nome univoco per ciascuna.

Il nome della query deve essere univoco perché viene utilizzato per creare l'URL predefinito della metrica in Monitoring.

hana_monitoring_configuration.queries.sql

String

Specifica l'istruzione SQL che l'agente emette alle tue istanze SAP HANA.

L'istruzione SQL deve essere conforme alla sintassi SQL definita da SAP in SAP HANA SQL e System views (Riferimento sulle visualizzazioni di sistema e SAP HANA).
hana_monitoring_configuration.queries.sample_interval_sec

Int

Facoltativo. Specifica l'intervallo di esempio per la query SQL. Questa operazione sostituisce l'intervallo di campionamento globale. Il valore deve essere di almeno 5 secondi.

hana_monitoring_configuration.queries.columns.name

String

Specifica un nome che identifichi in modo univoco ogni colonna.

Il nome colonna deve essere univoco perché viene utilizzato per creare l'URL predefinito della metrica in Monitoring.

hana_monitoring_configuration.queries.columns.metric_type

String

Per la gestione tramite Monitoring, specifica uno dei seguenti tipi di metriche: METRIC_LABEL, METRIC_GAUGE o METRIC_CUMULATIVE.

Le metriche di tipo METRIC_LABEL vengono aggiunte come etichette a tutte le metriche METRIC_GAUGE e METRIC_CUMULATIVE inviate a Monitoring.

hana_monitoring_configuration.queries.columns.value_type

String

Per la gestione da parte di Monitoring, specifica un tipo di dati supportato dal tipo di metrica.

I tipi di dati supportati sono i seguenti: VALUE_BOOL, VALUE_INT64, VALUE_STRING o VALUE_DOUBLE. Per maggiori informazioni, consulta la pagina Combinazione supportata.

hana_monitoring_configuration.queries.columns.name_override

String

Facoltativo. Per la gestione da parte di Monitoring, specifica il percorso che vuoi mostrare nell'URL della metrica anziché i nomi delle query e delle colonne. Ad esempio:

  • URL predefinito della metrica: workload.googleapis.com/sap/hanamonitoring/QUERY_NAME/COLUMN_NAME
  • URL della metrica che utilizza il percorso personalizzato: workload.googleapis.com/sap/hanamonitoring/CUSTOM_PATH

Risoluzione dei problemi

Per informazioni su come diagnosticare e risolvere i problemi che potresti riscontrare durante l'installazione e la configurazione dell'agente di Google Cloud per SAP, consulta la guida alla risoluzione dei problemi di Agent for SAP di Google Cloud.

Richiedi assistenza

Se hai bisogno di aiuto per risolvere i problemi con l'agente di Google Cloud per SAP, raccogli tutte le informazioni diagnostiche disponibili e contatta l'assistenza clienti Google Cloud. Per informazioni su come contattare l'assistenza clienti, vedi Ottenere assistenza per SAP su Google Cloud.