Questa guida mostra come configurare la versione 2 dell'agente di Google Cloud per SAP per raccogliere le metriche di monitoraggio SAP HANA dai tuoi sistemi SAP HANA.
Per informazioni su questa funzionalità, consulta Monitorare SAP HANA utilizzando l'agente di Google Cloud per SAP.
Prima di iniziare
- Convalida l'installazione dell'agente di Google Cloud per SAP. Per le istruzioni, consulta la guida all'installazione adatta al tuo scenario.
- Se hai installato l'agente su un server Bare Metal Solution, assicurati di aver completato i prerequisiti richiesti e di aver configurato un account di servizio. Per le istruzioni, vedi Configurare l'agente Google Cloud per SAP su Linux.
Imposta ruoli IAM
Per consentire all'agente di Google Cloud per SAP di raccogliere le metriche di SAP HANA Monitoring, devi assicurarti che l'account di servizio utilizzato dall'istanza VM di Compute Engine o dal server Bare Metal Solution includa i ruoli seguenti:
- Visualizzatore Compute (
roles/compute.viewer
) - Autore delle metriche di Monitoring (
roles/monitoring.metricWriter
) - Funzione di accesso ai secret di SAP HANA (
roles/secretmanager.secretAccessor
) se utilizzi Secret Manager per archiviare la password del database SAP HANA.
Per aggiungere questi ruoli obbligatori al tuo account di servizio, segui questi passaggi:
Nella console Google Cloud, vai alla pagina 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 gli sono stati assegnati ruoli. Fai clic su Aggiungi e inserisci l'indirizzo email dell'account di servizio.
- Se l'account di servizio è già nell'elenco delle entità, ha i ruoli esistenti. Fai clic sul pulsante Modifica per l'account di servizio che vuoi modificare.
Seleziona il ruolo richiesto dall'elenco di ruoli disponibili:
- Visualizzatore Compute
- Monitoring > Writer metriche Monitoring
- Secret Manager > Funzione di accesso ai secret di Secret Manager
Fai clic su Aggiungi o Salva per applicare i ruoli all'account di servizio.
Abilita la raccolta delle metriche di SAP HANA Monitoring
Per abilitare la raccolta delle metriche di SAP HANA Monitoring utilizzando l'agente di Google Cloud per SAP, segui questi passaggi:
Stabilisci una connessione SSH con la tua istanza VM di Compute Engine o con il server Bare Metal Solution.
Apri il file di configurazione dell'agente:
/etc/google-cloud-sap-agent/configuration.json
Nella sezione
hana_monitoring_configuration
, esegui queste operazioni:- Per il parametro
enabled
, imposta il valoretrue
. - Nella sezione
hana_instances
, specifica le istanze SAP HANA che vuoi che l'agente monitori. - Facoltativamente, definisci query personalizzate. Per informazioni sulla definizione di query personalizzate e per vedere alcuni esempi, consulta Definizione di query personalizzate.
Facoltativamente, disattiva le query integrate o predefinite. Per le istruzioni, vedi Disattivare una query SQL.
Per informazioni sui parametri di configurazione, consulta Parametri di configurazione.
- Per il parametro
Facoltativamente, nella sezione
cloud_properties
puoi aggiornare i valori dei parametri impostati automaticamente. Per farlo, aggiungi la sezionecloud_properties
al file di configurazione e specifica i parametri richiesti e i relativi valori.Salva il file di configurazione.
Riavvia l'agente per applicare le nuove impostazioni:
sudo systemctl restart google-cloud-sap-agent
File di configurazione di esempio
Istanza VM di Compute Engine
L'esempio seguente è un file di configurazione completo dell'agente per SAP di Google Cloud in esecuzione su un istanza VM Compute Engine, in cui è abilitata la raccolta delle metriche di monitoraggio SAP HANA. Tieni presente che la query personalizzata inclusa in questo esempio, denominatacustom_query
, segue le linee guida per la definizione
delle query personalizzate specificate in Definizione di query personalizzate.
{ "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 }, "cloud_properties": { "project_id": "my-project", "instance_name": "vm-instance-1", "image": "rhel-8" }, "discovery_configuration": { "enable_discovery": true }, "hana_monitoring_configuration": { "enabled": true, "sample_interval_sec": 60, "query_timeout_sec": 30, "execution_threads": 20, "hana_instances": [ { "name": "local", "sid": "DEH", "host": "localhost", "port": "30015", "user": "system", "secret_name": "password-secret-name", "hdbuserstore_key": "user_store_key" }, { "name": "remote", "sid": "DEH", "host": "10.123.0.12", "port": "30015", "user": "system", "secret_name": "password-secret-name", "hdbuserstore_key": "user_store_key" } ], "queries": [ { "name": "custom_query", "enabled": true, "sql": "SELECT * FROM MyTable;", "columns": [ { "name": "string", "metric_type": "METRIC_LABEL", "value_type": "VALUE_STRING" }, { "name": "bool", "metric_type": "METRIC_GAUGE", "value_type": "VALUE_BOOL" }, { "name": "int", "metric_type": "METRIC_GAUGE", "value_type": "VALUE_INT64" }, { "name": "double", "metric_type": "METRIC_GAUGE", "value_type": "VALUE_DOUBLE" } ] }, { "name": "default_host_queries", "enabled": false } ] } }
Server Bare Metal Solution
L'esempio seguente è un file di configurazione completo dell'agente per SAP di Google Cloud in esecuzione su un server Bare Metal Solution, in cui è abilitata la raccolta delle metriche di monitoraggio SAP HANA. Tieni presente che la query personalizzata inclusa in questo esempio, denominatacustom_query
, segue le linee guida per la definizione
delle query personalizzate specificate in Definizione delle query personalizzate.
{ "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 }, "cloud_properties": { "project_id": "my-project", "instance_name": "bms-machine-1"
"region": "us-central1", "image": "rhel-8" }, "discovery_configuration": { "enable_discovery": true }, "hana_monitoring_configuration": { "enabled": true, "sample_interval_sec": 60, "query_timeout_sec": 30, "execution_threads": 20, "hana_instances": [ { "name": "local", "sid": "DEH", "host": "localhost", "port": "30015", "user": "system", "secret_name": "password-secret-name", "hdbuserstore_key": "user_store_key" }, { "name": "remote", "sid": "DEH", "host": "10.123.0.12", "port": "30015", "user": "system", "secret_name": "password-secret-name", "hdbuserstore_key": "user_store_key" } ], "queries": [ { "name": "custom_query", "enabled": true, "sql": "SELECT * FROM MyTable;", "columns": [ { "name": "string", "metric_type": "METRIC_LABEL", "value_type": "VALUE_STRING" }, { "name": "bool", "metric_type": "METRIC_GAUGE", "value_type": "VALUE_BOOL" }, { "name": "int", "metric_type": "METRIC_GAUGE", "value_type": "VALUE_INT64" }, { "name": "double", "metric_type": "METRIC_GAUGE", "value_type": "VALUE_DOUBLE" } ] }, { "name": "default_host_queries", "enabled": false } ] } }
Definisci una query SQL personalizzata
L'agente per SAP di Google Cloud raccoglie le metriche di monitoraggio SAP HANA eseguendo query SQL sulle tue istanze SAP HANA. Oltre a queste query predefinite, puoi definire ed eseguire query SQL personalizzate seguendo questi passaggi:
Stabilisci una connessione SSH con la tua istanza VM di Compute Engine o con il server Bare Metal Solution.
Apri il file di configurazione dell'agente:
/etc/google-cloud-sap-agent/configuration.json
Nella sezione
hana_monitoring_configuration.queries
, definisci la query personalizzata.Per informazioni sulla definizione di query personalizzate e per vedere alcuni esempi, consulta Definizione di query personalizzate.
Per attivare una query personalizzata, imposta il parametro
enabled
sutrue
.Salva il file di configurazione.
Riavvia l'agente per applicare le nuove impostazioni:
sudo systemctl restart google-cloud-sap-agent
Disabilita una query SQL
Se non vuoi eseguire nessuna delle query SQL integrate fornite dall'Agente di Google Cloud per SAP per impostazione predefinita, né delle query personalizzate che definisci, puoi disabilitare la query SQL completando i seguenti passaggi:
Stabilisci una connessione SSH con la tua istanza VM di Compute Engine o con il server Bare Metal Solution.
Apri il file di configurazione dell'agente:
/etc/google-cloud-sap-agent/configuration.json
Per disabilitare una query integrata o predefinita, includi quanto segue nella sezione
hana_monitoring_configuration.queries
:{ "name": "default_QUERY_NAME", "enabled": false }
Sostituisci
QUERY_NAME
con il nome della query predefinita. Per informazioni sulle query predefinite, consulta Riferimento per le query predefinite.Per disabilitare una query personalizzata, imposta il parametro
enabled
sufalse
per la query personalizzata.Salva il file di configurazione.
Riavvia l'agente per applicare le nuove impostazioni:
sudo systemctl restart google-cloud-sap-agent
Parametri di configurazione
La tabella seguente spiega i parametri di configurazione dell'agente di Google Cloud per SAP che sono specifici per la raccolta delle metriche di SAP HANA Monitoring.
Parametri | |
---|---|
provide_sap_host_agent_metrics |
Per abilitare la raccolta delle metriche richieste da SAP Host Agent, specifica |
bare_metal |
Quando l'agente è installato su un server Bare Metal Solution, specifica
|
log_level |
Per impostare il livello di logging dell'agente, imposta il valore richiesto. I livelli di log disponibili sono i seguenti:
Il valore predefinito è |
log_to_cloud |
Per reindirizzare i log dell'agente a
Cloud Logging, specifica
|
sap_system_discovery |
Per abilitare il rilevamento del sistema SAP, specifica |
cloud_properties.project_id |
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. |
cloud_properties.instance_name
|
Se il sistema SAP è in esecuzione su un'istanza VM di Compute Engine, specifica il nome di questa istanza VM. L'agente rileva automaticamente il nome dell'istanza VM al momento dell'installazione. Se il sistema SAP è in esecuzione su un server Bare Metal Solution, specifica il nome di quel server. Nella versione 2.5 o precedenti dell'agente, specifica il nome del server Bare Metal Solution per la proprietà |
cloud_properties.region |
Se il tuo sistema SAP è in esecuzione su un server Bare Metal Solution, specifica la regione del server Bare Metal Solution. |
cloud_properties.zone |
Per impostazione predefinita, quando l'agente viene eseguito su un'istanza VM utilizza la zona dell'istanza VM in cui è installato. |
cloud_properties.image |
Specifica il nome dell'immagine del sistema operativo dell'istanza. |
cloud_properties.numeric_project_id |
Specifica l'ID numerico del progetto Google Cloud in cui è in esecuzione il sistema SAP. |
hana_monitoring_configuration.enabled |
Facoltativo. Per consentire all'agente di Google Cloud per SAP di raccogliere le metriche di monitoraggio SAP HANA, specifica hana_monitoring_configuration.enabled: true .
|
hana_monitoring_configuration.sample_interval_sec |
Facoltativo. Specifica l'intervallo di esempio, 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 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 |
hana_monitoring_configuration.query_timeout_sec |
Facoltativo. Specifica il timeout per ogni query effettuata sulle istanze SAP HANA. Il valore predefinito è 300 secondi. |
hana_monitoring_configuration.execution_threads |
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 |
Specifica l'identificatore del nome per la tua istanza SAP HANA. |
hana_monitoring_configuration.hana_instances.sid |
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 |
Specifica l'identificatore della macchina, locale o remota, che ospita l'istanza SAP HANA. Di seguito sono riportati i valori supportati:
|
hana_monitoring_configuration.hana_instances.port |
Specifica la porta su cui la tua istanza SAP HANA accetta le query. Per la prima o unica istanza di database tenant, la porta è |
hana_monitoring_configuration.hana_instances.user |
Specifica l'account utente utilizzato per eseguire query sull'istanza SAP HANA. |
hana_monitoring_configuration.hana_instances.password |
Facoltativo. Specifica la password, come testo normale, che autentica l'account utente per eseguire query sull'istanza SAP HANA. Per l'autenticazione, devi specificare una delle seguenti opzioni:
|
hana_monitoring_configuration.hana_instances.secret_name |
Facoltativo. Specifica il nome del secret in Secret Manager in cui è archiviata la password dell'account utente. |
hana_monitoring_configuration.hana_instances.hdbuserstore_key
|
Per autenticare l'utente SAP HANA specificato per Per utilizzare una chiave
Se specifichi |
hana_monitoring_configuration.hana_instances.enable_ssl |
Facoltativo. Specifica se SSL è abilitato o meno nella tua istanza SAP HANA. Il valore predefinito è |
hana_monitoring_configuration.hana_instances.host_name_in_certificate |
Se specifichi |
hana_monitoring_configuration.hana_instances.tls_root_ca_file |
Se specifichi |
hana_monitoring_configuration.queries.enabled |
Facoltativo. Per abilitare una query SQL per tutte le tue istanze SAP HANA, specifica il valore |
hana_monitoring_configuration.queries.name |
Se hai definito query personalizzate nel file di configurazione, devi specificare un nome univoco per ciascuna. Il nome della query deve essere univoco perché viene utilizzato per creare l'URL predefinito della metrica in Monitoring. |
hana_monitoring_configuration.queries.sql |
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 in SAP HANA SQL e System views (Riferimento sulle visualizzazioni di sistema e SAP HANA). |
hana_monitoring_configuration.queries.sample_interval_sec |
Facoltativo. Specifica l'intervallo di esempio per la query SQL. Questa operazione sostituisce l'intervallo di campionamento globale. Il valore deve essere di almeno 5 secondi. |
hana_monitoring_configuration.queries.columns.name |
Specifica un nome che identifichi in modo univoco ogni colonna. Il nome colonna deve essere univoco perché viene utilizzato per creare l'URL predefinito della metrica in Monitoring. |
hana_monitoring_configuration.queries.columns.metric_type |
Per la gestione tramite Monitoring, specifica uno dei seguenti
tipi di metriche: Le metriche di tipo |
hana_monitoring_configuration.queries.columns.value_type |
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: |
hana_monitoring_configuration.queries.columns.name_override |
Facoltativo. Per la gestione da parte di Monitoring, specifica il percorso che vuoi mostrare nell'URL della metrica anziché i nomi delle query e delle colonne. Ad esempio:
|
Visualizzare le metriche raccolte
Per visualizzare le metriche di monitoraggio SAP HANA raccolte dall'agente, puoi utilizzare le seguenti dashboard personalizzate fornite da Google Cloud:
Agent for SAP - HANA Panoramica dettagliata: questa dashboard fornisce grafici che mostrano una panoramica dello stato per le seguenti metriche: memoria dell'istanza, memoria di servizio utilizzata, memoria massima stimata dello schema, dimensione totale della memoria dell'archivio riga, outlier di lettura dello schema, outlier di scrittura dello schema, outlier dell'ultimo numero di record compresso dello schema, connessioni di sistema, avvisi, percentuale di CPU per le prime 5 VM, percentuale di memoria per le prime 5 VM e host per regione.
Il file JSON per questa dashboard è
agent-for-sap-hana-detailed-overview.json
.Agent for SAP - Performance HANA: questa dashboard fornisce grafici che mostrano i valori delle metriche non elaborate per le seguenti metriche: memoria dell'istanza, outlier di lettura e scrittura degli schemi, prestazioni dello schema, utilizzo della memoria, outlier del conteggio dei record di schema, memoria totale del servizio utilizzata, dimensione della memoria dell'archivio righe, connessioni in esecuzione e inattiva del sistema, memoria delle connessioni e dell'archivio righe, record totali dello schema e dimensione totale massima stimata dello schema.
Il file JSON per questa dashboard è
agent-for-sap-hana-performance.json
.
Installa dashboard
Per installare una dashboard personalizzata, completa i seguenti passaggi:
Console Google Cloud
Nella console Google Cloud, vai alla pagina Monitoring:
Nel pannello di navigazione di Monitoring, fai clic su Dashboard.
Fai clic sulla scheda Raccolta di esempi.
Per filtrare le dashboard personalizzate specifiche dell'agente, nel campo Filtro, digita
Agent for SAP
.(Facoltativo) Per visualizzare i dettagli di una dashboard o per visualizzarne l'anteprima, fai clic su Anteprima.
Seleziona la dashboard da installare.
Fai clic su Importa, quindi su Conferma.
La dashboard viene aggiunta alle dashboard disponibili nel tuo progetto Google Cloud. Per visualizzare la dashboard, segui le istruzioni in Visualizzare la dashboard installata.
Google Cloud CLI
Apri Cloud Shell:
In Cloud Shell, clona o scarica il repository:
git clone https://github.com/GoogleCloudPlatform/monitoring-dashboard-samples/
In Cloud Shell, installa la dashboard richiesta utilizzando il file JSON corrispondente:
gcloud monitoring dashboards create --config-from-file=CONFIG_FROM_FILE
Sostituisci
CONFIG_FROM_FILE
con il percorso del file JSON contenente la configurazione della dashboard. I file di configurazione della dashboard si trovano nel percorso:monitoring-dashboard-samples/dashboards/google-cloud-agent-for-sap
.La dashboard viene aggiunta alle dashboard disponibili nel tuo progetto Google Cloud. Per visualizzare la dashboard, segui le istruzioni in Visualizzare la dashboard installata.
Visualizza le dashboard installate
Per visualizzare le dashboard installate:
Nella console Google Cloud, vai alla pagina Monitoring:
Nel pannello di navigazione di Monitoring, fai clic su Dashboard.
Fai clic sul nome della dashboard nell'elenco.
Se hai molte dashboard, puoi applicare un filtro in base alle dashboard personalizzate o in base al nome della nuova dashboard. Per informazioni su come filtrare questo elenco, consulta Visualizzare le dashboard personalizzate.
L'immagine seguente è un esempio che mostra una parte della dashboard personalizzata per le metriche SAP HANA in Monitoring.