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:

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'ultima versione dell'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

Per installare l'agente per SAP di Google Cloudsu un server Bare Metal Solution, segui questi passaggi:

  1. Stabilisci una connessione SSH al server Bare Metal Solution.

  2. Nel terminale, installa l'agente eseguendo il comando specifico per il tuo sistema operativo:

    • (Consigliato) Per installare la versione 3.8 (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 Elenca tutte le versioni disponibili dell'agente.

  3. Apri il seguente file di configurazione:

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

    In alternativa, puoi eseguire questa configurazione anche eseguendo comandi. Per maggiori informazioni, vedi Comandi di configurazione per l'agente per SAP di Google Cloud.

  4. Modifica o aggiungi i seguenti parametri al file di configurazione:

    • Nella prima sezione:
      • bare_metal: impostato su true.
    • Aggiungi la sezione cloud_properties e specifica i seguenti parametri:
      • project_id: specifica il tuo Google Cloud progetto
      • instance_name: specifica il nome del server Bare Metal Solution
      • region: specifica la regione del server Bare Metal Solution

  5. Salva il file di configurazione.

  6. Riavvia l'agente:

    sudo systemctl restart google-cloud-sap-agent
Per ulteriori informazioni sui parametri di configurazione, consulta Parametri di configurazione ed esempio di configurazione.

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 per SAP di Google Cloud, puoi facoltativamente attivare altre funzionalità dell'agente eseguendo le seguenti configurazioni. Per impostazione predefinita, la raccolta delle metriche dell'agente host SAP e delle metriche di valutazione di Workload Manager è abilitata.

Prerequisiti

Per consentire all'agente di accedere alle risorse Google Cloud da un ambiente Bare Metal Solution, 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, il service account utilizzato dall'agente deve includere il ruolo Workload Manager Insights Writer (roles/workloadmanager.insightWriter).

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 Workload Manager > Workload Manager Insights Writer role to the service account.

      To grant the role, find the Select a role list, then select Workload Manager > Workload Manager Insights 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.

Dopo aver creato il account di servizio, assicurati di caricare il file della chiave JSON in una posizione sicura sul server Bare Metal Solution accessibile all'agente.

Abilita le funzionalità

Dopo aver configurato un account di servizio per Bare Metal Solution e avergli concesso i ruoli richiesti, puoi attivare altre funzionalità dell'agente per SAP di Google Cloudeseguendo le seguenti configurazioni:

File di configurazione predefinito

Lo snippet seguente è un esempio della configurazione predefinita della versione 3.8 (la più recente) dell'agente per SAP di Google Cloud:

{
  "provide_sap_host_agent_metrics": true,
  "bare_metal": true,
  "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 le funzionalità, consulta la guida alla configurazione per la funzionalità in questione.

Parametri di configurazione

La tabella seguente descrive i parametri di configurazione dell'agente per SAP diGoogle Cloudin esecuzione su un server Bare Metal Solution, inclusi i parametri relativi alla raccolta delle metriche. Per informazioni sui parametri di configurazione relativi alla funzionalità Backint dell'agente, vedi Parametri di configurazione.

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_name

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.
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 maggiori informazioni, consulta il codebase dell'agente nel repository GitHub google-cloud-sap-agent all'indirizzo 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 archivia 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 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

A partire dalla versione 2.6, questo parametro determina la frequenza di raccolta delle metriche di monitoraggio dei processi a variazione rapida, in secondi. Le metriche di monitoraggio dei processi che cambiano rapidamente sono: sap/hana/availability, sap/hana/ha/availability e sap/nw/availability.

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

Tutte le altre metriche di monitoraggio dei processi (a variazione lenta) vengono raccolte a una frequenza predefinita di 30 secondi. Per modificare la frequenza di raccolta delle metriche di monitoraggio dei processi a variazione lenta, 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 a variazione lenta, in secondi.

Il valore predefinito di 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 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:

Per l'autenticazione SAP HANA, l'agente utilizza il seguente ordine di preferenza: se specificato, il parametro di configurazione hdbuserstore_key ha la precedenza sul parametro hana_db_password, che ha la precedenza sul 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 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, 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 ha la precedenza sul parametro hana_db_password, che ha la precedenza sul 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 modo sicuro 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, assicurati che:

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

Questo parametro di configurazione è supportato a partire 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 ha la precedenza sul parametro hana_db_password, che ha la precedenza sul 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 l'autenticazione a SAP HANA, consulta la sezione hdbuserstore_key.

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_collection_definition.fetch_latest_config

Boolean

Facoltativo. Il valore predefinito è true, che consente all'agente di raccogliere l'ultimo insieme di metriche di valutazione del Gestore workload senza richiedere l'aggiornamento dell'agente. 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 ha la precedenza sul parametro hana_db_password, che ha la precedenza sul 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 secret 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 ha la precedenza sul parametro hana_db_password, che ha la precedenza sul 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 modo sicuro 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, assicurati che:

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

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

Se specifichi hdbuserstore_key, puoi evitare di specificare i 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 ha la precedenza sul parametro hana_db_password, che ha la precedenza sul 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 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.
hana_monitoring_configuration.enabled

Boolean

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

I seguenti parametri secondari sono applicabili solo quando 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 per SAP di Google Cloudesegue query sulle istanze SAP HANA per raccogliere le metriche di monitoraggio SAP HANA. Il valore predefinito è 300 secondi.

Per ogni query definita nel file di configurazione dell'agente per SAP di Google Cloud, puoi sovrascrivere l'intervallo di campionamento globale specificando l'intervallo richiesto per il 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 sul proprio thread. Il valore predefinito è 10.
hana_monitoring_configuration.send_query_response_time

Boolean

Facoltativo. Specifica true per fare in modo che l'agente acquisisca il tempo di risposta per ogni query di monitoraggio SAP HANA definita nel file di configurazione dell'agente.
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 dall'interrogazione delle tue istanze SAP HANA.
hana_monitoring_configuration.hana_instances.host

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.
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 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 disponga del privilegio di leggere le viste di monitoraggio nel tuo database SAP HANA. Se questo privilegio non viene concesso, le metriche di monitoraggio SAP HANA correlate alle viste di monitoraggio non contengono dati.
hana_monitoring_configuration.hana_instances.password

String

Facoltativo. Specifica la password, come testo normale, che autentica l'account utente per l'interrogazione dell'istanza SAP HANA.

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

  • La password in testo normale per il 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 ha la precedenza sul parametro password, che ha la precedenza sul 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 secret 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 ha la precedenza sul parametro password, che ha la precedenza sul 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 modo sicuro 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, assicurati che:

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

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

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

Boolean

Per il monitoraggio dei sistemi HA, specifica true per indicare all'agente che l'istanza SAP HANA definita è ospitata sulla stessa istanza Compute Engine dell'agente. L'agente controlla in fase di runtime se l'istanza SAP HANA definita è il nodo primario o secondario nel sistema HA. L'agente richiede questa consapevolezza per eseguire le query di monitoraggio SAP HANA sul tipo di istanza SAP HANA che specifichi per il parametro queries.run_on.

Il valore predefinito di questo parametro è false, che fa sì che l'agente esegua tutte le query di monitoraggio SAP HANA abilitate sull'istanza SAP HANA corrispondente. Per ulteriori informazioni, consulta Monitoraggio per sistemi multitenant e ad alta disponibilità.

Questo parametro è supportato a partire dalla versione 3.7 dell'agente.
hana_monitoring_configuration.hana_instances.instance_num

String

Specifica il numero di istanza che hai impostato per l'istanza SAP HANA. Queste informazioni sono necessarie all'agente per rilevare l'istanza SAP HANA.

Questo parametro è supportato a partire dalla versione 3.7 dell'agente.
hana_monitoring_configuration.hana_instances.queries_to_run.run_all

Boolean

Facoltativo. Specifica true per eseguire tutte le query di monitoraggio di SAP HANA, predefinite e personalizzate, abilitate nel file di configurazione dell'agente nell'istanza SAP HANA specificata. Il valore predefinito è false.
hana_monitoring_configuration.hana_instances.queries_to_run.query_name

String

Facoltativo. Specifica le query che vuoi eseguire sull'istanza SAP HANA specificata.

Se esegui un database SAP HANA multi-tenant, puoi configurare il monitoraggio specifico del tenant utilizzando questo parametro di configurazione. Nella seguente configurazione di esempio, vengono eseguite due query su HANA_TENANT_1 e tutte le query definite nella configurazione vengono eseguite su HANA_TENANT_2:

    "hana_instances": [
      {
        "name": "HANA_TENANT_1,
        "queries_to_run": {
          "query_name": ["QUERY_NAME_1", "QUERY_NAME_2"]
        }
      },
      {
        "name": "HANA_TENANT_2,
        "queries_to_run": {
          "run_all": true
        }
      }
      ...
    ]
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 quella 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 Monitoring.
hana_monitoring_configuration.queries.run_on

String

Facoltativo. Specifica questo parametro se monitori un sistema SAP HANA HA e vuoi eseguire le query di monitoraggio SAP HANA sul nodo primario o secondario. Valori supportati: PRIMARY, SECONDARY, ALL. Quando specifichi il valore ALL, l'agente esegue le query di monitoraggio SAP HANA sia sui nodi primario che secondario del cluster HA.

Questo parametro è supportato a partire dalla versione 3.7 dell'agente. Inoltre, per eseguire le query sul nodo secondario, assicurati che il sistema HA sia implementato con la configurazione Attivo/Attivo (lettura abilitata).

hana_monitoring_configuration.queries.sql

String

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

L'istruzione SQL deve essere conforme alla sintassi SQL definita da SAP in 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. Questa impostazione sostituisce l'intervallo di campionamento globale. Il valore deve essere di 5 secondi o più.
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 Monitoring.
hana_monitoring_configuration.queries.columns.metric_type

String

Per la gestione da parte di Monitoring, specifica uno dei seguenti tipi di metriche: 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 Monitoring.
hana_monitoring_configuration.queries.columns.value_type

String

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

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

String

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

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

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.