Installare e configurare l'agente per SAP di Google Cloud su un'istanza VM di Compute Engine

L'agente di Google Cloud per SAP è richiesto 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 per SAP di Google Cloud su un'istanza VM di 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 fornisce questi dati all'agente host SAP.

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

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

Per informazioni sui sistemi operativi supportati da Agent for SAP di Google Cloud, consulta Sistemi operativi supportati.

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

Panoramica dell'installazione

In Linux, l'agente per SAP di Google Cloud 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 la versione più recente dell'agente di Google Cloud per SAP.
Crea l'agente come servizio Linux systemd, denominato google-cloud-sap-agent.
Abilita e avvia il servizio google-cloud-sap-agent.

Su Windows, installa l'agente per SAP di Google Cloud utilizzando il comando di gestione dei pacchetti 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.

Avviso: non arrestare manualmente il servizio Windows o eliminare l'attività pianificata.

Prerequisiti per l'agente

Prima di installare l'agente 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'agente di Google Cloud per SAP deve includere i ruoli Visualizzatore Compute (roles/compute.viewer), Visualizzatore Monitoring (roles/monitoring.viewer) e Writer Workload Manager Insights (roles/workloadmanager.insightWriter).

Per aggiungere un ruolo obbligatorio al tuo account di servizio:

Nella console Google Cloud, vai alla pagina IAM.

Vai a IAM
Selezionare il tuo progetto Google Cloud.
Identifica l'account di servizio a cui vuoi aggiungere un ruolo.
- Se l'account di servizio non è già nell'elenco delle entità, non avrà alcun ruolo assegnato. Fai clic su Aggiungi e inserisci l'indirizzo email dell'account di servizio.
- Se l'account di servizio è già nell'elenco delle entità, ha ruoli esistenti. Fai clic sul pulsante Modifica per l'account di servizio che vuoi modificare.
Seleziona il ruolo richiesto dall'elenco di ruoli disponibili:
- Compute Engine > Visualizzatore Compute
- Monitoring > Visualizzatore Monitoring
- Gestore carichi di lavoro > Writer insight Gestore carichi di lavoro
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 VM 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 maggiori informazioni, consulta Creare una VM che utilizza un account di servizio gestito dall'utente.

Se limiti l'accesso alle API Cloud, l'agente per SAP di Google Cloud richiede i seguenti ambiti minimi di accesso all'API Cloud sull'istanza VM host:

Cloud Platform: abilitato
Compute Engine: sola lettura
API Stackdriver Monitoring: sola lettura

Se esegui applicazioni SAP su un'istanza VM che non ha un indirizzo IP esterno, devi abilitare l'accesso privato Google nella subnet della VM 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 Configurazione dell'accesso privato Google.

Installa l'agente

Per installare l'agente Google Cloud per SAP sulla tua istanza VM, seleziona il tuo sistema operativo, quindi completa i passaggi seguenti.

Linux

Per installare l'agente su un'istanza VM:

Stabilisci una connessione SSH all'istanza VM host.

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

(Consigliato) Per installare la versione 3.2 (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)-\$basearch
enabled=1
gpgcheck=1
repo_gpgcheck=1
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

SLES 15

sudo zypper addrepo --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

SLES 12

sudo zypper addrepo --refresh https://packages.cloud.google.com/yum/repos/google-cloud-sap-agent-sles12-\$basearch 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)-\$basearch
enabled=1
gpgcheck=1
repo_gpgcheck=1
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

SLES 15

sudo zypper addrepo --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-VERSION_NUMBER.x86_64

SLES 12

sudo zypper addrepo --refresh https://packages.cloud.google.com/yum/repos/google-cloud-sap-agent-sles12-\$basearch 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 disponibili dell'agente.

Windows

Per installare l'agente su un'istanza VM:

Utilizza RDP per la connessione all'istanza VM.

In qualità di amministratore, esegui questo 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 Google Cloud per SAP e l'agente host SAP, convalida l'installazione dell'agente Google Cloud per SAP, come descritto nella sezione Convalidare l'installazione dell'agente.

