Questa pagina è stata tradotta dall'API Cloud Translation.

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

Per il supporto SAP dei sistemi SAP in esecuzione, è richiesto l'agente Google Cloud per SAP su un server Bare Metal Solution.

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 disponibili per l'esecuzione di SAP sui server Bare Metal Solution, controlla quanto segue:

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

Per installare e configurare la versione 2 di di Google Cloud per SAP su un'istanza VM di Compute Engine, consulta Installa l'agente di Google Cloud per SAP su un'istanza VM di Compute Engine.

Panoramica dell'installazione

Puoi installare l'agente 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.

Installa l'agente

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

Per installare la versione 2 dell'agente Google Cloud per SAP, contatta Assistenza clienti Google 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

Stabilisci una connessione SSH server Bare Metal Solution.

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 l'agente host SAP stia ricevendo le metriche

Per verificare che le metriche dell'infrastruttura siano raccolte l'agente Google Cloud per SAP e inviato correttamente a SAP Host Agent. segui questi passaggi:

Nel sistema SAP, inserisci la transazione ST06.
Nel riquadro Panoramica, verifica la disponibilità e il contenuto i seguenti campi per la corretta configurazione end-to-end di SAP e di Google dell'infrastruttura di monitoraggio:
- 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 configurare per la raccolta delle metriche di monitoraggio dei processi, Workload Manager metriche di valutazione e metriche di monitoraggio SAP HANA. Per impostazione predefinita, dei dati che compongono Metriche dell'agente host SAP sia abilitato.

Prerequisiti

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

Crea un account di servizio IAM per consentire all'agente di accedere a risorse Google Cloud e quindi concedere le autorizzazioni IAM richieste ruoli all'account di servizio. Consulta Configurare un account di servizio per maggiori dettagli.
Installa gcloud CLI sul server Bare Metal Solution. Consulta Installa l'interfaccia a riga di comando gcloud per maggiori dettagli.
Per accedere a Google Cloud, autorizza gcloud CLI. Consulta Autorizza gcloud CLI per maggiori dettagli.
Stabilisci una connessione alle API Google Cloud. Consulta Configurare l'accesso privato Google per gli host on-premise per maggiori dettagli.

Configurare un account di servizio

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

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

Per creare un account di servizio, segui questi passaggi:

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. In production environments, do not grant the Owner, Editor, or Viewer roles. Instead, grant a predefined role or custom role that meets your needs.
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.
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 l'account di servizio, assicurati di caricare il relativo file di chiave JSON in una posizione sicura sul server Bare Metal Solution accessibile all'utente un agente.

Abilita le funzionalità

Dopo aver configurato un account di servizio per la tua soluzione Bare Metal Solution e avergli concesso il ruoli richiesti, puoi abilitare altre funzionalità dell'agente Google Cloud per SAP eseguendo le seguenti configurazioni:

File di configurazione predefinito

Il seguente snippet è un esempio della configurazione predefinita versione 2 dell'agente 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 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 sono gestite 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 sistema SAP è in esecuzione su un server Bare Metal Solution: specificare l'ID del progetto Google Cloud che stai 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` Specifica il nome del server Bare Metal Solution su cui disponi ha installato l'agente. Nella versione 2.5 dell'agente o in quelle precedenti, specifica Nome del server Bare Metal Solution per la proprietà `instance_id`.
`cloud_properties.region`	`String` Se il sistema SAP è in esecuzione su un server Bare Metal Solution, e specifica l'area geografica del server Bare Metal Solution. Quando l'agente viene eseguito su un'istanza VM, per impostazione predefinita utilizza dell'istanza VM su cui è installato l'agente.
`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 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 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 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` Dalla versione 2.6, questo parametro determina la frequenza di raccolta del metriche di Process Monitoring in rapida evoluzione, in pochi 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 di questo parametro è `5` secondi. Ti consigliamo di utilizzare questo valore predefinito. Tutte le altre metriche di Process Monitoring (in lento cambiamento) vengono raccolte in un 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 le metriche di Process Monitoring 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 correlate a SAP HANA solo quando 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.
`collection_configuration.collect_workload_validation_metrics`	`Boolean` Per abilitare la raccolta delle metriche di valutazione del Gestore carichi di lavoro, specificare `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 del Gestore carichi di lavoro le metriche di valutazione in pochi secondi. Il valore predefinito è `300` secondi. Ti consigliamo di non modificare il valore predefinito la frequenza di raccolta dei dati, poiché potrebbe influire sull'intera funzionalità stessa. Se devi modificare la frequenza di raccolta del le metriche di Gestore carichi di lavoro, quindi aggiungi `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 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 che ospita la tua 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 è un computer remoto, specifica il suo interno all'indirizzo IP 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 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 sia possibile aggiornare la frequenza di raccolta Metriche del database SAP HANA, ti consigliamo di utilizzare il valore predefinito. Se devi modificare il valore predefinito, aggiungi il parametro Parametro `workload_validation_db_metrics_frequency` in alla sezione `collection_configuration` e fornisci i requisiti valore. 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 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 il SID della tua istanza SAP HANA. Questa stringa viene aggiunta come a tutte le metriche risultanti dall'esecuzione di query sulle tue 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 è una macchina locale, specifica la stringa `localhost` o l'indirizzo IP di loopback localhost, ad esempio `127.0.0.1`. Se l'host è un computer remoto, specifica il suo interno all'indirizzo IP 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 l'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, in testo normale, che esegue l'autenticazione 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 è abilitato o meno in SAP HANA in esecuzione in un'istanza Compute Engine. Il valore predefinito è `false`.
`hana_monitoring_configuration.hana_instances.host_name_in_certificate`	`String` Se specifichi `enable_ssl: true` per una richiesta 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 una richiesta SAP HANA devi specificare il percorso per la configurazione certificato.
`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 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 SAP in Riferimento SQL di SAP HANA e visualizzazioni di sistema.
`hana_monitoring_configuration.queries.sample_interval_sec`	`Int` Facoltativo. Specifica l'intervallo di esempio per la query SQL. Questo sostituisce l'intervallo di campionamento globale. Il valore deve essere di 5 secondi o più a lungo.
`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 la predefinito della metrica in Monitoring.
`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 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 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 un percorso personalizzato: `workload.googleapis.com/sap/hanamonitoring/CUSTOM_PATH`

Risoluzione dei problemi

Per informazioni su come diagnosticare e risolvere problemi che potresti incontrati quando installi e configuri l'agente di Google Cloud per SAP, consulta Guida alla risoluzione dei problemi di Agent for SAP di Google Cloud.

Assistenza

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