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

Questa guida mostra come configurare la versione 2 dell'agente di Google Cloud per SAP per raccogliere le metriche di monitoraggio di SAP HANA dai sistemi SAP HANA.

Per informazioni su questa funzionalità, consulta Monitoraggio di SAP HANA utilizzando l'agente di Google Cloud per SAP.

Prima di iniziare

Impostare i ruoli IAM

Per consentire all'Agent for SAP di Google Cloud di raccogliere le metriche di monitoraggio di SAP HANA, devi assicurarti che l'account di servizio utilizzato dall'istanza Compute Engine o dal server Bare Metal Solution includa i seguenti ruoli:

Per aggiungere questi ruoli obbligatori al tuo account di servizio:

  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à presente nell'elenco delle entità, non sono stati assegnati ruoli. Fai clic su Aggiungi e inserisci l'indirizzo email dell'account di servizio.
    • Se l'account di servizio è già presente nell'elenco dei principali, significa che ha già dei ruoli. Fai clic sul pulsante Modifica per l'account di servizio che vuoi modificare.

  4. Seleziona il ruolo richiesto dall'elenco dei ruoli disponibili:

    • Visualizzatore Compute
    • Monitoraggio > Monitoring Metric Writer
    • Secret Manager > Secret Manager Secret Accessor

  5. Fai clic su Aggiungi o Salva per applicare i ruoli all'account di servizio.

Attivare la raccolta delle metriche di monitoraggio SAP HANA

Per attivare la raccolta delle metriche di monitoraggio di SAP HANA utilizzando l'agente di Google Cloud per SAP, segui questi passaggi:

  1. Stabilisci una connessione SSH con l'istanza 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:

    • Per il parametro enabled, imposta il valore true.
    • Nella sezione hana_instances, specifica le istanze SAP HANA che vuoi monitorare con l'agente.
    • Se vuoi, puoi definire query personalizzate. Per informazioni sulla definizione di query personalizzate e per visualizzare esempi, consulta Definire query personalizzate.

    • Se vuoi, disattiva le query predefinite o integrate. Per le istruzioni, vedi Disattivare 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. A tale scopo, 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 Compute Engine

L'esempio seguente è un file di configurazione completo dell'agente per SAP di Google Cloud in esecuzione su un'istanza Compute Engine di un, dove è abilitata la raccolta delle metriche di monitoraggio di 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 Definire le 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": "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"
      },
      {
        "name": "remote",
        "sid": "DEH",
        "host": "10.123.0.12",
        "port": "30015",
        "user": "system",
        "secret_name": "password-secret-name"
      }
    ],
    "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'istanza Compute Engine di unserver Bare Metal Solution, dove è abilitata la raccolta delle metriche di monitoraggio di 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 Definire le 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"
      },
      {
        "name": "remote",
        "sid": "DEH",
        "host": "10.123.0.12",
        "port": "30015",
        "user": "system",
        "secret_name": "password-secret-name"
      }
    ],
    "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
      }
    ]
  }
}

Definire una query SQL personalizzata

L'agente di Google Cloud per SAP raccoglie le metriche di monitoraggio di SAP HANA eseguendo query SQL sulle 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 l'istanza 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 visualizzare esempi, consulta Definire query personalizzate.

  4. Per attivare una query personalizzata, imposta il relativo 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

Disattivare una query SQL

Se non vuoi eseguire nessuna delle query SQL predefinite fornite dall'agente di Google Cloud per SAP o nessuna delle query personalizzate che definisci, puoi disattivare la query SQL completando i seguenti passaggi:

  1. Stabilisci una connessione SSH con l'istanza 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 disattivare una query integrata o predefinita, includi quanto segue nella sezionehana_monitoring_configuration.queries:

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

    Sostituisci QUERY_NAME con il nome della query predefinita. Per informazioni sulle query predefinite, consulta Guida di riferimento alle query predefinite.

  4. Per disattivare una query personalizzata, imposta il parametro enabled su false per la query personalizzata in questione.

  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 dell'agente di Google Cloud per SAP specifici per la raccolta delle metriche di monitoraggio di SAP HANA.

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 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 ti venga 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 attivare il rilevamento del sistema SAP, specifica true. Il valore predefinito è true.
cloud_properties.project_id

String

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

Per impostazione predefinita, quando l'agente viene eseguito su un'istanza Compute Engine, rileva automaticamente l'ID progetto.
cloud_properties.instance_name

String

Se il sistema SAP è in esecuzione su un'istanza Compute Engine, specifica il nome dell'istanza di calcolo. L'agente rileva automaticamente il nome dell'istanza di calcolo al momento dell'installazione.

Se il sistema SAP è in esecuzione su un server Bare Metal Solution, specifica il nome del server. Nell'agente versione 2.5 o precedente, specifica il nome del server Bare Metal Solution per la proprietà instance_id.
cloud_properties.region

String

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

Per impostazione predefinita, quando l'agente viene eseguito su un'istanza di calcolo, utilizza la regione in cui è stato eseguito il deployment dell'istanza.
cloud_properties.zone

String

