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 è necessario per l'assistenza SAP dei sistemi SAP in esecuzione su un server Bare Metal Solution.

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

• RHEL: tutte le immagini "per SAP"
• SLES: SLES 15 SP4 for SAP e versioni successive

Per informazioni sui sistemi operativi disponibili per l'esecuzione di SAP su server Bare Metal Solution, consulta quanto segue:

• Per SAP HANA, consulta Sistemi operativi certificati.
• Per SAP NetWeaver, consulta Sistemi operativi certificati.

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

Panoramica dell'installazione

L'agente di Google Cloud per SAP viene installato utilizzando i comandi di gestione dei pacchetti del sistema operativo standard: 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.
• Attiva 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 di Google Cloud per SAP su un server Bare Metal Solution.

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

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

1. Nel sistema SAP, inserisci la transazione ST06.

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

   • Fornitore di servizi cloud: Google Cloud Platform
   • Accesso al monitoraggio avanzato: TRUE
   • Dettagli sul monitoraggio migliorato: ACTIVE

Configurare l'agente di Google Cloud per SAP su Linux

Dopo aver installato l'agente di Google Cloud per SAP, facoltativamente puoi configurarlo per abilitare 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.

Le metriche di valutazione di Workload Manager e la raccolta delle metriche di monitoraggio dei processi sono supportate solo su Linux.

Se attivi la raccolta delle metriche di valutazione di Workload Manager e di monitoraggio dei processi, devi completare i seguenti prerequisiti:

• Crea un account di servizio IAM per consentire all'agente di accedere alle risorse 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 informazioni dettagliate, consulta Installare l'interfaccia a riga di comando gcloud.
• Per accedere a Google Cloud, autorizza gcloud CLI. Per maggiori dettagli, consulta Autorizzare l'interfaccia a riga di comando gcloud.
• Stabilisci la connessione alle API Google Cloud. Per maggiori dettagli, leggi come configurare l'accesso privato Google per gli host on-premise.

Configurare un account di servizio

Per consentire all'agente di accedere alle risorse di 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 monitoraggio (roles/monitoring.metricWriter).

Per creare un account di servizio:

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 delle metriche di valutazione di Workload Manager

Per attivare la raccolta delle metriche di monitoraggio dei processi e delle metriche 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 al database SAP HANA ed eseguire query, 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 illustra i parametri di configurazione della versione 1 dell'agente di Google Cloud per SAP.

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:

• Agente per SAP - Panoramica di HANA: Questa dashboard fornisce grafici che mostrano una panoramica dello stato per le seguenti metriche: Disponibilità SAP HANA, Disponibilità SAP HANA HA, Repliche SAP HANA HA, Stato servizio SAP HANA, Cluster HA - Stato nodo e Cluster HA - Stato risorsa per le istanze SAP.

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

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

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

Installare le dashboard

Per installare una dashboard personalizzata:

Visualizzare le dashboard installate

Per visualizzare le dashboard installate:

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

   Vai a Monitoring

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

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

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

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

Assistenza

Se hai bisogno di aiuto per risolvere i problemi relativi all'agente per SAP di Google Cloud, raccogli tutte le informazioni di diagnostica disponibili e contatta l'assistenza clienti Google Cloud. Per informazioni su come contattare il team dell'assistenza clienti, consulta Assistenza per SAP su Google Cloud.