Versione 2: configura la raccolta delle metriche di SAP HANA Monitoring

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

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:

Per aggiungere questi ruoli obbligatori al tuo account di servizio, segui questi passaggi:

  1. Nella console Google Cloud, vai alla pagina IAM.

    Vai a IAM

  2. Selezionare il tuo progetto Google Cloud.

  3. 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.
  4. 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
  5. 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:

  1. Stabilisci una connessione SSH con la tua istanza VM di Compute Engine o con il server Bare Metal Solution.

  2. Apri il file di configurazione dell'agente:

    /etc/google-cloud-sap-agent/configuration.json
  3. Nella sezione hana_monitoring_configuration, esegui queste operazioni:

    • Per il parametro enabled, imposta il valore true.
    • 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.

  4. Facoltativamente, nella sezione cloud_properties puoi aggiornare i valori dei parametri impostati automaticamente. Per farlo, aggiungi la sezione cloud_properties al file di configurazione e specifica i parametri richiesti e i relativi valori.

  5. Salva il file di configurazione.

  6. 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, denominata custom_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, denominata custom_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:

  1. Stabilisci una connessione SSH con la tua istanza VM di Compute Engine o con il server Bare Metal Solution.

  2. Apri il file di configurazione dell'agente:

    /etc/google-cloud-sap-agent/configuration.json
  3. 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.

  4. Per attivare una query personalizzata, imposta il parametro enabled su true.

  5. Salva il file di configurazione.

  6. 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:

  1. Stabilisci una connessione SSH con la tua istanza VM di Compute Engine o con il server Bare Metal Solution.

  2. Apri il file di configurazione dell'agente:

    /etc/google-cloud-sap-agent/configuration.json
  3. 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.

  4. Per disabilitare una query personalizzata, imposta il parametro enabled su false per la query personalizzata.

  5. Salva il file di configurazione.

  6. 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

Boolean

Per abilitare la raccolta delle metriche richieste da SAP Host Agent, specifica true. Il valore predefinito è true.
Non impostare provide_sap_host_agent_metrics su false a meno che non sia 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 sia 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.

sap_system_discovery

Boolean

Per abilitare il rilevamento del sistema SAP, specifica true. Il valore predefinito è true.

cloud_properties.project_id

String

Se il tuo sistema SAP è in esecuzione su un server Bare Metal Solution, specifica l'ID del progetto Google Cloud che stai utilizzando con Bare Metal Solution.

Quando l'agente viene eseguito su un'istanza VM, per impostazione predefinita, rileva automaticamente l'ID progetto.

cloud_properties.instance_name

String

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à instance_id.

cloud_properties.region

String

Se il tuo sistema SAP è in esecuzione su un server Bare Metal Solution, specifica la regione del server Bare Metal Solution.

Quando l'agente viene eseguito su un'istanza VM, per impostazione predefinita utilizza la regione dell'istanza VM su cui è installato l'agente.

cloud_properties.zone

String

Per impostazione predefinita, quando l'agente viene eseguito su un'istanza VM utilizza la zona dell'istanza VM in cui è installato.

cloud_properties.image

String

Specifica il nome dell'immagine del sistema operativo 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 l'agente.

cloud_properties.numeric_project_id

String

Specifica l'ID numerico del progetto Google Cloud in cui è in esecuzione il sistema SAP.

Quando l'agente viene eseguito su un'istanza VM, per impostazione predefinita, rileva automaticamente l'ID progetto numerico.

hana_monitoring_configuration.enabled

Boolean

Facoltativo. Per consentire all'agente di Google Cloud per SAP di raccogliere le metriche di monitoraggio SAP HANA, specifica true. Il valore predefinito è false.

I seguenti parametri secondari sono applicabili solo quando specifichi hana_monitoring_configuration.enabled: true.
hana_monitoring_configuration.sample_interval_sec

Int

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 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 effettuata 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 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 etichetta a tutte le metriche risultanti dalle query sulle tue istanze SAP HANA.

hana_monitoring_configuration.hana_instances.host

String

Specifica l'identificatore della macchina, locale o remota, che ospita l'istanza SAP HANA. Di seguito sono riportati i valori supportati:

  • Se l'host è una macchina locale, specifica la stringa localhost o l'indirizzo IP di loopback localhost, ad esempio 127.0.0.1.
  • Se l'host è una macchina remota, specifica il suo indirizzo IP interno o esterno.
hana_monitoring_configuration.hana_instances.port

String

Specifica la porta su cui la tua istanza SAP HANA accetta le query. Per la prima o unica istanza di database tenant, la porta è 3NN15, dove NN è il numero di istanza dell'istanza SAP HANA.

