Questa pagina è stata tradotta dall'API Cloud Translation.

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

L'agente di Google Cloud per SAP è necessario per il supporto SAP dei 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 una VM di Compute Engine per le metriche di SAP Host Agent, combina i dati di monitoraggio di Cloud Monitoring e le API di Compute Engine e fornisce questi dati al SAP Host Agent.

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

RHEL: tutto "per SAP" immagini
SLES: SLES 15 SP4 per SAP e versioni successive

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

Per installare e configurare la versione 2 di Agente Google Cloud per SAP su una Bare Metal Solution un server web, consulta Installa l'agente Google Cloud per SAP su un server Bare Metal Solution.

Panoramica dell'installazione

Su Linux, devi installare l'Agente di Google Cloud per SAP utilizzando sistemi operativi standard per la gestione dei pacchetti di sistema: su RHEL, il comando yum; su SLES, 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, installa l'agente di Google Cloud per SAP utilizzando il comando di gestione del pacchetto 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.

Avviso: non interrompere manualmente il servizio Windows o eliminare l'attività pianificata.

Prerequisiti per l'agente

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

Imposta i ruoli IAM richiesti

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

Per aggiungere un ruolo obbligatorio all'account di servizio:

Nella console Google Cloud, vai alla pagina IAM.

Vai a IAM
Selezionare il tuo progetto Google Cloud.
Identifica l'account di servizio a cui vuoi aggiungere un ruolo.
- Se l'account di servizio non è già presente nell'elenco delle entità, non sono stati assegnati ruoli. Fai clic su Aggiungi e inserisci all'indirizzo email dell'account di servizio.
- Se l'account di servizio è già nell'elenco delle entità, allora dispone di account ruoli. Fai clic sul pulsante Modifica per l'account di servizio che desideri modificare.
Seleziona il ruolo richiesto dall'elenco dei ruoli disponibili:
- Compute Engine > Visualizzatore Compute
- Monitoraggio > Visualizzatore monitoraggio
- Gestione dei carichi di lavoro > Writer insight gestore carichi di lavoro
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 di accedere agli ambiti di accesso a tutte le API Cloud utilizzando 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, allora l'agente di Google Cloud per SAP richiede i seguenti ambiti minimi di accesso alle API Cloud sull'istanza VM host:

Piattaforma cloud: Attivata
Compute Engine: sola lettura
API Stackdriver Monitoring: sola lettura

Se esegui applicazioni SAP su un'istanza VM che non dispone indirizzo IP esterno, dovrai abilitare l'accesso privato Google sulla subnet della VM in modo che l'agente Google Cloud per SAP possono 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 più funzionalità. Per istruzioni, vedi Installa e configura l'agente di Google Cloud per SAP su un'istanza VM di Compute Engine.

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

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

Convalida l'installazione dell'agente

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

Linux

Stabilisci una connessione SSH di un'istanza VM host.

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

Utilizza RDP per la connessione all'istanza VM.
Come amministratore, esegui il comando seguente da PowerShell:
```
$(Get-Service -Name 'google-cloud-sap-agent' -ErrorAction Ignore).Status
```
Se l'agente è in esecuzione, lo stato è Running.

Se l'agente non è in esecuzione, riavvialo.

Verificare che l'agente host SAP riceva 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:

Nel sistema SAP, inserisci la transazione ST06.
Nel riquadro di panoramica, controlla la disponibilità e i contenuti dei seguenti campi per la configurazione end-to-end corretta dell'infrastruttura di monitoraggio di SAP e Google:
- Fornitore di servizi cloud: Google Cloud Platform
- Accesso al monitoraggio avanzato: TRUE
- Dettagli sul monitoraggio avanzato: ACTIVE

Configurare l'agente di Google Cloud per SAP su Linux

Dopo aver installato l'agente di Google Cloud per SAP, facoltativamente puoi attivare altre funzionalità dell'agente eseguendo le seguenti configurazioni. Per impostazione predefinita, la raccolta dei soli dati Metriche dell'agente host SAP sia abilitato.

File di configurazione predefinito

