Installa e configura l'agente per SAP di Google Cloud su un server Bare Metal Solution

Nota:se utilizzi un'istanza Compute Engine X4, per informazioni su come installare l'agente sull'istanza, vedi Installare l'agente di Google Cloudper SAP su un'istanza Compute Engine.

L'agente per SAP diGoogle Cloudè necessario per il supporto SAP dei sistemi SAP in esecuzione su un server Bare Metal Solution.

Se utilizzi le seguenti immagini del sistema operativo RHEL o SLES "per SAP" fornite da Google Cloud, l'agente per SAP di Google Cloudè incluso nei pacchetti delle immagini del sistema operativo:

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

Per informazioni sui sistemi operativi disponibili per l'esecuzione di SAP sui server Bare Metal Solution, consulta quanto segue:

• Per SAP HANA, consulta Sistemi operativi certificati.
• Per SAP NetWeaver, vedi Sistemi operativi certificati.

Panoramica dell'installazione

Installa l'agente Google Cloudper SAP utilizzando i comandi standard di 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 per SAP di Google Cloud.
• Crea l'agente come servizio Linux systemd, denominato google-cloud-sap-agent.
• Attiva e avvia il servizio google-cloud-sap-agent.

Installa l'agente

Ti consigliamo di installare l'ultima versione dell'agente di Google Cloudper SAP, che supporta più funzionalità. Per istruzioni, vedi Installa e configura l'agente per SAP di Google Cloudsu un server Bare Metal Solution.

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

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

Convalida l'installazione dell'agente

1. Stabilisci una connessione SSH con il tuo server Bare Metal Solution.

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
   

Se l'agente non è in esecuzione, riavvialo.

Verifica che SAP Host Agent riceva le metriche

Per verificare che le metriche dell'infrastruttura vengano raccolte dall'agente per SAP diGoogle Cloude inviate correttamente all'agente host SAP, segui questi passaggi:

1. Nel sistema SAP, inserisci la transazione ST06.

2. Nel riquadro Panoramica, controlla la disponibilità e i contenuti dei seguenti campi per la corretta configurazione end-to-end dell'infrastruttura di monitoraggio SAP e Google:

   • Cloud Provider: Google Cloud Platform
   • Accesso al monitoraggio avanzato: TRUE
   • Dettagli di monitoraggio avanzati: ACTIVE

Configura l'agente per SAP di Google Cloudsu Linux

Dopo aver installato l'agente per SAP di Google Cloud, puoi configurare facoltativamente l'agente per raccogliere le metriche di monitoraggio dei processi, le metriche di valutazione di Workload Manager e le metriche di monitoraggio di SAP HANA. Per impostazione predefinita, è abilitata la raccolta solo delle metriche dell'agente host SAP.

Nota :la raccolta delle metriche di monitoraggio dei processi, delle metriche di valutazione di Workload Manager e delle metriche di monitoraggio di SAP HANA è supportata solo su Linux.

Prerequisiti

Per abilitare queste funzionalità per l'istanza dell'agente in esecuzione sul server Bare Metal Solution, devi completare i seguenti prerequisiti:

• Crea un account di servizio IAM per consentire all'agente di accedere alle risorseGoogle Cloud , quindi concedi i ruoli IAM richiesti aaccount di serviziont. Per maggiori dettagli, vedi Configurare un service account.
• Sul server Bare Metal Solution, installa gcloud CLI. Per informazioni dettagliate, vedi Installa gcloud CLI.
• Per accedere a Google Cloud, autorizza gcloud CLI. Per maggiori dettagli, vedi Autorizzare gcloud CLI.
• Stabilisci la connessione alle API. Google Cloud Per maggiori dettagli, consulta Configurazione dell'accesso privato Google per gli host on-premise.

Configura un service account

Per consentire all'agente di accedere alle risorse Google Cloud da un ambiente Bare Metal Solution, devi configurare un account di servizio IAM.

Come minimo, l'account di servizio utilizzato dall'agente deve includere il ruolo Writer metriche Monitoring (roles/monitoring.metricWriter).

Per creare un service account:

1. Create a service account:

   1. In the Google Cloud console, go to the Create service account page.

      Go to Create service account
   2. Select your project.

   3. In the Service account name field, enter a name. The Google Cloud console fills in the Service account ID field based on this name.

      In the Service account description field, enter a description. For example, Service account for quickstart.

   4. Click Create and continue.

   5. Grant the Monitoring > Monitoring Metric Writer role to the service account.

      To grant the role, find the Select a role list, then select Monitoring > Monitoring Metric Writer.

      Note: The Role field affects which resources the service account can access in your project. You can revoke these roles or grant additional roles later.
   6. Click Continue.

   7. Click Done to finish creating the service account.

      Do not close your browser window. You will use it in the next step.

2. Create a service account key:

   1. In the Google Cloud console, click the email address for the service account that you created.
   2. Click Keys.
   3. Click Add key, and then click Create new key.
   4. Click Create. A JSON key file is downloaded to your computer.
   5. Click Close.

Dopo aver creato il account di servizio, assicurati di caricare il file della chiave JSON in una posizione sicura sul server Bare Metal Solution accessibile all'agente.

Abilita le funzionalità

Dopo aver configurato un account di servizio per Bare Metal Solution e avergli concesso i ruoli richiesti, puoi attivare altre funzionalità dell'agente per SAP di Google Cloudeseguendo le seguenti configurazioni:

• Configurare la raccolta delle metriche di monitoraggio dei processi
• Configurare la raccolta delle metriche di valutazione del Gestore carichi di lavoro
• Configura la raccolta delle metriche di monitoraggio SAP HANA.

File di configurazione predefinito

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

