Questa guida illustra come configurare la versione 2 di Agente Google Cloud per SAP per raccogliere SAP HANA il monitoraggio delle metriche dai sistemi SAP HANA.
Per informazioni su questa funzione, vedi Monitoraggio di SAP HANA con l'agente di Google Cloud per SAP.
Prima di iniziare
- Convalida l'installazione dell'agente di Google Cloud per SAP. Per istruzioni, vedi il guida all'installazione per il tuo scenario.
- Se hai installato l'agente su un server Bare Metal Solution, assicurati che di aver completato i prerequisiti richiesti e di aver configurato un servizio . Per istruzioni, vedi Configura l'agente di 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 da Compute Engine L'istanza VM o il server Bare Metal Solution include i seguenti ruoli:
- Visualizzatore Compute (
roles/compute.viewer) - Autore delle metriche di Monitoring (
roles/monitoring.metricWriter) - Funzione di accesso ai secret di Secret Manager (
roles/secretmanager.secretAccessor), se utilizzi Secret Manager per archiviare il database SAP HANA password.
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 all'indirizzo email dell'account di servizio.
- Se l'account di servizio è già nell'elenco delle entità, allora dispone di account ruoli. Fai clic sul pulsante Modifica per l'account di servizio che vuoi modifica.
Seleziona il ruolo richiesto dall'elenco di ruoli disponibili:
- Visualizzatore Compute
- Monitoraggio > 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 di metriche di SAP HANA Monitoring utilizzando di Google Cloud per SAP, segui questi passaggi:
Stabilisci una connessione SSH con la tua istanza VM di Compute Engine oppure 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 che l'agente deve monitorare. - Facoltativamente, definisci query personalizzate. Per informazioni sulla definizione di query personalizzate e per visualizzare esempi, consulta Definizione di query personalizzate.
Facoltativamente, disattiva le query integrate o predefinite. Per istruzioni, vedi Disabilita una query SQL.
Per informazioni sui parametri di configurazione, consulta Parametri di configurazione.
- Per il parametro
Se vuoi, nella sezione
cloud_propertiespuoi aggiornare i valori parametro che vengono impostati automaticamente. Per farlo, aggiungi la sezionecloud_propertiesal tuo di configurazione del deployment e specificare 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 completato di Google Cloud per SAP in esecuzione su una Istanza VM Compute Engine, in cui è abilitata la raccolta di metriche di monitoraggio SAP HANA. Tieni presente che la query personalizzata inclusa in questo esempio, denominatacustom_query, segue la query
linee guida per la definizione 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 completato di Google Cloud per SAP in esecuzione su una Server Bare Metal Solution, in cui è abilitata la raccolta di metriche di monitoraggio SAP HANA. Tieni presente che la query personalizzata inclusa in questo esempio, denominatacustom_query, segue la query
linee guida per la definizione specificate in Definizione di 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 di Google Cloud per SAP 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 completando i seguenti passaggi:
Stabilisci una connessione SSH con la tua istanza VM di Compute Engine oppure 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 tua query.Per informazioni sulla definizione di query personalizzate e per visualizzare esempi, consulta Definizione di query personalizzate.
Per attivare una query personalizzata, imposta il parametro
enabledsutrue.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 L'Agente per SAP di Google Cloud fornisce per impostazione predefinita o qualsiasi query personalizzata che definisci, quindi puoi disabilitare la query SQL completando quanto segue passaggi:
Stabilisci una connessione SSH con la tua istanza VM di Compute Engine oppure 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 nel Sezione
hana_monitoring_configuration.queries:{ "name": "default_QUERY_NAME", "enabled": false }Sostituisci
QUERY_NAMEcon il nome del una query predefinita. Per informazioni sulle query predefinite, consulta Riferimento query predefinita.Per disattivare una query personalizzata, imposta il parametro
enabledsufalse. una 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 illustra i parametri di configurazione Agenti di Google Cloud per SAP specifici per la raccolta di SAP HANA Monitoraggio delle metriche.
| Parametri | |
|---|---|
provide_sap_host_agent_metrics |
Per abilitare la raccolta delle metriche richieste dalla
Agente host SAP, 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 sistema SAP è in esecuzione su un server Bare Metal Solution:
specificare l'ID del progetto Google Cloud che stai
con Bare Metal Solution. |
cloud_properties.instance_name
|
Se il sistema SAP è in esecuzione su un'istanza VM di Compute Engine, e specificare il nome dell'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 dell'agente o in quelle precedenti, specifica
il nome del server Bare Metal Solution per la proprietà
|
cloud_properties.region |
Se il sistema SAP è in esecuzione su un server Bare Metal Solution,
e specifica l'area geografica del server Bare Metal Solution. |
cloud_properties.zone |
Quando l'agente viene eseguito su un'istanza VM, per impostazione predefinita utilizza la zona dell'istanza VM su cui è installato l'agente. |
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 che il sistema SAP
è in esecuzione. |
hana_monitoring_configuration.enabled |
Facoltativo. Consenti all'agente di Google Cloud per SAP di raccogliere i dati SAP HANA
di monitoraggio delle metriche, specifica hana_monitoring_configuration.enabled: true.
|
hana_monitoring_configuration.sample_interval_sec |
Facoltativo. Specifica l'intervallo campione, in secondi, che determina la frequenza con cui l'agente Google Cloud per SAP esegue query su SAP HANA per raccogliere le metriche di monitoraggio SAP HANA. Il valore predefinito è di 300 secondi. Per ogni query definita nel file di configurazione
Agente Google Cloud per SAP, puoi sovrascrivere l'intervallo globale di esempio
specificando l'intervallo richiesto al 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 al 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 a tutte le metriche risultanti dall'esecuzione di query sulle tue istanze SAP HANA. |
hana_monitoring_configuration.hana_instances.host |
Specifica l'identificatore della macchina, locale o remota, che che ospita la tua 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 l'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, 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:
|
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.enable_ssl |
Facoltativo. Specifica se SSL è abilitato o meno in SAP HANA
in esecuzione in un'istanza Compute Engine. 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 nel file di configurazione hai definito query personalizzate, 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 |
Specifica l'istruzione SQL che l'agente invia a SAP HANA di Compute Engine. L'istruzione SQL deve essere conforme alla sintassi SQL definita SAP in Riferimento SQL di SAP HANA e visualizzazioni di sistema. |
hana_monitoring_configuration.queries.sample_interval_sec |
Facoltativo. Specifica l'intervallo di esempio per la query SQL. Questo sostituisce l'intervallo di campionamento globale. Il valore deve essere di 5 secondi o più a lungo. |
hana_monitoring_configuration.queries.columns.name |
Specifica un nome che identifichi in modo univoco ogni colonna. Il nome della colonna deve essere univoco perché viene utilizzato per creare la predefinito della metrica in Monitoring. |
hana_monitoring_configuration.queries.columns.metric_type |
Per la gestione tramite Monitoring, specifica una delle seguenti opzioni
tipi di metriche: Le metriche di tipo |
hana_monitoring_configuration.queries.columns.value_type |
Per la gestione tramite Monitoring, specifica un tipo di dati che sia supportate dal tipo di metrica. I tipi di dati supportati sono i seguenti: |
hana_monitoring_configuration.queries.columns.name_override |
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:
|
Visualizzare le metriche raccolte
Per visualizzare Metriche di monitoraggio di SAP HANA raccolti dall'agente, puoi utilizzare le seguenti dashboard personalizzate Google Cloud fornisce:
Agent for SAP - HANA Overview: questa dashboard fornisce grafici che mostra una panoramica dello stato per le seguenti metriche: Memoria istanza, memoria di servizio utilizzata, memoria massima stimata dello schema, memoria totale dell'archivio riga dimensioni, outlier di lettura dello schema, outlier di scrittura dello schema, ultimo schema compresso il conteggio dei record anomali, le connessioni di sistema, gli avvisi, la percentuale di CPU per i 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 - HANA performance: questa dashboard fornisce grafici che mostrano i valori non elaborati delle metriche per le seguenti metriche: Memoria istanza, outlier di lettura e scrittura dello schema, prestazioni dello schema, utilizzo della memoria, schema outlier del numero di record, memoria totale del servizio utilizzata, dimensione della memoria dell'archivio riga, sistema connessioni inattive e in esecuzione, memoria di connessione e archivio righe, totale schema e la dimensione totale massima stimata per lo 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 contenuti, fai clic su Anteprima.
Seleziona la dashboard da installare.
Fai clic su Importa, quindi su Conferma.
La dashboard viene aggiunta alle dashboard disponibili in progetto Google Cloud. Per visualizzare la dashboard, segui le istruzioni in Visualizza 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 file JSON corrispondente:
gcloud monitoring dashboards create --config-from-file=CONFIG_FROM_FILE
Sostituisci
CONFIG_FROM_FILEcon il percorso della File JSON contenente la configurazione della dashboard. Pannello file di configurazione possono trovarsi nel percorso:monitoring-dashboard-samples/dashboards/google-cloud-agent-for-sap.La dashboard viene aggiunta alle dashboard disponibili in progetto Google Cloud. Per visualizzare la dashboard, segui le istruzioni in Visualizza 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 il 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 Metriche SAP HANA in Monitoring.
