Questa pagina è stata tradotta dall'API Cloud Translation.

Installare e configurare l'agente di Google Cloud per SAP su un server Bare Metal Solution

L'agente di Google Cloud per SAP è necessario per l'assistenza SAP dei sistemi SAP in esecuzione su un server Bare Metal Solution.

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

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

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

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

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

Panoramica dell'installazione

L'agente di Google Cloud per SAP viene installato utilizzando i comandi di gestione dei pacchetti del sistema operativo standard: su RHEL, il comando yum; su SLES, il comando zypper. Il comando di gestione dei pacchetti completa le seguenti attività:

Scarica la versione più recente dell'agente di Google Cloud per SAP.
Crea l'agente come servizio systemd Linux denominato google-cloud-sap-agent.
Attiva e avvia il servizio google-cloud-sap-agent.

Installa l'agente

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

Stabilisci una connessione SSH al server Bare Metal Solution.

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

(Consigliato) Per installare la versione 3.6 (la più recente) dell'agente:

RHEL

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

SLES15

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

SLES 12

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

Per installare una versione specifica dell'agente:

RHEL

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

SLES15

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

SLES 12

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

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

Apri il seguente file di configurazione:
```
/etc/google-cloud-sap-agent/configuration.json
```
In alternativa, puoi eseguire questa configurazione anche tramite comandi. Per ulteriori informazioni, consulta Comandi di configurazione per l'agente di Google Cloud per SAP.
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 progetto Google Cloud
  - instance_name: specifica il nome del server Bare Metal Solution
  - region: specifica la regione del server Bare Metal Solution
Salva il file di configurazione.

Riavvia l'agente:

sudo systemctl restart google-cloud-sap-agent

Per ulteriori informazioni sui parametri di configurazione, consulta Parametri di configurazione e configurazione di esempio.

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

Stabilisci una connessione SSH con il server Bare Metal Solution.

Esegui questo comando:

systemctl status google-cloud-sap-agent

Se l'agente funziona correttamente, l'output contiene active (running). Ad esempio:

google-cloud-sap-agent.service - Google Cloud Agent for SAP
Loaded: loaded (/usr/lib/systemd/system/google-cloud-sap-agent.service; enabled; vendor preset: disabled)
Active:  active (running)  since Fri 2022-12-02 07:21:42 UTC; 4 days ago
Main PID: 1337673 (google-cloud-sa)
Tasks: 9 (limit: 100427)
Memory: 22.4 M (max: 1.0G limit: 1.0G)
CGroup: /system.slice/google-cloud-sap-agent.service
       └─1337673 /usr/bin/google-cloud-sap-agent

Se l'agente non è in esecuzione, riavvialo.

Verificare che l'agente host SAP riceva le metriche

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

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 al monitoraggio avanzato: TRUE
- Dettagli sul monitoraggio migliorato: ACTIVE

Configurare l'agente di Google Cloud per SAP su Linux

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

Prerequisiti

Per consentire all'agente di accedere alle risorse Google Cloud da un ambiente per Bare Metal Solution, devi completare i seguenti prerequisiti:

Crea un account di servizio IAM per consentire all'agente di accedere alle risorse Google Cloud, quindi concedi all'account di servizio i ruoli IAM richiesti. Per maggiori dettagli, consulta Configurare un account di servizio.
Sul server Bare Metal Solution, installa gcloud CLI. Per informazioni dettagliate, consulta Installare gcloud CLI.
Per accedere a Google Cloud, autorizza gcloud CLI. Per maggiori dettagli, consulta Autorizzare gcloud CLI.
Stabilisci la connessione alle API Google Cloud. Per maggiori dettagli, consulta la sezione Configurare l'accesso privato Google per gli host on-premise.

Configurare un account di servizio

Per consentire all'agente di accedere alle risorse di Google Cloud da un ambiente Bare Metal Solution, devi configurare un account di servizio IAM.