Il seguente snippet è 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 illustra 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 dalla Agente host SAP, specifica `true`. Il valore predefinito è `true`. Non impostare `provide_sap_host_agent_metrics` su `false` a meno che non ti venga richiesto 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 ti venga 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 attivare il rilevamento del sistema SAP, specifica `true`. Il valore predefinito è `true`.
`cloud_properties.project_id`	`String` Se il sistema SAP è in esecuzione su un server Bare Metal Solution, specifica l'ID progetto del progetto Google Cloud che utilizzi 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 dell'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 del server.
`cloud_properties.region`	`String` Se il 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.
`cloud_properties.zone`	`String` Quando l'agente viene eseguito su un'istanza VM, per impostazione predefinita utilizza la zona dell'istanza VM su cui è installato l'agente.
`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.
`cloud_properties.numeric_project_id`	`String` Specifica l'ID numerico del progetto Google Cloud che il sistema SAP è in esecuzione. Quando l'agente viene eseguito su un'istanza VM, per impostazione predefinita rileva automaticamente un 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 attivi la raccolta delle metriche di processo per SAP HANA, devi configurare i parametri aggiuntivi elencati in `hana_metrics_config`.
`collection_configuration.process_metrics_frequency`	`Int` Dalla versione 2.6, questo parametro determina la frequenza di raccolta delle metriche di monitoraggio dei processi in rapida evoluzione, in secondi. Le metriche di monitoraggio dei processi in rapida evoluzione sono: `sap/hana/availability`, `sap/hana/ha/availability` e `sap/nw/availability`. Il valore predefinito per questo parametro è `5` secondi. Ti consigliamo di utilizzare questo valore predefinito. Tutte le altre metriche di monitoraggio dei processi (in lenta evoluzione) vengono raccolte con una frequenza predefinita di 30 secondi. Per modificare la frequenza di raccolta le metriche di Process Monitoring che cambiano lentamente, usa il parametro `slow_process_metrics_frequency`.
`collection_configuration.slow_process_metrics_frequency`	`Int` Specifica la frequenza di raccolta del metriche di Process Monitoring che cambiano lentamente, in pochi secondi. Il valore predefinito di questo parametro è `30` secondi.
`collection_configuration.process_metrics_to_skip`	`Array` Specifica Metriche di monitoraggio dei processi che non vuoi vengano raccolte dall'agente. Questo parametro accetta un parametro 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 la query 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 che l'agente utilizza per eseguire query su SAP HANA. Invece di specificare una password in testo normale, ti consigliamo di utilizzare una delle seguenti opzioni: `hana_db_password_secret_name`, per il quale specifichi archiviato in Secret Manager.
`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 che l'agente utilizza per eseguire query su SAP HANA, specifica il nome secret che contiene le credenziali di sicurezza per l'account utente del database. Importante: il secret e l'istanza VM host devono esistere nella lo stesso progetto Google Cloud. L'agente raccoglie le metriche relative a SAP HANA solo se specifichi `hana_db_password_secret_name` o `hana_db_password`.
`collection_configuration.hana_metrics_config.sid`	`String` Specifica il SID della tua istanza SAP HANA. Se utilizzi una chiave Userstore HANA, consulta la sezione hdbuserstore_key.
`collection_configuration.collect_workload_validation_metrics`	`Boolean` Per attivare la raccolta delle metriche di valutazione di Workload Manager, specifica `true`. Dalla versione 3.2, il valore predefinito è `true`. Questo parametro è applicabile solo a Linux.
`collection_configuration.workload_validation_metrics_frequency`	`Int` La frequenza di raccolta del Gestore carichi di lavoro le metriche di valutazione in pochi secondi. Il valore predefinito è `300` secondi. Ti consigliamo di non modificare la frequenza di raccolta predefinita, in quanto potrebbe influire sull'intera funzionalità. Se devi modificare la frequenza di raccolta delle metriche di Workload Manager, 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.
`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 la tua istanza SAP HANA. Di seguito sono riportati i valori supportati: Se l'host è un computer locale, specifica la stringa `localhost` o l'indirizzo IP loopback localhost, ad esempio `127.0.0.1`. Se l'host è una macchina remota, specifica il relativo indirizzo IP interno o esterno.
`collection_configuration.workload_validation_db_metrics_config.port`	`String` Specifica la porta su cui l'istanza SAP HANA accetta le query. Per la prima o l'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 del Gestore carichi di lavoro. Il valore predefinito è `3600` secondi. Sebbene tu possa 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 parammetro `workload_validation_db_metrics_frequency` nella sezione `collection_configuration` e fornisci il valore richiesto. Assicurati di non impostare una frequenza di raccolta maggiore di `3600` secondi.
`hana_monitoring_configuration.enabled`	`Boolean` Facoltativo. Consenti all'agente di Google Cloud per SAP di raccogliere i dati SAP HANA di monitoraggio delle metriche, 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 campione, in secondi, che determina la frequenza con cui l'agente Google Cloud per SAP esegue query su SAP HANA per raccogliere le metriche di monitoraggio SAP HANA. Il valore predefinito è di 300 secondi. Per ogni query definita nel file di configurazione con l'agente Google Cloud per SAP, puoi sovrascrivere l'intervallo globale di esempio specificando l'intervallo richiesto al parametro `sample_interval_sec`. Gli intervalli di campionamento devono essere di 5 secondi o più a lungo.
`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 al 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 l'SID dell'istanza SAP HANA. Questa stringa viene aggiunta come etichetta a tutte le metriche risultanti dalla query delle istanze SAP HANA.
`hana_monitoring_configuration.hana_instances.host`	`String` Specifica l'identificatore della macchina, locale o remota, che che ospita la tua istanza SAP HANA. Di seguito sono riportati i valori supportati: Se l'host è un computer locale, specifica la stringa `localhost` o l'indirizzo IP loopback localhost, ad esempio `127.0.0.1`. Se l'host è una macchina remota, specifica il relativo indirizzo IP interno o esterno.
`hana_monitoring_configuration.hana_instances.port`	`String` Specifica la porta su cui l'istanza SAP HANA accetta le query. Per la prima o l'unica istanza del database del 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. Assicurati che questo utente abbia il privilegio di leggere le visualizzazioni di monitoraggio nel database SAP HANA. Se questo privilegio non viene concesso, le metriche di monitoraggio di SAP HANA relative alle viste di monitoraggio non contengono dati.
`hana_monitoring_configuration.hana_instances.password`	`String` Facoltativo. Specifica la password, in 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 al parametro `secret_name`.
`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.enable_ssl`	`Boolean` Facoltativo. Specifica se SSL è attivo o meno nell'istanza SAP HANA. Il valore predefinito è `false`.
`hana_monitoring_configuration.hana_instances.host_name_in_certificate`	`String` Se specifichi `enable_ssl: true` per un SAP HANA istanza, devi specificare il nome host impostato nella certificato.
`hana_monitoring_configuration.hana_instances.tls_root_ca_file`	`String` Se specifichi `enable_ssl: true` per un SAP HANA devi specificare il percorso per la configurazione certificato.
`hana_monitoring_configuration.queries.enabled`	`Boolean` Facoltativo. Per attivare una query SQL per tutte le istanze SAP HANA, specifica il valore `true` per il parametro `enabled` per la query SQL.
`hana_monitoring_configuration.queries.name`	`String` Se nel file di configurazione hai definito query personalizzate, devi specificare un nome univoco per ogni query personalizzata. Il nome della query deve essere univoco perché viene utilizzato per creare il predefinito della metrica in Monitoring.
`hana_monitoring_configuration.queries.sql`	`String` Specifica l'istruzione SQL che l'agente invia a SAP HANA di Compute Engine. L'istruzione SQL deve essere conforme alla sintassi SQL definita da SAP nel SAP HANA SQL and System Views Reference.
`hana_monitoring_configuration.queries.sample_interval_sec`	`Int` Facoltativo. Specifica l'intervallo di campionamento per la query SQL. Questo sostituisce l'intervallo di campionamento globale. Il valore deve essere almeno di 5 secondi.
`hana_monitoring_configuration.queries.columns.name`	`String` Specifica un nome che identifichi in modo univoco ogni colonna. Il nome della colonna deve essere univoco perché viene utilizzato per creare l'URL predefinito della metrica in Monitoraggio.
`hana_monitoring_configuration.queries.columns.metric_type`	`String` Per la gestione tramite Monitoring, specifica una delle seguenti opzioni tipi di metriche: `METRIC_LABEL`, `METRIC_GAUGE` o `METRIC_CUMULATIVE`. Le metriche di tipo `METRIC_LABEL` vengono aggiunte come etichette a tutti i `METRIC_GAUGE` e i `METRIC_CUMULATIVE` vengono inviate a Monitoring.
`hana_monitoring_configuration.queries.columns.value_type`	`String` Per la gestione tramite Monitoring, specifica un tipo di dati che sia supportate dal tipo di metrica. I tipi di dati supportati sono: `VALUE_BOOL`, `VALUE_INT64`, `VALUE_STRING` o `VALUE_DOUBLE`. Per ulteriori informazioni, vedi Combinazione supportata.
`hana_monitoring_configuration.queries.columns.name_override`	`String` Facoltativo. Per la gestione tramite Monitoring, specifica 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 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 dell'agente di Google Cloud per SAP.

Assistenza

Se hai bisogno di aiuto per risolvere i problemi relativi all'agente per SAP di Google Cloud, raccogli tutte le informazioni di diagnostica disponibili e contatta l'assistenza clienti Google Cloud. Per informazioni su come contattare il servizio clienti, consulta Assistenza per SAP su Google Cloud.