Quando l'agente viene eseguito su un'istanza di calcolo, per impostazione predefinita utilizza la zona in cui è dipiattaforma l'istanza di calcolo.
cloud_properties.image

String

Specifica il nome dell'immagine del sistema operativo dell'istanza.

Quando l'agente viene eseguito su un'istanza di calcolo, per impostazione predefinita rileva automaticamente l'immagine del sistema operativo utilizzata dall'istanza di calcolo.
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 di calcolo, per impostazione predefinita rileva automaticamente il numero del progetto.
hana_monitoring_configuration.enabled

Boolean

Facoltativo. Per consentire all'agente di Google Cloud per SAP di raccogliere le metriche di monitoraggio di 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 di Google Cloud per SAP 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 di Google Cloud per SAP, puoi sovrascrivere l'intervallo di campionamento globale specificando l'intervallo richiesto al 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 eseguita 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 in un 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 l'SID dell'istanza SAP HANA. Questa stringa viene aggiunta come etichetta a tutte le metriche risultanti dalla query delle 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 è un computer locale, specifica la stringa localhost o l'indirizzo IP loopback 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 l'istanza SAP HANA accetta le query. Per la prima o l'unica istanza del database del 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 visualizzazioni di monitoraggio nel database SAP HANA. Se questo privilegio non viene concesso, le metriche di monitoraggio di SAP HANA relative alle viste di monitoraggio non contengono dati.
hana_monitoring_configuration.hana_instances.password

String

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

Per l'autenticazione, devi specificare uno dei seguenti elementi:

  • La password in testo normale al parametro password.
  • (Consigliato) Se utilizzi Secret Manager per archiviare la password come secret, devi specificare il nome del secret corrispondente al parametro secret_name.
hana_monitoring_configuration.hana_instances.secret_name

String

Facoltativo. Specifica il nome del segreto in Secret Manager che memorizza la password dell'account utente.
hana_monitoring_configuration.hana_instances.enable_ssl

Boolean

Facoltativo. Specifica se SSL è attivo o meno nell'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 attivare una query SQL per tutte le 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 ogni query personalizzata.

Il nome della query deve essere univoco perché viene utilizzato per creare l'URL predefinito della metrica in Monitoraggio.
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 nel SAP HANA SQL and System Views Reference.
hana_monitoring_configuration.queries.sample_interval_sec

Int

Facoltativo. Specifica l'intervallo di campionamento per la query SQL. Questo sostituisce l'intervallo di campionamento globale. Il valore deve essere almeno di 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 Monitoraggio.
hana_monitoring_configuration.queries.columns.metric_type

String

Per la gestione da parte di Monitoring, specifica uno dei seguenti tipi di metrica: 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 Monitoraggio.
hana_monitoring_configuration.queries.columns.value_type

String

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

I tipi di dati supportati sono: VALUE_BOOL, VALUE_INT64, VALUE_STRING o VALUE_DOUBLE. Per ulteriori informazioni, consulta Combinazione supportata.
hana_monitoring_configuration.queries.columns.name_override

String

Facoltativo. Per la gestione da parte di Monitoraggio, specifica il percorso da 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 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:

  • Agente per SAP - Panoramica dettagliata di HANA: questa dashboard fornisce grafici che mostrano una panoramica dello stato per le seguenti metriche: memoria dell'istanza, memoria del servizio utilizzata, memoria massima stimata dello schema, dimensione totale della memoria del rowstore, valori anomali di lettura dello schema, valori anomali di scrittura dello schema, valori anomali del conteggio dei record dell'ultimo schema compresso, connessioni di sistema, avvisi, percentuale di CPU per le prime 5 istanze di calcolo, percentuale di memoria per le prime 5 istanze di calcolo e gli host per regione.

    Il file JSON di questa dashboard è agent-for-sap-hana-detailed-overview.json.

  • Agent for SAP - Prestazioni HANA: questa dashboard fornisce grafici che mostrano i valori non elaborati delle seguenti metriche: memoria dell'istanza, valori anomali di lettura e scrittura dello schema, prestazioni dello schema, utilizzo della memoria, valori anomali del conteggio dei record dello schema, memoria totale del servizio utilizzata, dimensione della memoria del rowstore, connessione inutilizzata e in esecuzione del sistema, memoria della connessione e del rowstore, record totali dello schema e dimensione totale massima stimata dello schema.

    Il file JSON di questa dashboard è agent-for-sap-hana-performance.json.

Installare le dashboard

Per installare una dashboard personalizzata:

Console Google Cloud

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

    Vai a Monitoring

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

  3. Fai clic sulla scheda Raccolta di esempi.

    Visualizzazione della scheda della raccolta di esempi selezionata.

  4. Per filtrare le dashboard personalizzate specifiche per 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 che vuoi installare.

  7. Fai clic su Importa e poi su Conferma.

    La dashboard viene aggiunta alle dashboard disponibili nel progetto Google Cloud. Per visualizzare la dashboard, segui le istruzioni riportate 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 riportate in Visualizzare la dashboard installata.

Visualizzare le dashboard installate

Per visualizzare le dashboard installate:

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

    Vai a Monitoring

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

  3. Fai clic sul nome della dashboard nell'elenco.

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