Come minimo, l'account di servizio utilizzato dall'agente deve includere il ruolo Workload Manager Insights Writer (roles/workloadmanager.insightWriter).

Per creare un account di servizio:

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.
  
  Note: The Role field affects which resources the service account can access in your project. You can revoke these roles or grant additional roles later.
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.
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 l'account di servizio, assicurati di caricare il relativo 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 la tua Bare Metal Solution e avergli assegnato i ruoli richiesti, puoi attivare altre funzionalità dell'agente di Google Cloud per SAP eseguendo le seguenti configurazioni:

File di configurazione predefinito

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

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

Parametri di configurazione

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

Parametri
`provide_sap_host_agent_metrics`	`Boolean` Per abilitare la raccolta delle metriche richieste dall'agente host SAP, specifica `true`. Il valore predefinito è `true`. Non impostare `provide_sap_host_agent_metrics` su `false` a meno che non ti venga indicato dall'assistenza clienti Google Cloud o dall'assistenza SAP.
`bare_metal`	`Boolean` Quando l'agente è installato su un server Bare Metal Solution, specifica `true`. Il valore predefinito è `false`.
`log_level`	`String` Per impostare il livello di logging dell'agente, imposta il valore richiesto. I livelli di log disponibili sono i seguenti: `DEBUG` `INFO` `WARNING` `ERROR` Il valore predefinito è `INFO`. Non modificare il livello di logging, a meno che non ti venga indicato dall'assistenza clienti Google Cloud.
`log_to_cloud`	`Boolean` Per reindirizzare i log dell'agente a Cloud Logging, specifica `true`. Il valore predefinito è `true`.
`cloud_properties.project_id`	`String` Se il sistema SAP è in esecuzione su un server Bare Metal Solution, specifica l'ID progetto del progetto Google Cloud che utilizzi con Bare Metal Solution. Per impostazione predefinita, quando l'agente viene eseguito su un'istanza Compute Engine, rileva automaticamente l'ID progetto.
`cloud_properties.instance_name`	`String` Specifica il nome del server Bare Metal Solution su cui hai installato l'agente.
`cloud_properties.region`	`String` Se il sistema SAP è in esecuzione su un server Bare Metal Solution, specifica la regione del server Bare Metal Solution. Per impostazione predefinita, quando l'agente viene eseguito su un'istanza di calcolo, utilizza la regione in cui è stato eseguito il deployment dell'istanza.
`cloud_properties.zone`	`String` Quando l'agente viene eseguito su un'istanza di calcolo, per impostazione predefinita utilizza la zona in cui è dipiattaforma l'istanza di calcolo.
`cloud_properties.image`	`String` Specifica il nome dell'immagine del sistema operativo dell'istanza. Quando l'agente viene eseguito su un'istanza di calcolo, per impostazione predefinita rileva automaticamente l'immagine del sistema operativo utilizzata dall'istanza di calcolo.
`cloud_properties.numeric_project_id`	`String` Specifica l'ID numerico del progetto Google Cloud in cui è in esecuzione il sistema SAP. Quando l'agente viene eseguito su un'istanza di calcolo, per impostazione predefinita rileva automaticamente il numero del progetto.
`discovery_configuration.enable_workload_discovery`	`Boolean` Per consentire all'agente di raccogliere i nomi e le versioni dei prodotti SAP in esecuzione sull'host, specifica `true`. Il valore predefinito è `true`. Per ulteriori informazioni, consulta il codice dell'agente nel `google-cloud-sap-agent` repository GitHub in GoogleCloudPlatform/sapagent.
`discovery_configuration.enable_discovery`	`Boolean` Per inviare a Cloud Logging le informazioni raccolte dall'agente sui prodotti SAP in esecuzione sull'host, specifica `true`. Il valore predefinito è `true`. Se specifichi il valore `false`, l'agente memorizza le informazioni raccolte sull'host e non le invia a Cloud Logging.
`collection_configuration.collect_process_metrics`	`Boolean` Per abilitare la raccolta delle metriche di monitoraggio dei processi, specifica `true`. Il valore predefinito è `false`. Questo parametro è applicabile solo a Linux. Se attivi la raccolta delle metriche di processo per SAP HANA, devi configurare i parametri aggiuntivi elencati in `hana_metrics_config`.
`collection_configuration.process_metrics_frequency`	`Int` Dalla versione 2.6, questo parametro determina la frequenza di raccolta delle metriche di monitoraggio dei processi in rapida evoluzione, in secondi. Le metriche di monitoraggio dei processi in rapida evoluzione sono: `sap/hana/availability`, `sap/hana/ha/availability` e `sap/nw/availability`. Il valore predefinito per questo parametro è `5` secondi. Ti consigliamo di utilizzare questo valore predefinito. Tutte le altre metriche di monitoraggio dei processi (in lenta evoluzione) vengono raccolte con una frequenza predefinita di 30 secondi. Per modificare la frequenza di raccolta delle metriche di monitoraggio dei processi con variazioni lente, utilizza il parametro `slow_process_metrics_frequency`.
`collection_configuration.slow_process_metrics_frequency`	`Int` Specifica la frequenza di raccolta delle metriche di monitoraggio dei processi con variazioni lente, in secondi. Il valore predefinito per questo parametro è `30` secondi.
`collection_configuration.process_metrics_to_skip`	`Array` Specifica le metriche di monitoraggio dei processi che non vuoi che l'agente raccolga. Questo parametro accetta un valore separato da virgole dei nomi delle metriche di monitoraggio dei processi. Ad esempio: `"process_metrics_to_skip": ["/sap/nw/abap/sessions", "/sap/nw/abap/rfc"]`.
`collection_configuration.hana_metrics_config.hana_db_user`	`String` Specifica l'account utente del database utilizzato dall'agente per eseguire query su SAP HANA. Il valore predefinito è `SYSTEM`.
`collection_configuration.hana_metrics_config.hana_db_password`	`String` Specifica la password in testo normale per l'account utente del database utilizzato dall'agente per eseguire query su SAP HANA. Anziché specificare una password in testo normale, ti consigliamo di utilizzare una delle seguenti opzioni: `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`. Ti consigliamo di impostare una sola opzione di autenticazione nel file di configurazione.
`collection_configuration.hana_metrics_config.hana_db_password_secret_name`	`String` Per fornire in modo sicuro la password dell'account utente del database utilizzato dall'agente per eseguire query su SAP HANA, specifica il nome del token segreto che contiene le credenziali di sicurezza per l'account utente del database. Importante: il segreto e l'istanza Compute Engine di hosting devono esistere nello stesso progetto Google Cloud. L'agente raccoglie le metriche relative a SAP HANA solo se specifichi `hana_db_password_secret_name`, `hdbuserstore_key` o `hana_db_password`. Per l'autenticazione SAP HANA, l'agente utilizza il seguente ordine di preferenza: se specificato, il parametro di configurazione `hdbuserstore_key` è preferito rispetto al parametro `hana_db_password`, che è preferito rispetto al parametro `hana_db_password_secret_name`. Ti consigliamo di impostare una sola opzione di autenticazione nel file di configurazione.
`collection_configuration.hana_metrics_config.hdbuserstore_key`	`String` Per connetterti in sicurezza a un sistema SAP HANA, specifica una chiave Secure User Store (`hdbuserstore`) che hai creato per quel sistema. Per utilizzare una chiave `hdbuserstore` per l'autenticazione, verifica quanto segue: Gli strumenti SAP `hdbsql` e `hdbuserstore` sono installati sull'istanza di calcolo che ospita l'agente. La chiave `hdbuserstore` corrisponde a un'istanza SAP HANA specifica. Non puoi utilizzare chiavi che contengono gli hostname di più istanze SAP HANA. L'utente `SIDadm` può eseguire query sul database SAP HANA utilizzando questa chiave. Qui `SID` si riferisce al valore specificato per il parametro `sid`. Puoi verificarlo eseguendo il seguente comando come utente `SIDadm`: hdbsql -U `HDB_USERSTORE_KEY` "SELECT * FROM DUMMY" Questo parametro di configurazione è supportato dalla versione 3.3 dell'agente. Per l'autenticazione SAP HANA, l'agente utilizza il seguente ordine di preferenza: se specificato, il parametro di configurazione `hdbuserstore_key` è preferito rispetto al parametro `hana_db_password`, che è preferito rispetto al parametro `hana_db_password_secret_name`. Ti consigliamo di impostare una sola opzione di autenticazione nel file di configurazione.
`collection_configuration.hana_metrics_config.sid`	`String` Specifica l'SID dell'istanza SAP HANA. Se utilizzi una chiave `hdbuserstore` per autenticarti in SAP HANA, consulta la sezione `hdbuserstore_key`.
`collection_configuration.collect_workload_validation_metrics`	`Boolean` Per attivare la raccolta delle metriche di valutazione di Workload Manager, specifica `true`. Dalla versione 3.2, il valore predefinito è `true`. Questo parametro è applicabile solo a Linux.
`collection_configuration.workload_validation_metrics_frequency`	`Int` La frequenza di raccolta delle metriche di valutazione del Gestore workload in secondi. Il valore predefinito è `300` secondi. 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 di Workload Manager, aggiungi il parametro `workload_validation_metrics_frequency` nella sezione `collection_configuration` e fornisci il valore richiesto.
`collection_configuration.workload_validation_collection_definition.fetch_latest_config`	`Boolean` Facoltativo. Il valore predefinito è `true`, che consente all'agente di raccogliere l'ultimo insieme di metriche di valutazione di Workload Manager senza che tu debba aggiornarlo. Se vuoi disattivare questo comportamento, specifica questo parametro nel file di configurazione e imposta il relativo valore su `false`.
`collection_configuration.workload_validation_db_metrics_config.hana_db_user`	`String` Specifica l'account utente utilizzato per eseguire query sull'istanza SAP HANA. L'account utente deve disporre dell'autorizzazione di lettura per il database SAP HANA.
`collection_configuration.workload_validation_db_metrics_config.hana_db_password`	`String` Specifica la password per l'account utente utilizzato per eseguire query sull'istanza SAP HANA. Per l'autenticazione SAP HANA, l'agente utilizza il seguente ordine di preferenza: se specificato, il parametro di configurazione `hdbuserstore_key` è preferito rispetto al parametro `hana_db_password`, che è preferito rispetto al parametro `hana_db_password_secret_name`. Ti consigliamo di impostare una sola opzione di autenticazione nel file di configurazione.
`collection_configuration.workload_validation_db_metrics_config.hana_db_password_secret_name`	`String` Specifica il nome del segreto in Secret Manager che memorizza la password dell'account utente. In alternativa, puoi specificare il parametro di configurazione `hdbuserstore_key` per autenticare l'utente SAP HANA specificato. Per l'autenticazione SAP HANA, l'agente utilizza il seguente ordine di preferenza: se specificato, il parametro di configurazione `hdbuserstore_key` è preferito rispetto al parametro `hana_db_password`, che è preferito rispetto al parametro `hana_db_password_secret_name`. Ti consigliamo di impostare una sola opzione di autenticazione nel file di configurazione.
`collection_configuration.workload_validation_db_metrics_config.hdbuserstore_key`	`String` Per connetterti in sicurezza a un sistema SAP HANA, specifica una chiave Secure User Store (`hdbuserstore`) che hai creato per quel sistema. Per utilizzare una chiave `hdbuserstore` per l'autenticazione, verifica quanto segue: Gli strumenti SAP `hdbsql` e `hdbuserstore` sono installati sull'istanza di calcolo che ospita l'agente. La chiave `hdbuserstore` corrisponde a un'istanza SAP HANA specifica. Non puoi utilizzare chiavi che contengono gli hostname di più istanze SAP HANA. L'utente `SIDadm` può eseguire query sul database SAP HANA utilizzando questa chiave. Qui `SID` si riferisce al valore specificato per il parametro `sid`. Puoi verificarlo eseguendo il seguente comando come utente `SIDadm`: hdbsql -U `HDB_USERSTORE_KEY` "SELECT * FROM DUMMY" Questo parametro di configurazione è supportato dalla versione 3.3 dell'agente. Se specifichi `hdbuserstore_key`, puoi saltare la specifica dei parametri `hostname` e `port`. Per l'autenticazione SAP HANA, l'agente utilizza il seguente ordine di preferenza: se specificato, il parametro di configurazione `hdbuserstore_key` è preferito rispetto al parametro `hana_db_password`, che è preferito rispetto al parametro `hana_db_password_secret_name`. Ti consigliamo di impostare una sola opzione di autenticazione nel file di configurazione.
`collection_configuration.workload_validation_db_metrics_config.sid`	`String` Specifica l'SID dell'istanza SAP HANA.
`collection_configuration.workload_validation_db_metrics_config.hostname`	`String` Specifica l'identificatore della macchina, locale o remota, che ospita la tua istanza SAP HANA. Di seguito sono riportati i valori supportati: Se l'host è un computer locale, specifica la stringa `localhost` o l'indirizzo IP loopback localhost, ad esempio `127.0.0.1`. Se l'host è una macchina remota, specifica il relativo indirizzo IP interno o esterno.
`collection_configuration.workload_validation_db_metrics_config.port`	`String` Specifica la porta su cui l'istanza SAP HANA accetta le query. Per la prima o l'unica istanza del database del tenant, la porta è `3NN15`, dove `NN` è il numero di istanza dell'istanza SAP HANA.
`collection_configuration.workload_validation_db_metrics_frequency`	`Int` La frequenza di raccolta delle metriche del database SAP HANA, in secondi, per la valutazione di Workload Manager. Il valore predefinito è `3600` secondi. Sebbene tu possa aggiornare la frequenza di raccolta delle metriche del database SAP HANA, ti consigliamo di utilizzare il valore predefinito. Se devi modificare il valore predefinito, aggiungi il parammetro `workload_validation_db_metrics_frequency` nella sezione `collection_configuration` e fornisci il valore richiesto. Assicurati di non impostare una frequenza di raccolta superiore a `3600` secondi.
`hana_monitoring_configuration.enabled`	`Boolean` Facoltativo. Per consentire all'agente di Google Cloud per SAP di raccogliere le metriche di monitoraggio di SAP HANA, specifica `true`. Il valore predefinito è `false`. I seguenti parametri secondari sono applicabili solo se specifichi `hana_monitoring_configuration.enabled: true`.
`hana_monitoring_configuration.sample_interval_sec`	`Int` Facoltativo. Specifica l'intervallo di campionamento, in secondi, che determina la frequenza con cui l'agente di Google Cloud per SAP esegue query sulle tue istanze SAP HANA per raccogliere le metriche di monitoraggio di SAP HANA. Il valore predefinito è 300 secondi. Per ogni query definita nel file di configurazione dell'agente di Google Cloud per SAP, puoi sovrascrivere l'intervallo di campionamento globale specificando l'intervallo richiesto al parametro `sample_interval_sec`. Gli intervalli di campionamento devono essere di almeno 5 secondi.
`hana_monitoring_configuration.query_timeout_sec`	`Int` Facoltativo. Specifica il timeout per ogni query eseguita sulle istanze SAP HANA. Il valore predefinito è 300 secondi.
`hana_monitoring_configuration.execution_threads`	`Int` Facoltativo. Specifica il numero di thread utilizzati per inviare query alle istanze SAP HANA. Ogni query viene eseguita in un proprio thread. Il valore predefinito è 10.
`hana_monitoring_configuration.hana_instances.name`	`String` Specifica l'identificatore del nome per l'istanza SAP HANA.
`hana_monitoring_configuration.hana_instances.sid`	`String` Specifica l'SID dell'istanza SAP HANA. Questa stringa viene aggiunta come etichetta a tutte le metriche risultanti dalla query delle istanze SAP HANA.
`hana_monitoring_configuration.hana_instances.host`	`String` Specifica l'identificatore della macchina, locale o remota, che ospita la tua istanza SAP HANA. Di seguito sono riportati i valori supportati: Se l'host è un computer locale, specifica la stringa `localhost` o l'indirizzo IP loopback localhost, ad esempio `127.0.0.1`. Se l'host è una macchina remota, specifica il relativo indirizzo IP interno o esterno.
`hana_monitoring_configuration.hana_instances.port`	`String` Specifica la porta su cui l'istanza SAP HANA accetta le query. Per la prima o l'unica istanza del database del tenant, la porta è `3NN15`, dove `NN` è il numero di istanza dell'istanza SAP HANA.
`hana_monitoring_configuration.hana_instances.user`	`String` Specifica l'account utente utilizzato per eseguire query sull'istanza SAP HANA. Assicurati che questo utente abbia il privilegio di leggere le visualizzazioni di monitoraggio nel database SAP HANA. Se questo privilegio non viene concesso, le metriche di monitoraggio di SAP HANA relative alle viste di monitoraggio non contengono dati.
`hana_monitoring_configuration.hana_instances.password`	`String` Facoltativo. Specifica la password, in testo normale, che autentica l'account utente per eseguire query sull'istanza SAP HANA. Per l'autenticazione, devi specificare uno dei seguenti elementi: La password in testo normale al parametro `password`. (Consigliato) Se utilizzi Secret Manager per archiviare la password come secret, devi specificare il nome del secret corrispondente al parametro `secret_name`. (Consigliato) Una chiave `hdbuserstore` per il parametro `hdbuserstore_key`. Per l'autenticazione SAP HANA, l'agente utilizza il seguente ordine di preferenza: se specificato, il parametro di configurazione `hdbuserstore_key` è preferito rispetto al parametro `password`, che è preferito rispetto al parametro `secret_name`. Ti consigliamo di impostare una sola opzione di autenticazione nel file di configurazione.
`hana_monitoring_configuration.hana_instances.secret_name`	`String` Facoltativo. Specifica il nome del segreto in Secret Manager che memorizza la password dell'account utente. Per l'autenticazione SAP HANA, l'agente utilizza il seguente ordine di preferenza: se specificato, il parametro di configurazione `hdbuserstore_key` è preferito rispetto al parametro `password`, che è preferito rispetto al parametro `secret_name`. Ti consigliamo di impostare una sola opzione di autenticazione nel file di configurazione.
`hana_monitoring_configuration.hana_instances.hdbuserstore_key`	`String` Per connetterti in sicurezza a un sistema SAP HANA, specifica una chiave Secure User Store (`hdbuserstore`) che hai creato per quel sistema. Per utilizzare una chiave `hdbuserstore` per l'autenticazione, verifica quanto segue: Gli strumenti SAP `hdbsql` e `hdbuserstore` sono installati sull'istanza di calcolo che ospita l'agente. La chiave `hdbuserstore` corrisponde a un'istanza SAP HANA specifica. Non puoi utilizzare chiavi che contengono gli hostname di più istanze SAP HANA. L'utente `SIDadm` può eseguire query sul database SAP HANA utilizzando questa chiave. Qui `SID` si riferisce al valore specificato per il parametro `sid`. Puoi verificarlo eseguendo il seguente comando come utente `SIDadm`: hdbsql -U `HDB_USERSTORE_KEY` "SELECT * FROM DUMMY" Questo parametro di configurazione è supportato dalla versione 3.3 dell'agente. Se specifichi `hdbuserstore_key`, puoi saltare la specifica dei parametri `host` e `port`.
`hana_monitoring_configuration.hana_instances.enable_ssl`	`Boolean` Facoltativo. Specifica se SSL è attivo o meno nell'istanza SAP HANA. Il valore predefinito è `false`.
`hana_monitoring_configuration.hana_instances.host_name_in_certificate`	`String` Se specifichi `enable_ssl: true` per un'istanza SAP HANA, devi specificare il nome host impostato nel certificato SSL.
`hana_monitoring_configuration.hana_instances.tls_root_ca_file`	`String` Se specifichi `enable_ssl: true` per un'istanza SAP HANA, devi specificare il percorso del certificato di sicurezza.
`hana_monitoring_configuration.queries.enabled`	`Boolean` Facoltativo. Per attivare una query SQL per tutte le istanze SAP HANA, specifica il valore `true` per il parametro `enabled` per la query SQL.
`hana_monitoring_configuration.queries.name`	`String` Se hai definito query personalizzate nel file di configurazione, devi specificare un nome univoco per ogni query personalizzata. Il nome della query deve essere univoco perché viene utilizzato per creare l'URL predefinito della metrica in Monitoraggio.
`hana_monitoring_configuration.queries.sql`	`String` Specifica l'istruzione SQL che l'agente emette alle tue istanze SAP HANA. L'istruzione SQL deve essere conforme alla sintassi SQL definita da SAP nel SAP HANA SQL and System Views Reference.
`hana_monitoring_configuration.queries.sample_interval_sec`	`Int` Facoltativo. Specifica l'intervallo di campionamento per la query SQL. Questo sostituisce l'intervallo di campionamento globale. Il valore deve essere almeno di 5 secondi.
`hana_monitoring_configuration.queries.columns.name`	`String` Specifica un nome che identifichi in modo univoco ogni colonna. Il nome della colonna deve essere univoco perché viene utilizzato per creare l'URL predefinito della metrica in Monitoraggio.
`hana_monitoring_configuration.queries.columns.metric_type`	`String` Per la gestione da parte di Monitoring, specifica uno dei seguenti tipi di metrica: `METRIC_LABEL`, `METRIC_GAUGE` o `METRIC_CUMULATIVE`. Le metriche di tipo `METRIC_LABEL` vengono aggiunte come etichette a tutte le metriche `METRIC_GAUGE` e `METRIC_CUMULATIVE` inviate a Monitoraggio.
`hana_monitoring_configuration.queries.columns.value_type`	`String` Per la gestione da parte di Monitoraggio, specifica un tipo di dati supportato dal tipo di metrica. I tipi di dati supportati sono: `VALUE_BOOL`, `VALUE_INT64`, `VALUE_STRING` o `VALUE_DOUBLE`. Per ulteriori informazioni, consulta Combinazione supportata.
`hana_monitoring_configuration.queries.columns.name_override`	`String` Facoltativo. Per la gestione da parte di Monitoraggio, specifica il percorso da mostrare nell'URL della metrica anziché i nomi delle query e delle colonne. Ad esempio: URL predefinito della metrica: `workload.googleapis.com/sap/hanamonitoring/QUERY_NAME/COLUMN_NAME` URL metrica che utilizza il percorso personalizzato: `workload.googleapis.com/sap/hanamonitoring/CUSTOM_PATH`

Risoluzione dei problemi

Per informazioni su come diagnosticare e risolvere i problemi che potresti riscontrare durante l'installazione e la configurazione dell'agente di Google Cloud per SAP, consulta la guida alla risoluzione dei problemi dell'agente di Google Cloud per SAP.

Assistenza

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