Versione 1: installa e configura l'agente 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 installare e configurare la versione 1 di un agente di Google Cloud per SAP su un'istanza VM di Compute Engine, consulta Installare l'agente Google Cloud per SAP su un'istanza VM di Compute Engine.

Panoramica dell'installazione

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

  1. Stabilisci una connessione SSH 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 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:

  1. Nel sistema SAP, inserisci la transazione ST06.

  2. 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 abilitare la raccolta di metriche di Process Monitoring e le metriche di valutazione di Workload Manager. Per impostazione predefinita, la raccolta solo delle metriche dell'agente host SAP sia abilitato.

La raccolta delle metriche di valutazione del Gestore carichi di lavoro e delle metriche di supportata solo su Linux.

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

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 con cui l'agente devono includere il ruolo Writer metriche Monitoring (roles/monitoring.metricWriter).

Per creare un account di servizio, segui questi passaggi:

  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 a cui l'agente può accedere.

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

ad abilitare le metriche di Process Monitoring e la valutazione del Gestore carichi di lavoro. raccolta delle metriche, segui questi passaggi:

  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 a true:

    • collect_process_metrics: consente all'agente di raccogliere Process Monitoring metrics. Per la raccolta delle metriche del database SAP HANA, per accedere ed eseguire query al database SAP HANA, devi configurare ulteriori nella sezione hana_metrics_config.
    • collect_workload_validation_metrics: consente all'agente di raccogliere Metriche di valutazione del Gestore carichi di lavoro.

    Per ulteriori informazioni sui parametri, consulta la seguente tabella.

  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 spiega i parametri di configurazione della versione 1 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.
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_id

String

Specifica il nome del server Bare Metal Solution su cui disponi ha installato l'agente.
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

Specifica la frequenza di raccolta delle metriche di Process Monitoring, in secondi. Il valore predefinito di questo parametro è 5 secondi.

Sebbene sia possibile aggiornare la frequenza di raccolta del processo, Monitorando le metriche, ti consigliamo di utilizzare il valore predefinito. Se modificare il valore predefinito, quindi aggiungere process_metrics_frequency sotto la collection_configuration e fornisci i requisiti richiesti valore.
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.

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.

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.

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 obbligatori al file di configurazione. L'esempio seguente mostra un file di configurazione completato per installare l'agente su 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 Metriche di monitoraggio dei processi raccolti dall'agente, puoi utilizzare le seguenti dashboard personalizzate Google Cloud fornisce:

  • Panoramica dell'agente per SAP - HANA: Questa dashboard fornisce grafici che mostrano una panoramica dello stato per: metrics: Disponibilità SAP HANA, disponibilità SAP HANA, replica SAP HANA HA, Stato del servizio SAP HANA, cluster ad alta disponibilità - stato nodo e cluster ad alta disponibilità - Risorsa per le istanze SAP.

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

  • Agente per SAP - Metriche non elaborate HANA: Questa dashboard fornisce grafici che mostrano i valori delle metriche non elaborati per le seguenti metriche: Disponibilità SAP HANA, disponibilità SAP HANA, replica SAP HANA HA, Stato del servizio SAP HANA, cluster ad alta disponibilità - stato nodo Cluster ad alta disponibilità - Stato della 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

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

    Visualizzazione della scheda della Raccolta di esempio selezionata.

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

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

  6. Seleziona la dashboard da installare.

  7. Fai clic su Importa, quindi su Conferma.

    La dashboard viene aggiunta alle dashboard disponibili in progetto Google Cloud. Per visualizzare la dashboard, segui le istruzioni in Visualizza 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 file JSON corrispondente:

    gcloud monitoring dashboards create --config-from-file=CONFIG_FROM_FILE

    Sostituisci CONFIG_FROM_FILE con il percorso della File JSON contenente la configurazione della dashboard. Pannello file di configurazione possono trovarsi nel percorso: monitoring-dashboard-samples/dashboards/google-cloud-agent-for-sap.

    La dashboard viene aggiunta alle dashboard disponibili in progetto Google Cloud. Per visualizzare la dashboard, segui le istruzioni in Visualizza 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 hai molte dashboard, puoi applicare un filtro in base alle dashboard personalizzate il 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 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 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.