Configura la raccolta delle metriche di SAP HANA Monitoring

Questa guida mostra come configurare l'agente Google Cloud per SAP per raccogliere i dati 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

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:

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 all'indirizzo email dell'account di servizio.
    • Se l'account di servizio è già nell'elenco delle entità, allora ha account ruoli. Fai clic sul pulsante Modifica per l'account di servizio che vuoi modifica.
  4. 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
  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 di metriche di SAP HANA Monitoring utilizzando di Google Cloud per SAP, segui questi passaggi:

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

  2. Apri il file di configurazione dell'agente:

    /etc/google-cloud-sap-agent/configuration.json

    In alternativa, puoi anche eseguire questa configurazione dei comandi. Per ulteriori informazioni, vedi Comandi di configurazione per l'agente di Google Cloud per SAP.

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

  4. Se vuoi, nella sezione cloud_properties puoi aggiornare i valori parametro che vengono impostati automaticamente. A questo scopo, aggiungi la sezione cloud_properties al tuo di configurazione del deployment e specificare 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 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, denominata custom_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,
    "enable_workload_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, denominata custom_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, "enable_workload_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:

  1. Stabilisci una connessione SSH con la tua istanza VM di Compute Engine oppure 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 tua query.

    Per informazioni sulla definizione di query personalizzate e per visualizzare 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 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:

  1. Stabilisci una connessione SSH con la tua istanza VM di Compute Engine oppure 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 nel Sezione hana_monitoring_configuration.queries:

    {
    "name": "default_QUERY_NAME",
    "enabled": false
    }

    Sostituisci QUERY_NAME con il nome del una query predefinita. Per informazioni sulle query predefinite, consulta Riferimento query predefinita.

  4. Per disattivare una query personalizzata, imposta il parametro enabled su false. una 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 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

Boolean

Per abilitare la raccolta delle metriche richieste dalla Agente host SAP, specifica true. Il valore predefinito è true.
Non impostare provide_sap_host_agent_metrics su false a meno che non ti venga richiesto dall'assistenza clienti Google Cloud o dall'assistenza SAP.

bare_metal

Boolean

Quando l'agente è installato su un server Bare Metal Solution, specifica true. Il valore predefinito è false.

log_level

String

Per impostare il livello di logging dell'agente, imposta il valore richiesto. I livelli di log disponibili sono i seguenti:

  • DEBUG
  • INFO
  • WARNING
  • ERROR

Il valore predefinito è INFO. Non modificare il livello di logging a meno che sono gestite dall'assistenza clienti Google Cloud.

log_to_cloud

Boolean

Per reindirizzare i log dell'agente a Cloud Logging, specifica true. Il valore predefinito è true.

cloud_properties.project_id

String

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

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

cloud_properties.instance_name

String

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.

cloud_properties.region

String

Se il sistema SAP è in esecuzione su un server Bare Metal Solution, e specifica l'area geografica del server Bare Metal Solution.

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

cloud_properties.zone

String

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

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 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 che il sistema SAP è in esecuzione.

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

discovery_configuration.enable_workload_discovery

Boolean

Consentire all'agente di raccogliere i nomi e le versioni dei prodotti SAP. in esecuzione sull'host, specifica true. Il valore predefinito è true.

Per ulteriori informazioni, controlla il codebase dell'agente nella google-cloud-sap-agent repository GitHub in GoogleCloudPlatform/sapagent.

discovery_configuration.enable_discovery

Boolean

a inviare a Cloud Logging le informazioni raccolte dall'agente. per i prodotti SAP in esecuzione sull'host, specifica true. La il valore predefinito è true.

Se specifichi il valore false, l'agente archivia il valore ha raccolto informazioni sull'host e non le invia a Cloud Logging.

hana_monitoring_configuration.enabled

Boolean

Facoltativo. Consenti all'agente di Google Cloud per SAP di raccogliere i dati SAP HANA di monitoraggio delle metriche, 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 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 con l'agente Google Cloud per SAP, puoi sovrascrivere l'intervallo globale di esempio specificando l'intervallo richiesto al parametro sample_interval_sec. Gli intervalli di campionamento devono essere di 5 secondi o più a lungo.

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 al Istanze SAP HANA. Ogni query viene eseguita sul proprio thread. Il valore predefinito è 10.

