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

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

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

  • RHEL: tutte le immagini "for 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 di Google Cloud su un'istanza VM di Compute Engine, consulta Installare l'agente per SAP di Google Cloud su un'istanza VM di Compute Engine.

Panoramica dell'installazione

Puoi installare l'agente di Google Cloud per 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 di Google Cloud per SAP.
  • Crea l'agente come servizio Linux systemd, 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 più funzionalità. Per le istruzioni, consulta Installare e configurare l'agente Google Cloud per SAP su un server Bare Metal Solution.

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

Dopo aver installato l'agente Google Cloud per SAP e l'agente host SAP, convalida l'installazione dell'agente Google Cloud per SAP, come descritto nella sezione Convalidare 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.

Verificare che l'agente host SAP stia ricevendo le metriche

Per verificare che le metriche dell'infrastruttura vengano raccolte dall'agente per SAP di Google Cloud e inviate correttamente all'agente host SAP, segui questi passaggi:

  1. Nel tuo sistema SAP, inserisci la transazione ST06.

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

    • Cloud Provider: Google Cloud Platform
    • Accesso a Monitoring avanzato: TRUE
    • Dettagli sul monitoraggio avanzato: ACTIVE

Configura l'agente di Google Cloud per SAP su Linux

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

Le metriche di valutazione del Gestore carichi di lavoro e la raccolta di metriche di monitoraggio dei processi sono supportate solo su Linux.

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

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:

  1. Crea un account di servizio:

    1. Nella console Google Cloud, vai alla pagina Crea account di servizio.

      Vai a Crea account di servizio
    2. Seleziona il progetto.

    3. Nel campo Nome account di servizio, inserisci un nome. La console Google Cloud compila il campo ID account di servizio in base a questo nome.

      Nel campo Descrizione account di servizio, inserisci una descrizione. Ad esempio, Service account for quickstart.

    4. Fai clic su Crea e continua.

    5. Concedi il ruolo Monitoring > Monitoring Metric Writer all'account di servizio.

      Per concedere il ruolo, trova l'elenco Seleziona un ruolo e scegli Monitoring > Monitoring Metric Writer.

    6. Fai clic su Continua.

    7. Fai clic su Fine per completare la creazione dell'account di servizio.

      Non chiudere la finestra del browser. La utilizzerai nel passaggio successivo.

  2. Crea una chiave dell'account di servizio:

    1. Nella console Google Cloud, fai clic sull'indirizzo email dell'account di servizio che hai creato.
    2. Fai clic su Chiavi.
    3. Fai clic su Aggiungi chiave, quindi su Crea nuova chiave.
    4. Fai clic su Crea. Un file della chiave JSON viene scaricato sul computer.
    5. Fai clic su Chiudi.

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

Abilita metriche di monitoraggio dei processi e raccolta di metriche di valutazione del Gestore carichi di lavoro

Per abilitare la raccolta delle metriche di monitoraggio dei processi e della raccolta delle metriche di valutazione del Gestore carichi di lavoro, segui questi passaggi:

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

  2. Apri il file di configurazione seguente:

    /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 metriche di monitoraggio dei processi. Per la raccolta delle metriche del database SAP HANA, per accedere al database SAP HANA ed eseguire query è necessario configurare parametri aggiuntivi nella sezione hana_metrics_config.
    • collect_workload_validation_metrics: consente all'agente di raccogliere metriche di valutazione di Workload Manager.

    Per saperne di più 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 illustra 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 dall'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 viene 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 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 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 in cui è installato.
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 per l'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 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 monitoraggio dei processi, specifica true. Il valore predefinito è false.
Questo parametro è applicabile solo a Linux.

Se abiliti la raccolta delle metriche di elaborazione 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 è di 5 secondi.

Sebbene sia possibile 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 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é utilizzare una password in testo normale, ti consigliamo di utilizzare un secret in Secret Manager specificando il nome del secret in hana_db_password_secret_name.

Non specificare una password se utilizzi Secret Manager per archiviare le credenziali utente del database. Quando nella configurazione sono specificati entrambi i criteri hana_db_password e hana_db_password_secret_name, viene attivato un errore e l'agente non può connettersi al database.
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.

Le metriche relative a SAP HANA vengono raccolte solo se è impostata l'opzione hana_db_password_secret_name o hana_db_password.
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 a 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.

Se devi modificare la frequenza di raccolta delle metriche del 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.
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 è una macchina locale, specifica la stringa localhost o l'indirizzo IP di loopback del 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 la tua istanza SAP HANA accetta le query. Per la prima o la sola 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 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:

  • Agent for SAP - HANA Overview: Questa dashboard fornisce grafici che mostrano una panoramica dello stato per le seguenti metriche: Disponibilità SAP HANA, Disponibilità SAP HANA HA, Replica SAP HANA HA, Stato del servizio SAP HANA, Cluster ad alta disponibilità - Stato del nodo e Cluster ad alta disponibilità - Stato risorsa 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 valori delle metriche non elaborati per le seguenti metriche: Disponibilità SAP HANA , Disponibilità SAP HANA HA, Replica SAP HANA HA, Stato del servizio SAP HANA, Cluster ad alta disponibilità - Stato del nodo e Cluster ad alta disponibilità - Stato della risorsa per le 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

  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 Raccolta di esempio.

    Visualizzazione della scheda della raccolta di esempi selezionata.

  4. Per filtrare le dashboard personalizzate specifiche dell'agente, digita Agent for SAP nel campo Filtro.

  5. (Facoltativo) Per visualizzare i dettagli di una dashboard o per visualizzarne l'anteprima, fai clic su Anteprima.

  6. Seleziona la dashboard da installare.

  7. Fai clic su Importa e poi su Conferma.

    La dashboard viene aggiunta alle dashboard disponibili nel progetto Google Cloud. Per vedere 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 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 che contiene la configurazione della dashboard. I file di configurazione della dashboard possono essere trovati nel percorso: monitoring-dashboard-samples/dashboards/google-cloud-agent-for-sap.

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

Visualizza le dashboard installate

Per visualizzare le dashboard installate:

  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 disponi di molte dashboard, puoi filtrare in base alle dashboard personalizzate o 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.

Lo screenshot mostra la dashboard personalizzata per le metriche SAP HANA in Monitoring

Risoluzione dei problemi

Per informazioni sulla diagnosi e sulla risoluzione dei problemi che potresti riscontrare durante l'installazione e la configurazione di Agent for SAP di Google Cloud, consulta la guida alla risoluzione dei problemi di Google Cloud Agent for SAP.

Richiedere assistenza

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