Installa e configura l'agente di Google Cloud per SAP su un'istanza Compute Engine

L'agente di Google Cloud per SAP è necessario per il supporto SAP dei sistemi SAP in esecuzione su Google Cloud, tra cui SAP NetWeaver, SAP HANA, SAP ASE, SAP MaxDB e altri.

Quando installi l'agente di Google Cloud per SAP su un'istanza Compute Engine, per le metriche dell'agente host SAP, l'agente combina i dati di monitoraggio di Cloud Monitoring e delle API Compute Engine e li fornisce all'agente host SAP.

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 supportati dall'Agente per SAP di Google Cloud, consulta Sistemi operativi supportati.

Per installare e configurare la versione 3.6 (la più recente) dell'agente di Google Cloud per SAP su un server Bare Metal Solution, consulta Installare l'agente di Google Cloud per SAP su un server Bare Metal Solution.

Panoramica dell'installazione

Su Linux, installa l'agente di Google Cloud per SAP 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 la versione più recente dell'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.

Su Windows, installa l'agente di Google Cloud per SAP utilizzando il comando di gestione del pacchetto GooGet, googet. Il comando di gestione dei pacchetti completa le seguenti attività:

  • Scarica la versione più recente dell'agente di Google Cloud per SAP.

  • Crea un servizio Windows denominato google-cloud-sap-agent e un'attività pianificata che viene eseguita ogni minuto per verificare se il servizio è ancora in esecuzione e, se necessario, riavviarlo.

Prerequisiti per l'agente

Prima di installare l'agente di Google Cloud per SAP, devi assicurarti che siano soddisfatti i seguenti prerequisiti.

Imposta i ruoli IAM richiesti

Come minimo, l'account di servizio utilizzato dall'Agent for SAP di Google Cloud deve includere i ruoli Visualizzatore Compute (roles/compute.viewer), Visualizzatore monitoraggio (roles/monitoring.viewer) e Writer di Workload Manager Insights (roles/workloadmanager.insightWriter).

Per aggiungere un ruolo obbligatorio all'account di servizio:

  1. Nella console Google Cloud, vai alla pagina IAM.

    Vai a IAM

  2. Selezionare il tuo progetto Google Cloud.

  3. Identifica l'account di servizio a cui vuoi aggiungere un ruolo.

    • Se l'account di servizio non è già presente nell'elenco delle entità, non sono stati assegnati ruoli. Fai clic su Aggiungi e inserisci l'indirizzo email dell'account di servizio.
    • Se l'account di servizio è già presente nell'elenco dei principali, significa che ha già dei ruoli. Fai clic sul pulsante Modifica per l'account di servizio che vuoi modificare.

  4. Seleziona il ruolo richiesto dall'elenco dei ruoli disponibili:

    • Compute Engine > Visualizzatore Compute
    • Monitoraggio > Visualizzatore monitoraggio
    • Workload Manager > Workload Manager Insights Writer

  5. Fai clic su Aggiungi o Salva per applicare i ruoli all'account di servizio.

Abilita l'accesso alle API Google Cloud

Compute Engine consiglia di configurare le istanze di calcolo in modo da consentire tutti gli ambiti di accesso a tutte le API Cloud e di utilizzare solo le autorizzazioni IAM dell'account di servizio dell'istanza per controllare l'accesso alle risorse Google Cloud. Per ulteriori informazioni, consulta Creare una VM che utilizza un account di servizio gestito dall'utente.

Se limiti l'accesso alle API Cloud, Agent for SAP di Google Cloud richiede i seguenti ambiti di accesso alle API Cloud minimi sull'istanza Compute Engine di hosting:

  • Piattaforma cloud: Attivata
  • Compute Engine: Sola lettura
  • API Stackdriver Monitoring: sola lettura

Se esegui applicazioni SAP su un'istanza di calcolo che non ha un indirizzo IP esterno, devi attivare l'accesso privato Google nella sottorete dell'istanza di calcolo in modo che l'agente di Google Cloud per SAP possa accedere alle API e ai servizi Google. Per abilitare l'accesso privato Google su una subnet, consulta la sezione Configurare l'accesso privato Google.