hana_monitoring_configuration.hana_instances.name

String

Specifica l'identificatore del nome per la tua istanza SAP HANA.

hana_monitoring_configuration.hana_instances.sid

String

Specifica il SID della tua istanza SAP HANA. Questa stringa viene aggiunta come a tutte le metriche risultanti dall'esecuzione di query sulle tue istanze SAP HANA.

hana_monitoring_configuration.hana_instances.host

String

Specifica l'identificatore della macchina, locale o remota, che che ospita la tua 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 è un computer remoto, specifica il suo interno all'indirizzo IP esterno.
hana_monitoring_configuration.hana_instances.port

String

Specifica la porta su cui la tua istanza SAP HANA accetta le query. Per la prima o l'unica istanza 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.

Assicurati che questo utente abbia il privilegio di leggere le viste di monitoraggio nel tuo database SAP HANA. Se questo privilegio non viene concesso, il team SAP Le metriche di monitoraggio HANA relative alle viste di monitoraggio non contengono dati.

hana_monitoring_configuration.hana_instances.password

String

Facoltativo. Specifica la password, in testo normale, che esegue l'autenticazione l'account utente per eseguire query sull'istanza SAP HANA.

Per l'autenticazione, devi specificare una delle seguenti opzioni:

  • La password in testo normale per il parametro password.
  • (Consigliato) Se utilizzi Secret Manager per archiviare la password come secret, devi specificare il nome del secret corrispondente al parametro secret_name.
  • (Consigliato) Una chiave hdbuserstore per il parametro hdbuserstore_key.
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 connetterti in modo sicuro a un sistema SAP HANA, specifica un Chiave di archivio utenti sicuro (hdbuserstore) che hai creato di un sistema operativo completo.

Per utilizzare una chiave hdbuserstore per l'autenticazione, verifica quanto segue:

  • Gli strumenti SAP hdbsql e hdbuserstore sono installati sulla piattaforma 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.
  • L'utente SIDadm può eseguire query su SAP HANA utilizzando questa chiave. In questo caso SID si riferisce specificato per il parametro sid. Puoi per verificarlo eseguendo questo comando come SIDadm utente:
    hdbsql -U HDB_USERSTORE_KEY "SELECT * FROM DUMMY"

Questo parametro di configurazione è supportato dalla versione 3.3 dell'agente.

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

hana_monitoring_configuration.hana_instances.enable_ssl

Boolean

Facoltativo. Specifica se SSL è abilitato o meno in SAP HANA in esecuzione in un'istanza Compute Engine. Il valore predefinito è false.

hana_monitoring_configuration.hana_instances.host_name_in_certificate

String

Se specifichi enable_ssl: true per una richiesta SAP HANA istanza, devi specificare il nome host impostato nella certificato.

hana_monitoring_configuration.hana_instances.tls_root_ca_file

String

Se specifichi enable_ssl: true per una richiesta SAP HANA devi specificare il percorso per la configurazione certificato.

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

String

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

Int

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

String

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

String

Per la gestione tramite Monitoring, specifica una delle seguenti opzioni tipi di metriche: METRIC_LABEL, METRIC_GAUGE o METRIC_CUMULATIVE.

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

hana_monitoring_configuration.queries.columns.value_type

String

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: VALUE_BOOL, VALUE_INT64, VALUE_STRING o VALUE_DOUBLE. Per ulteriori informazioni, vedi Combinazione supportata.

hana_monitoring_configuration.queries.columns.name_override

String

Facoltativo. Per la gestione tramite Monitoring, specifica percorso che vuoi mostrare nell'URL della metrica anziché i nomi delle query e delle colonne. Ad esempio:

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

Visualizzare le metriche raccolte

Per visualizzare Metriche di monitoraggio di SAP HANA raccolte dall'agente, puoi usare 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 record dei numeri anomali, connessioni di sistema, avvisi, 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

  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 contenuti, 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 in progetto Google Cloud. Per visualizzare la dashboard, segui le istruzioni in Visualizza 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 file JSON corrispondente:

    gcloud monitoring dashboards create --config-from-file=CONFIG_FROM_FILE

    Sostituisci CONFIG_FROM_FILE con 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:

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

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