Configura la raccolta delle metriche di monitoraggio SAP HANA

Questa guida mostra come configurare l'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 Monitoraggio di SAP HANA utilizzando l'agente per SAP di Google Cloud.

Prima di iniziare

Imposta ruoli IAM

Per consentire all'agente di Google Cloud per SAP di raccogliere le metriche di monitoraggio SAP HANA, devi assicurarti che l'account di servizio utilizzato dall'istanza VM di Compute Engine o dal server Bare Metal Solution includa 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 avrà alcun ruolo assegnato. Fai clic su Aggiungi e inserisci l'indirizzo email dell'account di servizio.
    • Se l'account di servizio è già nell'elenco delle entità, ha 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 monitoraggio di SAP HANA utilizzando l'agente per SAP di Google Cloud, segui questi passaggi:

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

  2. Apri il file di configurazione dell'agente:

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

    In alternativa, puoi eseguire questa configurazione tramite comandi. Per maggiori informazioni, consulta 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 devono essere monitorate dall'agente.
    • Facoltativamente, definisci query personalizzate. Per informazioni sulla definizione di query personalizzate e per consultare gli esempi, consulta Definizione delle query personalizzate.

    • Se vuoi, disattiva le query integrate o predefinite. Per le istruzioni, consulta 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 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 unIstanza VM di 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 delle 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 unserver 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 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 consultare gli esempi, consulta Definizione delle 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 alcuna query SQL integrata fornita dall'agente per SAP di Google Cloud per impostazione predefinita o nessuna delle query personalizzate che definisci, puoi disabilitare la query SQL completando i passaggi riportati di seguito:

  1. Stabilisci una connessione SSH con la tua istanza VM di Compute Engine o 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 alle 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 seguente tabella illustra i parametri di configurazione dell'agente per SAP di Google Cloud specifici per la raccolta delle metriche di SAP HANA Monitoring.

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 richiesto dall'assistenza clienti Google Cloud o dall'Assistenza SAP.

bare_metal

Boolean

Quando l'agente viene 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 richiesto 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 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 tuo sistema SAP è in esecuzione su un'istanza VM di Compute Engine, specifica il nome dell'istanza VM. L'agente rileva automaticamente il nome dell'istanza VM al momento dell'installazione.

Se il tuo sistema SAP è in esecuzione su un server Bare Metal Solution, specifica il nome del server.
cloud_properties.region

String

Se il 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 in cui è installato.
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 per l'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.
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.
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 maggiori informazioni, consulta il codebase dell'agente nel repository GitHub di google-cloud-sap-agent 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 archivia le informazioni raccolte sull'host e non le invia a Cloud Logging.

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 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 per SAP di Google Cloud 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 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 avere una durata minima di 5 secondi.
hana_monitoring_configuration.query_timeout_sec

Int

Facoltativo. Specifica il timeout per ogni query effettuata alle 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 l'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 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 del 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 la tua istanza SAP HANA accetta le query. Per la prima o la sola 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 le 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 che siano soddisfatte le seguenti condizioni:

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

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 è 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 per il 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 specifica.
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 Monitoring.
hana_monitoring_configuration.queries.sql

String

Specifica l'istruzione SQL inviata dall'agente alle tue istanze SAP HANA.

L'istruzione SQL deve essere conforme alla sintassi SQL definita da SAP nel documento SAP HANA SQL and System Views.
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 durare almeno 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 Monitoring.
hana_monitoring_configuration.queries.columns.metric_type

String

Per la gestione da parte di 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 sezione Combinazione supportata.
hana_monitoring_configuration.queries.columns.name_override

String

Facoltativo. Per la gestione da parte di Monitoring, specifica il percorso da visualizzare nell'URL della metrica anziché i nomi della query e della colonna. 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 - Details HANA Overview: 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, dimensioni totali della memoria di rowstore, outlier di lettura dello schema, outlier di scrittura dello schema, outlier del conteggio dell'ultimo 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 - HANA performance: questa dashboard fornisce grafici che mostrano i valori delle metriche non elaborati per le seguenti metriche: memoria dell'istanza, valori anomali di lettura e scrittura dello schema, prestazioni degli schemi, utilizzo della memoria, valori anomali del numero di record di schema, memoria totale del servizio utilizzata, dimensioni della memoria rowstore, connessioni inattive e in esecuzione di sistema, memoria delle connessioni e rowstore, 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 esempio.

    Visualizzazione della scheda della raccolta di esempi selezionata.

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

  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 e poi su Conferma.

    La dashboard viene aggiunta alle dashboard disponibili nel progetto Google Cloud. Per vedere 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 che contiene la configurazione della dashboard. I file di configurazione della dashboard possono essere trovati nel percorso: monitoring-dashboard-samples/dashboards/google-cloud-agent-for-sap.

    La dashboard viene aggiunta alle dashboard disponibili nel tuo progetto Google Cloud. Per vedere 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 disponi di molte dashboard, puoi filtrare in base alle dashboard personalizzate o 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.

Lo screenshot mostra la dashboard personalizzata per le metriche SAP HANA in Monitoring