Installa l'agente

Per installare l'agente di Google Cloud per SAP nell'istanza Compute Engine, seleziona il sistema operativo e poi completa i passaggi che seguono.

Linux

Per installare l'agente in un'istanza Compute Engine:

  1. Stabilisci una connessione SSH all'istanza di calcolo.
  2. Nel terminale, installa l'agente eseguendo il comando specifico per il tuo sistema operativo:
    • (Consigliato) Per installare la versione 3.6 (la più recente) dell'agente:

      RHEL

      sudo tee /etc/yum.repos.d/google-cloud-sap-agent.repo << EOM
[google-cloud-sap-agent]
name=Google Cloud Agent for SAP
baseurl=https://packages.cloud.google.com/yum/repos/google-cloud-sap-agent-el$(cat /etc/redhat-release | cut -d . -f 1 | tr -d -c 0-9)-x86_64
enabled=1
gpgcheck=1
repo_gpgcheck=0
gpgkey=https://packages.cloud.google.com/yum/doc/yum-key.gpg https://packages.cloud.google.com/yum/doc/rpm-package-key.gpg
EOM
sudo yum install google-cloud-sap-agent

      SLES15

      sudo zypper addrepo --refresh https://packages.cloud.google.com/yum/repos/google-cloud-sap-agent-sles15-x86_64 google-cloud-sap-agent
sudo zypper install google-cloud-sap-agent

      SLES 12

      sudo zypper addrepo --refresh https://packages.cloud.google.com/yum/repos/google-cloud-sap-agent-sles12-x86_64 google-cloud-sap-agent
sudo zypper install google-cloud-sap-agent
    • Per installare una versione specifica dell'agente:

      RHEL

      sudo tee /etc/yum.repos.d/google-cloud-sap-agent.repo << EOM
[google-cloud-sap-agent]
name=Google Cloud Agent for SAP
baseurl=https://packages.cloud.google.com/yum/repos/google-cloud-sap-agent-el$(cat /etc/redhat-release | cut -d . -f 1 | tr -d -c 0-9)-x86_64
enabled=1
gpgcheck=1
repo_gpgcheck=0
gpgkey=https://packages.cloud.google.com/yum/doc/yum-key.gpg https://packages.cloud.google.com/yum/doc/rpm-package-key.gpg
EOM
sudo yum install google-cloud-sap-agent-VERSION_NUMBER.x86_64

      SLES15

      sudo zypper addrepo --refresh https://packages.cloud.google.com/yum/repos/google-cloud-sap-agent-sles15-x86_64 google-cloud-sap-agent
sudo zypper install google-cloud-sap-agent-VERSION_NUMBER.x86_64

      SLES 12

      sudo zypper addrepo --refresh https://packages.cloud.google.com/yum/repos/google-cloud-sap-agent-sles12-x86_64 google-cloud-sap-agent
sudo zypper install google-cloud-sap-agent-VERSION_NUMBER.x86_64

      Sostituisci VERSION_NUMBER con il numero di versione dell'agente che vuoi installare, ad esempio 3.1-606637668. Per informazioni sulle versioni dell'agente che puoi installare, consulta Elenco di tutte le versioni dell'agente disponibili.

      Per informazioni sul downgrade dell'agente a una versione specifica, consulta Eseguire il downgrade dell'agente di Google Cloud per SAP.

Windows

Per installare l'agente in un'istanza Compute Engine:

  1. Utilizza RDP per connetterti all'istanza di calcolo.
  2. In qualità di amministratore, esegui il seguente comando da PowerShell: 
    googet addrepo google-cloud-sap-agent https://packages.cloud.google.com/yuck/repos/google-cloud-sap-agent-windows
googet install google-cloud-sap-agent

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

Per verificare che l'agente sia in esecuzione, seleziona il tuo sistema operativo e segui i passaggi:

Linux

  1. Stabilisci una connessione SSH con la tua  istanza Compute Engine.

  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

  3. Nelle immagini SLES, per assicurarti di utilizzare la versione più recente dell'agente per SAP di Google Cloud, esegui i seguenti comandi.

    sudo zypper remove google-cloud-sap-agent
sudo zypper addrepo -p 98 --refresh https://packages.cloud.google.com/yum/repos/google-cloud-sap-agent-sles15-\$basearch google-cloud-sap-agent
sudo zypper install google-cloud-sap-agent

Windows

  1. Utilizza RDP per connetterti all'istanza Compute Engine.

  2. In qualità di amministratore, esegui il seguente comando da PowerShell: 

    $(Get-Service -Name 'google-cloud-sap-agent' -ErrorAction Ignore).Status
     Se l'agente è in esecuzione, lo stato mostra Running.

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 attivare altre funzionalità dell'agente eseguendo le seguenti configurazioni. Per impostazione predefinita, la raccolta di metriche di SAP Host Agent e metriche di valutazione di Workload Manager è abilitata.

Le seguenti funzionalità sono supportate solo su Linux. Non sono supportati su Windows.

File di configurazione predefinito

Il seguente snippet è un esempio della configurazione predefinita della versione 3.6 (ultima) dell'agente di Google Cloud per SAP:

{
  "provide_sap_host_agent_metrics": true,
  "bare_metal": false,
  "log_level": "INFO",
  "log_to_cloud": true,
  "collection_configuration": {
    "collect_workload_validation_metrics": true,
    "collect_process_metrics": false
  },
  "discovery_configuration": {
    "enable_discovery": true,
    "enable_workload_discovery": true
  },
  "hana_monitoring_configuration": {
    "enabled": false
  }
}

Per visualizzare file di configurazione di esempio specifici per funzionalità, consulta la guida alla configurazione della funzionalità in questione.

Parametri di configurazione

La tabella seguente descrive i parametri di configurazione dell'agente di Google Cloud per SAP in esecuzione su un'istanza Compute Engine, inclusi i parametri relativi alla raccolta delle metriche. Per informazioni sui parametri di configurazione relativi alla funzionalità Backint dell'agente, consulta Parametri di configurazione.

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 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 ti venga 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 sistema SAP è in esecuzione su un server Bare Metal Solution, specifica l'ID progetto del progetto Google Cloud che utilizzi con Bare Metal Solution.

Per impostazione predefinita, quando l'agente viene eseguito su un'istanza Compute Engine, rileva automaticamente l'ID progetto.
cloud_properties.instance_name

String

Specifica il nome dell'istanza Compute Engine. L'agente lo rileva automaticamente al momento dell'installazione.
cloud_properties.region

String

Se il sistema SAP è in esecuzione su un server Bare Metal Solution, specifica la regione del server Bare Metal Solution.

Per impostazione predefinita, quando l'agente viene eseguito su un'istanza di calcolo, utilizza la regione in cui è stato eseguito il deployment dell'istanza.
cloud_properties.zone

String

Quando l'agente viene eseguito su un'istanza di calcolo, per impostazione predefinita utilizza la zona in cui è dipiattaforma 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 calcolo, per impostazione predefinita rileva automaticamente l'immagine del sistema operativo utilizzata dall'istanza di calcolo.
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 calcolo, per impostazione predefinita rileva automaticamente il numero del progetto.
discovery_configuration.enable_workload_discovery

Boolean

Per consentire all'agente di raccogliere i nomi e le versioni dei prodotti SAP in esecuzione sull'host, specifica true. Il valore predefinito è true.

Per ulteriori informazioni, consulta il codice dell'agente nel google-cloud-sap-agent repository GitHub in GoogleCloudPlatform/sapagent.

discovery_configuration.enable_discovery

Boolean

Per inviare a Cloud Logging le informazioni raccolte dall'agente sui prodotti SAP in esecuzione sull'host, specifica true. Il valore predefinito è true.