hana_monitoring_configuration.hana_instances.user

String

Specifica l'account utente utilizzato per eseguire query sull'istanza SAP HANA.

hana_monitoring_configuration.hana_instances.password

String

Facoltativo. Specifica la password, come testo normale, che autentica l'account utente per 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 per il parametro secret_name.
  • (Consigliato) Una chiave hdbuserstore per il parametro hdbuserstore_key.
hana_monitoring_configuration.hana_instances.secret_name

String

Facoltativo. Specifica il nome del secret in Secret Manager in cui è archiviata la password dell'account utente.

hana_monitoring_configuration.hana_instances.hdbuserstore_key

String

Per autenticare l'utente SAP HANA specificato per user, specifica una chiave hdbuserstore che hai creato per l'utente.

Per utilizzare una chiave hdbuserstore per l'autenticazione, assicurati di soddisfare le seguenti condizioni:

  • Gli strumenti SAP hdbsql e hdduserstore sono installati sull'istanza di computing che ospita l'agente.
  • La chiave hdbuserstore corrisponde a un'istanza SAP HANA specifica. Non puoi utilizzare chiavi che contengono nomi host di più istanze SAP HANA.

Se specifichi hdbuserstore_key, puoi saltare i parametri host e port.

hana_monitoring_configuration.hana_instances.enable_ssl

Boolean

Facoltativo. Specifica se SSL è abilitato o meno nella tua istanza SAP HANA. Il valore predefinito è false.

hana_monitoring_configuration.hana_instances.host_name_in_certificate

String

Se specifichi enable_ssl: true per un'istanza SAP HANA, devi specificare il nome host impostato nel certificato SSL.

hana_monitoring_configuration.hana_instances.tls_root_ca_file

String

Se specifichi enable_ssl: true per un'istanza SAP HANA, devi specificare il percorso 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 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

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 in SAP HANA SQL e System views (Riferimento sulle visualizzazioni di sistema e SAP HANA).
hana_monitoring_configuration.queries.sample_interval_sec

Int

Facoltativo. Specifica l'intervallo di esempio per la query SQL. Questa operazione sostituisce l'intervallo di campionamento globale. Il valore deve essere di almeno 5 secondi.

hana_monitoring_configuration.queries.columns.name

String

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

String

Per la gestione tramite Monitoring, specifica uno dei seguenti tipi di metriche: METRIC_LABEL, METRIC_GAUGE o METRIC_CUMULATIVE.

Le metriche di tipo METRIC_LABEL vengono aggiunte come etichette a tutte le metriche METRIC_GAUGE e METRIC_CUMULATIVE inviate a Monitoring.

hana_monitoring_configuration.queries.columns.value_type

String

Per la gestione da parte di Monitoring, specifica un tipo di dati supportato dal tipo di metrica.

I tipi di dati supportati sono i seguenti: VALUE_BOOL, VALUE_INT64, VALUE_STRING o VALUE_DOUBLE. Per maggiori informazioni, consulta la pagina Combinazione supportata.

hana_monitoring_configuration.queries.columns.name_override

String

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:

  • URL predefinito della metrica: workload.googleapis.com/sap/hanamonitoring/QUERY_NAME/COLUMN_NAME
  • URL della metrica che utilizza il percorso personalizzato: workload.googleapis.com/sap/hanamonitoring/CUSTOM_PATH

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

  1. Nella console Google Cloud, vai alla pagina Monitoring:

    Vai a Monitoring

  2. Nel pannello di navigazione di Monitoring, fai clic su Dashboard.

  3. Fai clic sulla scheda Raccolta di esempi.

    Visualizzazione della scheda della Raccolta di esempio selezionata.

  4. Per filtrare le dashboard personalizzate specifiche dell'agente, nel campo Filtro, digita Agent for SAP.

  5. (Facoltativo) Per visualizzare i dettagli di una dashboard o per visualizzarne l'anteprima, fai clic su Anteprima.

  6. Seleziona la dashboard da installare.

  7. 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

  1. Apri Cloud Shell:

    Apri Cloud Shell

  2. In Cloud Shell, clona o scarica il repository:

    git clone https://github.com/GoogleCloudPlatform/monitoring-dashboard-samples/

  3. 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:

  1. Nella console Google Cloud, vai alla pagina Monitoring:

    Vai a Monitoring

  2. Nel pannello di navigazione di Monitoring, fai clic su Dashboard.

  3. 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.

L'acquisizione schermo mostra la dashboard personalizzata
per le metriche SAP HANA in Monitoring