Questa pagina è stata tradotta dall'API Cloud Translation.

Installa e configura l'agente di Google Cloud per SAP su un'istanza VM di 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 Agent for SAP di Google Cloud su una VM di Compute Engine per le metriche di SAP Host Agent, combina i dati di monitoraggio di Cloud Monitoring e alle API Compute Engine e fornisce questi dati al SAP Host Agent.

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

RHEL: tutto "per SAP" immagini
SLES: SLES 15 SP4 per SAP e versioni successive

Per informazioni sui sistemi operativi 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 l'ultima versione dell'agente di Google Cloud per SAP.
Crea l'agente come servizio systemd Linux denominato google-cloud-sap-agent.
Abilita e avvia il servizio google-cloud-sap-agent.

Su Windows, puoi installare l'agente di Google Cloud per SAP utilizzando il 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.

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

Prerequisiti per l'agente

Prima di installare l'agente di Google Cloud per SAP, devi assicurarti che sono 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 al tuo account di servizio, segui questi passaggi:

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à presente nell'elenco delle entità, non sono stati assegnati ruoli. Fai clic su Aggiungi e inserisci all'indirizzo email dell'account di servizio.
- Se l'account di servizio è già nell'elenco delle entità, allora ha account ruoli. Fai clic sul pulsante Modifica per l'account di servizio che desideri modificare.
Seleziona il ruolo richiesto dall'elenco dei ruoli disponibili:
- Compute Engine > Visualizzatore Compute
- Monitoraggio > Visualizzatore Monitoring
- Workload Manager > Workload Manager Insights Writer
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 ulteriori 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 di accesso minimi alle API Cloud nell'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 per SAP di Google Cloud 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 sulla tua istanza VM, seleziona il sistema operativo sistema, quindi completa i seguenti passaggi.

Linux

Per installare l'agente in 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.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 la versione dell'agente numero da 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 VM:

Utilizza RDP per la connessione all'istanza VM.

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 quindi segui questi passaggi:

Linux

Stabilisci una connessione SSH di un'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

Per le immagini SLES, per assicurarti di utilizzare l'ultima versione con l'agente Google Cloud per SAP, esegui questi comandi.

Nota: l'agente di Google Cloud per SAP è in bundle con tutte le immagini "for SAP" di RHEL e con le versioni 15 SP4 e successive di SLES. Poiché lo strumento SLES for SAP le immagini vengono aggiornate una volta al trimestre, è possibile che la versione in bundle con quelle immagini del sistema operativo non è quella più recente. I comandi riportati di seguito aggiornare l'istanza dell'agente alla versione più recente fornita su 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 connetterti all'istanza VM.
Come amministratore, esegui il comando seguente da PowerShell:
```
$(Get-Service -Name 'google-cloud-sap-agent' -ErrorAction Ignore).Status
```
Se l'agente è in esecuzione, lo stato è Running.

Se l'agente non è in esecuzione, riavvialo.

Verifica che l'agente host SAP stia ricevendo 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:

Nel sistema SAP, inserisci la transazione ST06.
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 a monitoraggio avanzato: TRUE
- Dettagli sul monitoraggio avanzato: ACTIVE

Configurare l'agente di Google Cloud per SAP su Linux

Dopo aver installato l'agente per SAP di Google Cloud, facoltativamente, puoi abilitare altre delle funzionalità dell'agente eseguendo le configurazioni riportate di seguito. Per impostazione predefinita, la raccolta Metriche dell'agente host SAP e le metriche di valutazione di Workload Manager sia abilitato.

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

File di configurazione predefinito