Convalida l'installazione dell'agente

Per verificare che l'agente sia in esecuzione, seleziona il sistema operativo, quindi segui questi passaggi:

Linux

Stabilisci una connessione SSH con la tua istanza VM host.

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

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

Nota: l'agente per SAP di Google Cloud include tutte le immagini "for SAP" di RHEL e 15 SP4 e versioni successive di SLES. Poiché le immagini SLES for SAP vengono aggiornate una volta a trimestre, è possibile che la versione dell'agente in bundle con queste immagini del sistema operativo non sia la più recente. I comandi seguenti aggiornano l'istanza dell'agente all'ultima versione fornita da Google Cloud.
```
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

Utilizza RDP per la connessione all'istanza VM.
In qualità di amministratore, esegui questo 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 stia ricevendo le metriche

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

Nel tuo sistema SAP, inserisci la transazione ST06.
Nel riquadro Panoramica, controlla la disponibilità e il contenuto dei seguenti campi per la corretta configurazione end-to-end dell'infrastruttura di monitoraggio SAP e Google:
- Cloud Provider: Google Cloud Platform
- Accesso a Monitoring avanzato: TRUE
- Dettagli sul monitoraggio avanzato: ACTIVE

Configura l'agente di Google Cloud per SAP su Linux

Dopo aver installato l'agente per SAP di Google Cloud, facoltativamente, puoi abilitare altre funzionalità dell'agente eseguendo le configurazioni seguenti. Per impostazione predefinita, è abilitata la raccolta di metriche dell'agente host SAP e metriche di valutazione di Workload Manager.

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

File di configurazione predefinito

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

{
  "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
  },
  "hana_monitoring_configuration": {
    "enabled": false
  }
}

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

Parametri di configurazione

La seguente tabella descrive i parametri di configurazione dell'agente per SAP di Google Cloud in esecuzione su una VM di Compute Engine, inclusi i parametri relativi alla raccolta di 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 richiesto dall'assistenza clienti Google Cloud o dall'Assistenza SAP.
`bare_metal`	`Boolean` Quando l'agente viene installato su un server Bare Metal Solution, specifica `true`. Il valore predefinito è `false`.
`log_level`	`String` Per impostare il livello di logging dell'agente, imposta il valore richiesto. I livelli di log disponibili sono i seguenti: `DEBUG` `INFO` `WARNING` `ERROR` Il valore predefinito è `INFO`. Non modificare il livello di logging a meno che non ti venga richiesto dall'assistenza clienti Google Cloud.
`log_to_cloud`	`Boolean` Per reindirizzare i log dell'agente a Cloud Logging, specifica `true`. Il valore predefinito è `true`.
`cloud_properties.project_id`	`String` Se il tuo sistema SAP è in esecuzione su un server Bare Metal Solution, specifica l'ID del progetto Google Cloud che stai utilizzando con Bare Metal Solution. Quando l'agente viene eseguito su un'istanza VM, per impostazione predefinita rileva automaticamente l'ID progetto.
`cloud_properties.instance_name`	`String` Specifica il nome dell'istanza VM di 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. Quando l'agente viene eseguito su un'istanza VM, per impostazione predefinita utilizza la regione dell'istanza VM in cui è installato.
`cloud_properties.zone`	`String` Per impostazione predefinita, quando l'agente viene eseguito su un'istanza VM utilizza la zona dell'istanza VM in cui è installato.
`cloud_properties.image`	`String` Specifica il nome dell'immagine del sistema operativo per l'istanza. Quando l'agente viene eseguito su un'istanza VM, per impostazione predefinita rileva l'immagine del sistema operativo dell'istanza VM su cui è installato.
`cloud_properties.numeric_project_id`	`String` Specifica l'ID numerico del progetto Google Cloud in cui è in esecuzione il sistema SAP. Quando l'agente viene eseguito su un'istanza VM, per impostazione predefinita rileva automaticamente l'ID progetto numerico.
`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 di `google-cloud-sap-agent` 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 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 monitoraggio dei processi, specifica `true`. Il valore predefinito è `false`. Questo parametro è applicabile solo a Linux. Se abiliti la raccolta delle metriche di elaborazione per SAP HANA, devi configurare parametri aggiuntivi elencati in `hana_metrics_config`.
`collection_configuration.process_metrics_frequency`	`Int` Dalla versione 2.6, questo parametro determina la frequenza di raccolta in secondi delle metriche di monitoraggio dei processi in rapida evoluzione. Le metriche di monitoraggio dei processi in rapida evoluzione 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 lenta modifica) vengono raccolte con una frequenza predefinita di 30 secondi. Per modificare la frequenza di raccolta delle metriche di monitoraggio dei processi che cambiano 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 in lenta modifica, in secondi. Il valore predefinito di questo parametro è di `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 su SAP HANA. Il valore predefinito è `SYSTEM`.
`collection_configuration.hana_metrics_config.hana_db_password`	`String` Specifica la password in testo normale per l'account utente del database che l'agente utilizza per eseguire query su SAP HANA. Anziché utilizzare una password in testo normale, ti consigliamo di utilizzare un secret in Secret Manager specificando il nome del secret in `hana_db_password_secret_name`. Non specificare una password se utilizzi Secret Manager per archiviare le credenziali utente del database. Quando nella configurazione sono specificati entrambi i criteri `hana_db_password` e `hana_db_password_secret_name`, viene attivato un errore e l'agente non può connettersi al database.
`collection_configuration.hana_metrics_config.hana_db_password_secret_name`	`String` Per fornire in modo sicuro la password per l'account utente del database che l'agente utilizza per eseguire query su SAP HANA, specifica il nome del secret che contiene le credenziali di sicurezza per l'account utente del database. Le metriche relative a SAP HANA vengono raccolte solo se è impostata l'opzione `hana_db_password_secret_name` o `hana_db_password`. Importante: il secret e l'istanza VM host devono esistere nello stesso progetto Google Cloud.
`collection_configuration.collect_workload_validation_metrics`	`Boolean` Per abilitare la raccolta delle metriche di valutazione del Gestore carichi di lavoro, specifica `true`. Dalla versione 3.2, il valore predefinito è `true`. Questo parametro è applicabile solo a Linux.
`collection_configuration.workload_validation_metrics_frequency`	`Int` La frequenza di raccolta delle metriche di valutazione del Gestore carichi di lavoro in secondi. Il valore predefinito è `300` secondi. Ti consigliamo di non modificare la frequenza di raccolta predefinita, in quanto potrebbe influire sull'intera funzionalità. Se devi modificare la frequenza di raccolta delle metriche del Gestore carichi di lavoro, aggiungi il parametro `workload_validation_metrics_frequency` nella sezione `collection_configuration` e fornisci il valore richiesto.
`collection_configuration.workload_validation_collection_definition.fetch_latest_config`	`Boolean` Facoltativo. Il valore predefinito è `true`, che consente all'agente di raccogliere il set più recente di metriche di valutazione del Gestore carichi di lavoro senza che sia necessario aggiornare l'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_secret_name`	`String` Specifica il nome del secret in Secret Manager in cui è archiviata la password dell'account utente.
`collection_configuration.workload_validation_db_metrics_config.hostname`	`String` Specifica l'identificatore della macchina, locale o remota, che ospita la tua istanza SAP HANA. Di seguito sono riportati i valori supportati: Se l'host è una macchina locale, specifica la stringa `localhost` o l'indirizzo IP di loopback del localhost, ad esempio `127.0.0.1`. Se l'host è una macchina remota, specifica il relativo indirizzo IP interno o esterno.
`collection_configuration.workload_validation_db_metrics_config.port`	`String` Specifica la porta su cui la tua istanza SAP HANA accetta le query. Per la prima o la sola istanza di database tenant, la porta è `3NN15`, dove `NN` è il numero di istanza dell'istanza SAP HANA.
`collection_configuration.workload_validation_db_metrics_frequency`	`Int` La frequenza di raccolta delle metriche del database SAP HANA, in secondi, per la valutazione di Workload Manager. Il valore predefinito è `3600` secondi. Anche se puoi aggiornare la frequenza di raccolta delle metriche del database SAP HANA, ti consigliamo di utilizzare il valore predefinito. Se devi modificare il valore predefinito, aggiungi il parametro `workload_validation_db_metrics_frequency` nella sezione `collection_configuration` e fornisci il valore richiesto. Assicurati di non impostare una frequenza di raccolta superiore a `3600` secondi.
`hana_monitoring_configuration.enabled`	`Boolean` Facoltativo. Per consentire all'agente di Google Cloud per SAP di raccogliere le metriche di monitoraggio 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 per SAP di Google Cloud 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 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 avere una durata minima di 5 secondi.
`hana_monitoring_configuration.query_timeout_sec`	`Int` Facoltativo. Specifica il timeout per ogni query effettuata alle 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.hana_instances.name`	`String` Specifica l'identificatore del nome per l'istanza SAP HANA.
`hana_monitoring_configuration.hana_instances.sid`	`String` Specifica il SID della tua istanza SAP HANA. Questa stringa viene aggiunta come etichetta a tutte le metriche risultanti dalle query sulle tue 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 è una macchina locale, specifica la stringa `localhost` o l'indirizzo IP di loopback del localhost, ad esempio `127.0.0.1`. Se l'host è una macchina remota, specifica il relativo indirizzo IP interno o esterno.
`hana_monitoring_configuration.hana_instances.port`	`String` Specifica la porta su cui la tua istanza SAP HANA accetta le query. Per la prima o la sola istanza di database tenant, la porta è `3NN15`, dove `NN` è il numero di istanza dell'istanza SAP HANA.
`hana_monitoring_configuration.hana_instances.user`	`String` Specifica l'account utente utilizzato per eseguire query sull'istanza SAP HANA.
`hana_monitoring_configuration.hana_instances.password`	`String` Facoltativo. Specifica la password, come testo normale, che autentica l'account utente per le query sull'istanza SAP HANA. Per attivare l'autenticazione, devi specificare una delle seguenti opzioni: 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 per il parametro `secret_name`. Se utilizzi entrambi i parametri, viene utilizzato il parametro `password`.
`hana_monitoring_configuration.hana_instances.secret_name`	`String` Facoltativo. Specifica il nome del secret in Secret Manager in cui è archiviata la password dell'account utente.
`hana_monitoring_configuration.hana_instances.enable_ssl`	`Boolean` Facoltativo. Specifica se SSL è abilitato o meno nella tua 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 per il certificato di sicurezza.
`hana_monitoring_configuration.queries.enabled`	`Boolean` Facoltativo. Per abilitare una query SQL per tutte le tue istanze SAP HANA, specifica il valore `true` per il parametro `enabled` per la query SQL specifica.
`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.sql`	`String` Specifica l'istruzione SQL inviata dall'agente alle tue istanze SAP HANA. L'istruzione SQL deve essere conforme alla sintassi SQL definita da SAP nel documento SAP HANA SQL and System Views.
`hana_monitoring_configuration.queries.sample_interval_sec`	`Int` Facoltativo. Specifica l'intervallo di esempio per la query SQL. Questa operazione sostituisce l'intervallo di campionamento globale. Il valore deve durare almeno 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 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 maggiori informazioni, consulta la sezione Combinazione supportata.
`hana_monitoring_configuration.queries.columns.name_override`	`String` Facoltativo. Per la gestione da parte di Monitoring, specifica il percorso da visualizzare nell'URL della metrica anziché i nomi della query e della colonna. 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 sulla risoluzione dei problemi che potresti riscontrare durante l'installazione e la configurazione di Agent for SAP di Google Cloud, consulta la guida alla risoluzione dei problemi di Google Cloud Agent for SAP.

Richiedere assistenza

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