Se specifichi il valore false, l'agente memorizza le informazioni raccolte sull'host e non le invia a Cloud Logging.

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 attivi la raccolta delle metriche di processo per SAP HANA, devi configurare i parametri aggiuntivi elencati in hana_metrics_config.
collection_configuration.process_metrics_frequency

Int

Dalla versione 2.6, questo parametro determina la frequenza di raccolta delle metriche di monitoraggio dei processi in rapida evoluzione, in secondi. Le metriche di monitoraggio dei processi in rapida evoluzione sono: sap/hana/availability, sap/hana/ha/availability e sap/nw/availability.

Il valore predefinito per questo parametro è 5 secondi. Ti consigliamo di utilizzare questo valore predefinito.

Tutte le altre metriche di monitoraggio dei processi (in lenta evoluzione) vengono raccolte con una frequenza predefinita di 30 secondi. Per modificare la frequenza di raccolta delle metriche di monitoraggio dei processi con variazioni lente, utilizza il parametro slow_process_metrics_frequency.
collection_configuration.slow_process_metrics_frequency

Int

Specifica la frequenza di raccolta delle metriche di monitoraggio dei processi con variazioni lente, in secondi.

Il valore predefinito per questo parametro è 30 secondi.
collection_configuration.process_metrics_to_skip

Array

Specifica le metriche di monitoraggio dei processi che non vuoi che l'agente raccolga. Questo parametro accetta un valore separato da virgole dei nomi delle metriche di monitoraggio dei processi. Ad esempio: "process_metrics_to_skip": ["/sap/nw/abap/sessions", "/sap/nw/abap/rfc"].

collection_configuration.hana_metrics_config.hana_db_user

String

Specifica l'account utente del database utilizzato dall'agente 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 utilizzato dall'agente per eseguire query su SAP HANA.

Anziché specificare una password in testo normale, ti consigliamo di utilizzare una delle seguenti opzioni:

Per l'autenticazione SAP HANA, l'agente utilizza il seguente ordine di preferenza: se specificato, il parametro di configurazione hdbuserstore_key è preferito rispetto al parametro hana_db_password, che è preferito rispetto al parametro hana_db_password_secret_name. Ti consigliamo di impostare una sola opzione di autenticazione nel file di configurazione.

collection_configuration.hana_metrics_config.hana_db_password_secret_name

String

Per fornire in modo sicuro la password dell'account utente del database utilizzato dall'agente per eseguire query su SAP HANA, specifica il nome del token segreto che contiene le credenziali di sicurezza per l'account utente del database.

L'agente raccoglie le metriche relative a SAP HANA solo se specifichi hana_db_password_secret_name, hdbuserstore_key o hana_db_password.

Per l'autenticazione SAP HANA, l'agente utilizza il seguente ordine di preferenza: se specificato, il parametro di configurazione hdbuserstore_key è preferito rispetto al parametro hana_db_password, che è preferito rispetto al parametro hana_db_password_secret_name. Ti consigliamo di impostare una sola opzione di autenticazione nel file di configurazione.

collection_configuration.hana_metrics_config.hdbuserstore_key

String

Per connetterti in sicurezza a un sistema SAP HANA, specifica una chiave Secure User Store (hdbuserstore) che hai creato per quel sistema.

Per utilizzare una chiave hdbuserstore per l'autenticazione, verifica quanto segue:

  • Gli strumenti SAP hdbsql e hdbuserstore sono installati sull'istanza di calcolo che ospita l'agente.
  • La chiave hdbuserstore corrisponde a un'istanza SAP HANA specifica. Non puoi utilizzare chiavi che contengono gli hostname di più istanze SAP HANA.
  • L'utente SIDadm può eseguire query sul database SAP HANA utilizzando questa chiave. Qui SID si riferisce al valore specificato per il parametro sid. Puoi verificarlo eseguendo il seguente comando come utente SIDadm: 
    hdbsql -U HDB_USERSTORE_KEY "SELECT * FROM DUMMY"

Questo parametro di configurazione è supportato dalla versione 3.3 dell'agente.

