Questa pagina è stata tradotta dall'API Cloud Translation.

Versione 1: installa e configura l'agente Google Cloud per SAP su un server Bare Metal Solution

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

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 disponibili per l'esecuzione di SAP sui server Bare Metal Solution, consulta le seguenti pagine:

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

Per installare e configurare la versione 1 di Agent di Google Cloud per SAP su un'istanza VM di Compute Engine, consulta Installare Agent di Google Cloud per SAP su un'istanza VM di Compute Engine.

Panoramica dell'installazione

Puoi installare l'agente di Google Cloud per SAP 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.

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 per SAP di Google Cloud su un server Bare Metal Solution.

Per installare la versione 1 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

Stabilisci una connessione SSH con il 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 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 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, puoi configurare l'agente per abilitare la raccolta di metriche di monitoraggio dei processi e metriche di valutazione di Workload Manager. Per impostazione predefinita, è abilitata solo la raccolta delle metriche dell'agente host SAP.

Le metriche di valutazione di Gestore carichi di lavoro e la raccolta delle metriche di Process Monitoring è supportata solo su Linux.

Se abiliti le metriche di valutazione del Gestore carichi di lavoro e la raccolta delle metriche di Process Monitoring, devi completare i prerequisiti seguenti:

Crea un account di servizio IAM affinché l'agente possa accedere alle risorse di Google Cloud. Concedi il ruolo IAM richiesto all'account di servizio. Per maggiori dettagli, vedi Configurare un account di servizio.
Sul server Bare Metal Solution, installa gcloud CLI. Per maggiori dettagli, consulta Installare gcloud CLI.
Per accedere a Google Cloud, autorizza gcloud CLI. Per maggiori dettagli, consulta Autorizzare gcloud CLI.
Stabilisci una connessione alle API Google Cloud. Per maggiori dettagli, vedi Configurare l'accesso privato Google per gli host on-premise.

Configurare un account di servizio

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

Carica il file della chiave JSON in una posizione sicura sul server Bare Metal Solution accessibile all'agente.

Abilita le metriche di Process Monitoring e la raccolta delle metriche di valutazione del Gestore carichi di lavoro

Per abilitare la raccolta delle metriche di Process Monitoring e di valutazione di Workload Manager, segui questi passaggi:

Stabilisci una connessione SSH con il server Bare Metal Solution.

Apri il seguente file di configurazione:

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

Nella sezione collection_configuration, imposta i seguenti parametri su true:
- collect_process_metrics: consente all'agente di raccogliere le metriche di Process Monitoring. Per la raccolta delle metriche del database SAP HANA, per accedere al database SAP HANA ed eseguirvi query, devi impostare parametri aggiuntivi nella sezione hana_metrics_config.
- collect_workload_validation_metrics: consente all'agente di raccogliere metriche di valutazione di Workload Manager.
Per ulteriori informazioni sui parametri, consulta la seguente tabella.
Salva il file di configurazione.
Riavvia l'agente per applicare le nuove impostazioni.
```
sudo systemctl restart google-cloud-sap-agent
```

Parametri di configurazione