Lo snippet che segue è un esempio della configurazione predefinita di versione 3.6 (più recente) dell'agente 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 per SAP di Google Cloud in esecuzione su una VM Compute Engine, 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 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 è 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: specificare l'ID del progetto Google Cloud che stai con Bare Metal Solution. Quando l'agente viene eseguito su un'istanza VM, per impostazione predefinita rileva automaticamente l'ID progetto.
`cloud_properties.instance_name`	`String` Specifica il nome della tua 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 dell'istanza VM su cui è installato l'agente.
`cloud_properties.zone`	`String` Quando l'agente viene eseguito su un'istanza VM, per impostazione predefinita utilizza la zona dell'istanza VM su cui è installato.
`cloud_properties.image`	`String` Specifica il nome dell'immagine del sistema operativo dell'istanza. Quando l'agente viene eseguito su un'istanza VM, per impostazione predefinita rileva 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 che il sistema SAP è in esecuzione. Quando l'agente viene eseguito su un'istanza VM, per impostazione predefinita rileva automaticamente un 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 ulteriori informazioni, controlla il codebase dell'agente nella `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 per Linux. Se abiliti la raccolta delle metriche di processo per SAP HANA, devi configurare parametri aggiuntivi elencati in `hana_metrics_config`.
`collection_configuration.process_metrics_frequency`	`Int` 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 le metriche di Process Monitoring che cambiano lentamente, usa il parametro `slow_process_metrics_frequency`.
`collection_configuration.slow_process_metrics_frequency`	`Int` Specifica la frequenza di raccolta del metriche di Process Monitoring che cambiano lentamente, in pochi secondi. Il valore predefinito di questo parametro è `30` secondi.
`collection_configuration.process_metrics_to_skip`	`Array` Specifica Metriche di monitoraggio dei processi che non vuoi vengano raccolte dall'agente. Questo parametro accetta un parametro valore separato da virgole dei nomi delle metriche di Process Monitoring. 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. Invece di specificare una password in testo normale, ti consigliamo di utilizzare una delle seguenti opzioni: `hana_db_password_secret_name`, per il quale specifichi un segreto archiviato in Secret Manager. `hdbuserstore_key`, per la quale specifichi una chiave `hdbuserstore`. 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`. Me ti consigliamo di impostare una sola opzione di autenticazione nella 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. Importante: il secret e l'istanza VM host devono esistere nella lo stesso progetto Google Cloud. 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 specificata, la configurazione `hdbuserstore_key` è preferibile utilizzare il parametro `hana_db_password`, che è preferibile 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 modo sicuro a un sistema SAP HANA, specifica un Chiave di archivio utenti sicuro (`hdbuserstore`) che hai creato di un sistema operativo completo. 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 specificata, la configurazione `hdbuserstore_key` è preferibile utilizzare il parametro `hana_db_password`, che è preferibile al parametro `hana_db_password_secret_name`. Me ti consigliamo di impostare una sola opzione di autenticazione nella configurazione .
`collection_configuration.hana_metrics_config.sid`	`String` Specifica il SID della tua istanza SAP HANA. Se utilizzi una chiave `hdbuserstore` per l'autenticazione in SAP HANA, quindi fai riferimento 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 del Gestore carichi di lavoro le metriche di valutazione in pochi 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 del le metriche di Gestore carichi di lavoro, quindi aggiungi `workload_validation_metrics_frequency` nella sezione `collection_configuration` e fornisci il valore richiesto.
`collection_configuration.workload_validation_collection_definition.fetch_latest_config`	`Boolean` Facoltativo. Il valore predefinito è `true` e consente all'agente per raccogliere l'ultimo set di valutazioni del Gestore carichi di lavoro senza dover 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 SAP HANA.
`collection_configuration.workload_validation_db_metrics_config.hana_db_password`	`String` Specifica la password per l'account utente utilizzato per eseguire query sul 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 modo sicuro a un sistema SAP HANA, specifica un Chiave di archivio utenti sicuro (`hdbuserstore`) che hai creato di un sistema operativo completo. 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 specificata, la configurazione `hdbuserstore_key` è preferibile utilizzare il parametro `hana_db_password`, che è preferibile 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 il SID della tua istanza SAP HANA.
`collection_configuration.workload_validation_db_metrics_config.hostname`	`String` Specifica l'identificatore della macchina, locale o remota, che che ospita la tua istanza SAP HANA. Di seguito sono riportati i valori supportati: Se l'host è un computer locale, specifica la stringa `localhost` o l'indirizzo IP loopback localhost, ad esempio `127.0.0.1`. Se l'host è un computer remoto, specifica il suo interno all'indirizzo IP esterno.
`collection_configuration.workload_validation_db_metrics_config.port`	`String` Specifica la porta su cui la tua istanza SAP HANA accetta le query. Per la prima o l'unica istanza di database tenant, la porta `3NN15`, dove `NN` è il numero di istanza dell'istanza SAP HANA.
`collection_configuration.workload_validation_db_metrics_frequency`	`Int` La frequenza di raccolta delle metriche del database SAP HANA, in secondi, per la valutazione 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 maggiore di `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 al 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 la tua istanza SAP HANA.
`hana_monitoring_configuration.hana_instances.sid`	`String` Specifica il SID della tua istanza SAP HANA. Questa stringa viene aggiunta come a tutte le metriche risultanti dall'esecuzione di 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 è un computer locale, specifica la stringa `localhost` o l'indirizzo IP loopback localhost, ad esempio `127.0.0.1`. Se l'host è un computer remoto, specifica il suo interno all'indirizzo IP 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 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 viste di monitoraggio nel tuo database SAP HANA. Se questo privilegio non viene concesso, il team SAP Le metriche di monitoraggio HANA relative alle viste di monitoraggio non contengono dati.
`hana_monitoring_configuration.hana_instances.password`	`String` Facoltativo. Specifica la password, in testo normale, che esegue l'autenticazione l'account utente per eseguire query sull'istanza SAP HANA. Per 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 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 specificata, la configurazione `hdbuserstore_key` è preferibile utilizzare il parametro `password`, che è preferibile 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 secret in Secret Manager in cui è archiviata la password dell'account utente. Per l'autenticazione SAP HANA, l'agente utilizza il seguente ordine di preferenza: se specificata, la configurazione `hdbuserstore_key` è preferibile utilizzare il parametro `password`, che è preferibile al parametro `secret_name`. Me ti consigliamo di impostare una sola opzione di autenticazione nella configurazione .
`hana_monitoring_configuration.hana_instances.hdbuserstore_key`	`String` Per connetterti in modo sicuro a un sistema SAP HANA, specifica un Chiave di archivio utenti sicuro (`hdbuserstore`) che hai creato di un sistema operativo completo. 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 che specifica i parametri `host` e `port`.
`hana_monitoring_configuration.hana_instances.enable_ssl`	`Boolean` Facoltativo. Specifica se SSL è abilitato o meno in SAP HANA in esecuzione in un'istanza Compute Engine. Il valore predefinito è `false`.
`hana_monitoring_configuration.hana_instances.host_name_in_certificate`	`String` Se specifichi `enable_ssl: true` per un SAP HANA istanza, devi specificare il nome host impostato nella certificato.
`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 abilitare una query SQL per tutte le tue 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 il predefinito della metrica in Monitoring.
`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 esempio 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 tramite Monitoring, specifica percorso che vuoi 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 problemi che potresti incontrati quando installi e configuri l'agente di Google Cloud per SAP, consulta Guida alla risoluzione dei problemi di Agent for SAP di Google Cloud.

Assistenza

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