Per l'autenticazione SAP HANA, l'agente utilizza il seguente ordine di preferenza: se specificato, il parametro di configurazione hdbuserstore_key è preferito rispetto al parametro hana_db_password, che è preferito rispetto al parametro hana_db_password_secret_name. Ti consigliamo di impostare una sola opzione di autenticazione nel file di configurazione.

collection_configuration.hana_metrics_config.sid

String

Specifica l'SID dell'istanza SAP HANA. Se utilizzi una chiave hdbuserstore per autenticarti in SAP HANA, consulta la sezione hdbuserstore_key.

collection_configuration.collect_workload_validation_metrics

Boolean

Per attivare la raccolta delle metriche di valutazione di Workload Manager, 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 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_collection_definition.fetch_latest_config

Boolean

Facoltativo. Il valore predefinito è true, che consente all'agente di raccogliere l'ultimo insieme di metriche di valutazione di Workload Manager senza che tu debba aggiornarlo. Se vuoi disattivare questo comportamento, specifica questo parametro nel file di configurazione e imposta il relativo valore su false.
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.

Per l'autenticazione SAP HANA, l'agente utilizza il seguente ordine di preferenza: se specificato, il parametro di configurazione hdbuserstore_key è preferito rispetto al parametro hana_db_password, che è preferito rispetto al parametro hana_db_password_secret_name. Ti consigliamo di impostare una sola opzione di autenticazione nel file di configurazione.

collection_configuration.workload_validation_db_metrics_config.hana_db_password_secret_name

String

Specifica il nome del segreto in Secret Manager che memorizza la password dell'account utente.

In alternativa, puoi specificare il parametro di configurazione hdbuserstore_key per autenticare l'utente SAP HANA specificato.

Per l'autenticazione SAP HANA, l'agente utilizza il seguente ordine di preferenza: se specificato, il parametro di configurazione hdbuserstore_key è preferito rispetto al parametro hana_db_password, che è preferito rispetto al parametro hana_db_password_secret_name. Ti consigliamo di impostare una sola opzione di autenticazione nel file di configurazione.

collection_configuration.workload_validation_db_metrics_config.hdbuserstore_key

String

Per connetterti in sicurezza a un sistema SAP HANA, specifica una chiave Secure User Store (hdbuserstore) che hai creato per quel sistema.

Per utilizzare una chiave hdbuserstore per l'autenticazione, verifica quanto segue:

  • Gli strumenti SAP hdbsql e hdbuserstore sono installati sull'istanza di calcolo che ospita l'agente.
  • La chiave hdbuserstore corrisponde a un'istanza SAP HANA specifica. Non puoi utilizzare chiavi che contengono gli hostname di più istanze SAP HANA.
  • L'utente SIDadm può eseguire query sul database SAP HANA utilizzando questa chiave. Qui SID si riferisce al valore specificato per il parametro sid. Puoi verificarlo eseguendo il seguente comando come utente SIDadm: 
    hdbsql -U HDB_USERSTORE_KEY "SELECT * FROM DUMMY"

Questo parametro di configurazione è supportato dalla versione 3.3 dell'agente.

Se specifichi hdbuserstore_key, puoi saltare la specifica dei parametri hostname e port.

Per l'autenticazione SAP HANA, l'agente utilizza il seguente ordine di preferenza: se specificato, il parametro di configurazione hdbuserstore_key è preferito rispetto al parametro hana_db_password, che è preferito rispetto al parametro hana_db_password_secret_name. Ti consigliamo di impostare una sola opzione di autenticazione nel file di configurazione.

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 la tua istanza SAP HANA. Di seguito sono riportati i valori supportati:

  • Se l'host è un computer locale, specifica la stringa localhost o l'indirizzo IP loopback 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 l'istanza SAP HANA accetta le query. Per la prima o l'unica istanza del database del 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 tu possa 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 parammetro 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.
hana_monitoring_configuration.enabled

Boolean

Facoltativo. Per consentire all'agente di Google Cloud per SAP di raccogliere le metriche di monitoraggio di SAP HANA, specifica true. Il valore predefinito è false.

