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

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 installare e configurare la versione 1 dell'agente per SAP diGoogle Cloudsu un'istanza Compute Engine, consulta Installare l'agente per SAP di Google Cloudsu un'istanza Compute Engine.

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 1 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 di Google Cloudper SAP, puoi configurarlo facoltativamente per attivare la raccolta delle metriche di monitoraggio dei processi e delle metriche di valutazione di Workload Manager. Per impostazione predefinita, è abilitata la raccolta solo delle metriche dell'agente host SAP.

La raccolta delle metriche di valutazione di Workload Manager e delle metriche di monitoraggio dei processi è supportata solo su Linux.

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

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.

    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.

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

Abilita la raccolta delle metriche di monitoraggio dei processi e di valutazione di Workload Manager

Per attivare la raccolta delle metriche di monitoraggio dei processi e di valutazione di Workload Manager:

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

  2. Apri il seguente file di configurazione:

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

  3. Nella sezione collection_configuration, imposta i seguenti parametri su true:

    • collect_process_metrics: consente all'agente di raccogliere le metriche di monitoraggio dei processi. Per la raccolta delle metriche del database SAP HANA, per accedere ed eseguire query sul database SAP HANA, devi configurare parametri aggiuntivi nella sezione hana_metrics_config.
    • collect_workload_validation_metrics: consente all'agente di raccogliere le metriche di valutazione di Workload Manager.

    Per ulteriori informazioni sui parametri, consulta la tabella seguente.

  4. Salva il file di configurazione.

  5. Riavvia l'agente per applicare le nuove impostazioni. 

    sudo systemctl restart google-cloud-sap-agent

Parametri di configurazione

La tabella seguente descrive i parametri di configurazione della versione 1 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.
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_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 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

Specifica la frequenza di raccolta delle metriche di monitoraggio dei processi, in secondi. Il valore predefinito di questo parametro è 5 secondi.

Anche se puoi aggiornare la frequenza di raccolta delle metriche di monitoraggio dei processi, 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 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.

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.

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.

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 completo 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à HA SAP HANA, Replicazione HA SAP HANA, Stato del servizio SAP HANA, Stato del nodo del cluster HA e Stato della risorsa del cluster HA per le istanze SAP.

    Il file JSON per questa dashboard è sap-agent-status-overview.json.

  • Agente per SAP - Metriche non elaborate di HANA: questa dashboard fornisce grafici che mostrano i valori delle metriche non elaborate per le seguenti metriche: Disponibilità SAP HANA, Disponibilità HA SAP HANA, Replica HA SAP HANA, Stato del servizio SAP HANA, Stato del nodo del cluster HA e Stato della risorsa del cluster HA per le istanze SAP.

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

Installare dashboard

Per installare una dashboard personalizzata:

Console Google Cloud

  1. Nella console Google Cloud , vai alla pagina Monitoring:

    Vai a Monitoring

  2. Nel pannello di navigazione di Monitoring, fai clic su Dashboard.

  3. Fai clic sulla scheda Libreria di campioni.

    Visualizzazione della scheda della libreria di esempi selezionata.

  4. Per filtrare le dashboard personalizzate specifiche per gli agenti, nel campo Filtro, digita Agent for SAP.

  5. (Facoltativo) Per visualizzare i dettagli di un dashboard o per visualizzarne i contenuti, fai clic su Anteprima.

  6. Seleziona il pannello che vuoi installare.

  7. Fai clic su Importa e poi su Conferma.

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

Google Cloud CLI

  1. Apri Cloud Shell:

    Apri Cloud Shell

  2. In Cloud Shell, clona o scarica il repository:

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

  3. In Cloud Shell, installa il dashboard richiesto 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 che contiene la configurazione del dashboard. I file di configurazione del 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 riportate in Visualizzare la dashboard installata.

Visualizzare le dashboard installate

Per visualizzare i prospetti installati:

  1. Nella console Google Cloud , vai alla pagina Monitoring:

    Vai a Monitoring

  2. Nel pannello di navigazione di Monitoring, fai clic su Dashboard.

  3. Fai clic sul nome della dashboard nell'elenco.

Se hai molte dashboard, puoi filtrare quelle personalizzate o in base al nome della nuova dashboard. Per informazioni sul filtraggio di 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 dello schermo mostra la dashboard personalizzata per le metriche SAP HANA in Monitoring

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.