{
  "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 per SAP di Google Cloud.

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 ti venga indicato dall'assistenza clienti Google Cloud o dal supporto 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 richiesto 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 progetto del progetto Google Cloud che utilizzi con Bare Metal Solution. Quando l'agente viene eseguito su un'istanza Compute Engine, per impostazione predefinita, rileva automaticamente l'ID progetto.
cloud_properties.instance_name	String Specifica il nome del server Bare Metal Solution su cui hai installato l'agente. Nell'agente versione 2.5 o precedente, specifica il nome del server Bare Metal Solution per la proprietà instance_id.
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 di calcolo, per impostazione predefinita, utilizza la regione in cui è implementata l'istanza di calcolo.
cloud_properties.zone	String Quando l'agente viene eseguito su un'istanza di calcolo, per impostazione predefinita utilizza la zona in cui è implementata l'istanza di calcolo.
cloud_properties.image	String Specifica il nome dell'immagine del sistema operativo dell'istanza. Quando l'agente viene eseguito su un'istanza di computing, per impostazione predefinita rileva automaticamente l'immagine del sistema operativo utilizzata dall'istanza di computing.
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 di computing, per impostazione predefinita l'agente rileva automaticamente il numero di progetto.
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 a 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 delle metriche di monitoraggio dei processi a variazione rapida, in secondi. Le metriche di monitoraggio dei processi che cambiano rapidamente 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 monitoraggio dei processi (a variazione lenta) vengono raccolte a una frequenza predefinita di 30 secondi. Per modificare la frequenza di raccolta delle metriche di monitoraggio dei processi a variazione lenta, utilizza il parametro slow_process_metrics_frequency.
collection_configuration.slow_process_metrics_frequency	Int Specifica la frequenza di raccolta delle metriche di monitoraggio dei processi a variazione lenta, 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 monitoraggio dei processi. 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 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 di testo normale, ti consigliamo di utilizzare una delle seguenti opzioni: hana_db_password_secret_name, per cui specifichi un secret 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 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. Importante:il secret e l'istanza Compute Engine host devono esistere nello stesso progetto Google Cloud . L'agente raccoglie le metriche correlate a SAP HANA solo quando specifichi hana_db_password_secret_name o hana_db_password.
collection_configuration.hana_metrics_config.sid	String Specifica l'SID dell'istanza SAP HANA.
collection_configuration.collect_workload_validation_metrics	Boolean Per abilitare la raccolta delle metriche di valutazione di Workload Manager, specifica true. A partire 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 delle metriche di valutazione del Gestore workload in 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	String Specifica la password per l'account utente utilizzato per eseguire query sull'istanza SAP HANA.
collection_configuration.workload_validation_db_metrics_config.hana_db_password_secret_name	String Specifica il nome del secret in Secret Manager che memorizza la password dell'account utente.
collection_configuration.workload_validation_db_metrics_config.sid	String Specifica l'SID dell'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 è un computer 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 l'istanza SAP HANA accetta le query. Per la prima o l'unica istanza del 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. Sebbene sia possibile 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 per SAP di Google Cloudraccogliere 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 campionamento, in secondi, che determina la frequenza con cui l'agente per SAP di Google Cloudesegue query sulle 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 eseguita 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 l'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 dall'interrogazione delle 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 è un computer 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 l'istanza SAP HANA accetta le query. Per la prima o l'unica istanza del 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. Assicurati che questo utente disponga del privilegio di leggere le viste di monitoraggio nel tuo database SAP HANA. Se questo privilegio non viene concesso, le metriche di monitoraggio SAP HANA correlate alle viste di monitoraggio non contengono dati.
hana_monitoring_configuration.hana_instances.password	String Facoltativo. Specifica la password, come testo normale, che autentica l'account utente per l'interrogazione dell'istanza SAP HANA. Per l'autenticazione, devi specificare uno dei seguenti elementi: 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 che memorizza 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'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 attivare una query SQL per tutte le istanze SAP HANA, specifica il valore true per il parametro enabled per quella query SQL.
hana_monitoring_configuration.queries.name	String Se hai definito query personalizzate nel file di configurazione, devi specificare un nome univoco per ogni query personalizzata. Il nome della query deve essere univoco perché viene utilizzato per creare l'URL predefinito della metrica in Monitoring.
hana_monitoring_configuration.queries.run_on	String Facoltativo. Specifica questo parametro se monitori un sistema SAP HANA HA e vuoi eseguire le query di monitoraggio SAP HANA sul nodo primario o secondario. Valori supportati: PRIMARY, SECONDARY, ALL. Quando specifichi il valore ALL, l'agente esegue le query di monitoraggio SAP HANA sia sui nodi primario che secondario del cluster HA. Questo parametro è supportato a partire dalla versione 3.7 dell'agente. Inoltre, per eseguire le query sul nodo secondario, assicurati che il sistema HA sia implementato con la configurazione Attivo/Attivo (lettura abilitata).
hana_monitoring_configuration.queries.sql	String Specifica l'istruzione SQL che l'agente invia alle tue istanze SAP HANA. L'istruzione SQL deve essere conforme alla sintassi SQL definita da SAP in 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. Questa impostazione sostituisce l'intervallo di campionamento globale. Il valore deve essere di 5 secondi o più.
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 Monitoring.
hana_monitoring_configuration.queries.columns.metric_type	String Per la gestione da parte di 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 ulteriori informazioni, vedi 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 di query e 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 sulla diagnosi e la risoluzione dei problemi che potresti riscontrare durante l'installazione e la configurazione dell'agente per SAP di Google Cloud, consulta la guida alla risoluzione dei problemi dell'agente per SAP diGoogle Cloud.

Assistenza

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