I seguenti parametri secondari sono applicabili solo se specifichi hana_monitoring_configuration.enabled: true.
hana_monitoring_configuration.sample_interval_sec

Int

Facoltativo. Specifica l'intervallo di campionamento, in secondi, che determina la frequenza con cui l'agente di Google Cloud per SAP esegue query sulle tue istanze SAP HANA per raccogliere le metriche di monitoraggio di SAP HANA. Il valore predefinito è 300 secondi.

Per ogni query definita nel file di configurazione dell'agente di Google Cloud per SAP, puoi sovrascrivere l'intervallo di campionamento globale specificando l'intervallo richiesto al parametro sample_interval_sec. Gli intervalli di campionamento devono essere di almeno 5 secondi.
hana_monitoring_configuration.query_timeout_sec

Int

Facoltativo. Specifica il timeout per ogni query eseguita sulle istanze SAP HANA. Il valore predefinito è 300 secondi.
hana_monitoring_configuration.execution_threads

Int

Facoltativo. Specifica il numero di thread utilizzati per inviare query alle istanze SAP HANA. Ogni query viene eseguita in un proprio thread. Il valore predefinito è 10.
hana_monitoring_configuration.hana_instances.name

String

Specifica l'identificatore del nome per l'istanza SAP HANA.
hana_monitoring_configuration.hana_instances.sid

String

Specifica l'SID dell'istanza SAP HANA. Questa stringa viene aggiunta come etichetta a tutte le metriche risultanti dalla query delle istanze SAP HANA.
hana_monitoring_configuration.hana_instances.host

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 è un computer locale, specifica la stringa localhost o l'indirizzo IP loopback localhost, ad esempio 127.0.0.1.
  • Se l'host è una macchina remota, specifica il relativo indirizzo IP interno o esterno.
hana_monitoring_configuration.hana_instances.port

String

Specifica la porta su cui l'istanza SAP HANA accetta le query. Per la prima o l'unica istanza del database del tenant, la porta è 3NN15, dove NN è il numero di istanza dell'istanza SAP HANA.
hana_monitoring_configuration.hana_instances.user

String

Specifica l'account utente utilizzato per eseguire query sull'istanza SAP HANA.

Assicurati che questo utente abbia il privilegio di leggere le visualizzazioni di monitoraggio nel database SAP HANA. Se questo privilegio non viene concesso, le metriche di monitoraggio di SAP HANA relative alle viste di monitoraggio non contengono dati.
hana_monitoring_configuration.hana_instances.password

String

Facoltativo. Specifica la password, in testo normale, che autentica l'account utente per eseguire query sull'istanza SAP HANA.

Per l'autenticazione, devi specificare uno dei seguenti elementi:

  • La password in testo normale al parametro password.
  • (Consigliato) Se utilizzi Secret Manager per archiviare la password come secret, devi specificare il nome del secret corrispondente al parametro secret_name.
  • (Consigliato) Una chiave hdbuserstore per il parametro hdbuserstore_key.

Per l'autenticazione SAP HANA, l'agente utilizza il seguente ordine di preferenza: se specificato, il parametro di configurazione hdbuserstore_key è preferito rispetto al parametro password, che è preferito rispetto al parametro secret_name. Ti consigliamo di impostare una sola opzione di autenticazione nel file di configurazione.
hana_monitoring_configuration.hana_instances.secret_name

String

Facoltativo. Specifica il nome del segreto in Secret Manager che memorizza la password dell'account utente.

Per l'autenticazione SAP HANA, l'agente utilizza il seguente ordine di preferenza: se specificato, il parametro di configurazione hdbuserstore_key è preferito rispetto al parametro password, che è preferito rispetto al parametro secret_name. Ti consigliamo di impostare una sola opzione di autenticazione nel file di configurazione.
hana_monitoring_configuration.hana_instances.hdbuserstore_key

String

Per connetterti in sicurezza a un sistema SAP HANA, specifica una chiave Secure User Store (hdbuserstore) che hai creato per quel sistema.