La tabella seguente spiega i parametri di configurazione della versione 1 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`.
`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_id`	`String` Specifica il nome del server Bare Metal Solution su cui hai installato l'agente.
`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` Specifica la frequenza di raccolta delle metriche di Process Monitoring in secondi. Il valore predefinito di questo parametro è `5` secondi. Anche se puoi aggiornare la frequenza di raccolta delle metriche di Process Monitoring, ti consigliamo di utilizzare il valore predefinito. Se devi modificare il valore predefinito, aggiungi il parametro `process_metrics_frequency` nella sezione `collection_configuration` e fornisci il valore richiesto.
`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: `hana_db_password_secret_name`, per il quale specifichi un secret archiviato in Secret Manager. `hdbuserstore_key`, per il quale specifichi una chiave `hdbuserstore`.
`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 VM host devono esistere nello stesso progetto Google Cloud. 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. Ti consigliamo di non modificare la frequenza di raccolta predefinita, poiché potrebbe influire sull'intera funzionalità stessa. 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.

Configurazione predefinita

{
  "provide_sap_host_agent_metrics": true,
  "log_level": "INFO",
  "log_to_cloud": true,
  "collection_configuration": {
    "collect_workload_validation_metrics": false,
    "collect_process_metrics": false
  }
}

Configurazione di esempio

Per installare l'agente su un server Bare Metal Solution, devi aggiungere i parametri richiesti al file di configurazione. L'esempio seguente mostra un file di configurazione completato per l'installazione dell'agente su un server Bare Metal Solution.

{
  "provide_sap_host_agent_metrics": true,
  "bare_metal": true,
  "log_level": "INFO",
  "log_to_cloud": true,
  "collection_configuration": {
    "collect_workload_validation_metrics": false,
    "collect_process_metrics": true,
    "hana_metrics_config": {
      "hana_db_user": "user",
      "hana_db_password_secret_name": "secret-name"
    }
  },
  "cloud_properties": {
    "project_id": "my-project",
    "instance_id": "bms-machine-1",
    "image": "rhel-8",
    "region": "us-central1"
  }
}

Visualizzare le metriche raccolte

Per visualizzare le metriche di monitoraggio dei processi raccolte dall'agente, puoi utilizzare le seguenti dashboard personalizzate fornite da Google Cloud:

Panoramica dell'agente per SAP - HANA: questa dashboard fornisce grafici che mostrano la panoramica dello stato per le seguenti metriche: Disponibilità SAP HANA, disponibilità SAP HANA, replica SAP HANA HA, stato del servizio SAP HANA, cluster HA - stato nodo e cluster HA - stato risorsa per istanze SAP.

Il file JSON per questa dashboard è sap-agent-status-overview.json.
Agent for SAP - HANA Raw Metrics: Questa dashboard fornisce grafici che visualizzano i valori delle metriche non elaborate per le seguenti metriche: Disponibilità SAP HANA, Disponibilità HA SAP HANA, replica SAP HANA HA, Stato del servizio SAP HANA, Cluster HA - stato nodo e Cluster HA - stato risorsa per istanze SAP.

Il file JSON per questa dashboard è sap-agent-raw-metrics.json.

Installa dashboard

Per installare una dashboard personalizzata, completa i seguenti passaggi:

Console Google Cloud

Nella console Google Cloud, vai alla pagina Monitoring:

Vai a Monitoring
Nel pannello di navigazione di Monitoring, fai clic su Dashboard.
Fai clic sulla scheda Raccolta di esempi.
Per filtrare le dashboard personalizzate specifiche dell'agente, nel campo Filtro, digita Agent for SAP.
(Facoltativo) Per visualizzare i dettagli di una dashboard o per visualizzarne l'anteprima, fai clic su Anteprima.
Seleziona la dashboard da installare.
Fai clic su Importa, quindi su Conferma.

La dashboard viene aggiunta alle dashboard disponibili nel tuo progetto Google Cloud. Per visualizzare la dashboard, segui le istruzioni in Visualizzare la dashboard installata.

Google Cloud CLI

Apri Cloud Shell:

Apri Cloud Shell

In Cloud Shell, clona o scarica il repository:

git clone https://github.com/GoogleCloudPlatform/monitoring-dashboard-samples/

In Cloud Shell, installa la dashboard richiesta utilizzando il file JSON corrispondente:
```
gcloud monitoring dashboards create --config-from-file=CONFIG_FROM_FILE
```
Sostituisci CONFIG_FROM_FILE con il percorso del file JSON contenente la configurazione della dashboard. I file di configurazione della dashboard si trovano nel percorso: monitoring-dashboard-samples/dashboards/google-cloud-agent-for-sap.

La dashboard viene aggiunta alle dashboard disponibili nel tuo progetto Google Cloud. Per visualizzare la dashboard, segui le istruzioni in Visualizzare la dashboard installata.

Visualizza le dashboard installate

Per visualizzare le dashboard installate:

Nella console Google Cloud, vai alla pagina Monitoring:

Vai a Monitoring
Nel pannello di navigazione di Monitoring, fai clic su Dashboard.
Fai clic sul nome della dashboard nell'elenco.

Se hai molte dashboard, puoi applicare un filtro in base alle dashboard personalizzate o in base al nome della nuova dashboard. Per informazioni su come filtrare questo elenco, consulta Visualizzare le dashboard personalizzate.

L'immagine seguente è un esempio che mostra una parte della dashboard personalizzata per le metriche SAP HANA in Monitoring.

L'acquisizione schermo mostra la dashboard personalizzata
per le metriche SAP HANA in Monitoring

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.