Per utilizzare una chiave hdbuserstore per l'autenticazione, verifica quanto segue:

  • Gli strumenti SAP hdbsql e hdbuserstore sono installati sull'istanza di calcolo che ospita l'agente.
  • La chiave hdbuserstore corrisponde a un'istanza SAP HANA specifica. Non puoi utilizzare chiavi che contengono gli hostname di più istanze SAP HANA.
  • L'utente SIDadm può eseguire query sul database SAP HANA utilizzando questa chiave. Qui SID si riferisce al valore specificato per il parametro sid. Puoi verificarlo eseguendo il seguente comando come utente SIDadm: 
    hdbsql -U HDB_USERSTORE_KEY "SELECT * FROM DUMMY"

Questo parametro di configurazione è supportato dalla versione 3.3 dell'agente.

Se specifichi hdbuserstore_key, puoi saltare la specifica dei parametri host e port.
hana_monitoring_configuration.hana_instances.enable_ssl

Boolean

Facoltativo. Specifica se SSL è attivo o meno nell'istanza SAP HANA. Il valore predefinito è false.
hana_monitoring_configuration.hana_instances.host_name_in_certificate

String

Se specifichi enable_ssl: true per un'istanza SAP HANA, devi specificare il nome host impostato nel certificato SSL.
hana_monitoring_configuration.hana_instances.tls_root_ca_file

String

Se specifichi enable_ssl: true per un'istanza SAP HANA, devi specificare il percorso del certificato di sicurezza.
hana_monitoring_configuration.queries.enabled

Boolean

Facoltativo. Per attivare una query SQL per tutte le istanze SAP HANA, specifica il valore true per il parametro enabled per la query SQL.
hana_monitoring_configuration.queries.name

String

Se hai definito query personalizzate nel file di configurazione, devi specificare un nome univoco per ogni query personalizzata.

Il nome della query deve essere univoco perché viene utilizzato per creare l'URL predefinito della metrica in Monitoraggio.
hana_monitoring_configuration.queries.sql

String

Specifica l'istruzione SQL che l'agente emette alle tue istanze SAP HANA.

L'istruzione SQL deve essere conforme alla sintassi SQL definita da SAP nel SAP HANA SQL and System Views Reference.
hana_monitoring_configuration.queries.sample_interval_sec

Int

Facoltativo. Specifica l'intervallo di campionamento per la query SQL. Questo sostituisce l'intervallo di campionamento globale. Il valore deve essere almeno di 5 secondi.
hana_monitoring_configuration.queries.columns.name

String

Specifica un nome che identifichi in modo univoco ogni colonna.

Il nome della colonna deve essere univoco perché viene utilizzato per creare l'URL predefinito della metrica in Monitoraggio.
hana_monitoring_configuration.queries.columns.metric_type

String

Per la gestione da parte di Monitoring, specifica uno dei seguenti tipi di metrica: METRIC_LABEL, METRIC_GAUGE o METRIC_CUMULATIVE.

Le metriche di tipo METRIC_LABEL vengono aggiunte come etichette a tutte le metriche METRIC_GAUGE e METRIC_CUMULATIVE inviate a Monitoraggio.
hana_monitoring_configuration.queries.columns.value_type

String

Per la gestione da parte di Monitoraggio, specifica un tipo di dati supportato dal tipo di metrica.

I tipi di dati supportati sono: VALUE_BOOL, VALUE_INT64, VALUE_STRING o VALUE_DOUBLE. Per ulteriori informazioni, consulta Combinazione supportata.
hana_monitoring_configuration.queries.columns.name_override

String

Facoltativo. Per la gestione da parte di Monitoraggio, specifica il percorso da mostrare nell'URL della metrica anziché i nomi delle query e delle colonne. Ad esempio:

  • URL predefinito della metrica: workload.googleapis.com/sap/hanamonitoring/QUERY_NAME/COLUMN_NAME
  • URL metrica che utilizza il percorso personalizzato: workload.googleapis.com/sap/hanamonitoring/CUSTOM_PATH

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.