Configura la raccolta delle metriche di monitoraggio SAP HANA

Questa guida mostra come configurare l'agente per SAP di Google Cloudper raccogliere le metriche di monitoraggio di SAP HANA dai sistemi SAP HANA.

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

Prima di iniziare

Ruoli IAM obbligatori

Per assicurarti che l'account di servizio disponga delle autorizzazioni necessarie per consentire all'agente di Google Cloudper SAP di raccogliere le metriche di monitoraggio di SAP HANA, chiedi all'amministratore di concedere all'account di servizio i seguenti ruoli IAM nel progetto:

Per saperne di più sulla concessione dei ruoli, consulta Gestisci l'accesso a progetti, cartelle e organizzazioni.

Questi ruoli predefiniti contengono le autorizzazioni necessarie per consentire all'agente di Google Cloudper SAP di raccogliere le metriche di monitoraggio di SAP HANA. Per visualizzare le autorizzazioni esatte richieste, espandi la sezione Autorizzazioni richieste:

Autorizzazioni obbligatorie

Per consentire all'agente di Google Cloudper SAP di raccogliere le metriche di monitoraggio di SAP HANA, sono necessarie le seguenti autorizzazioni:

  • Per raccogliere le metriche di monitoraggio di SAP HANA dall'istanza Compute Engine host e scriverle in Cloud Monitoring:
    • monitoring.timeSeries.create
    • compute.nodeGroups.get
    • compute.nodeGroups.list
  • Se utilizzi Secret Manager per archiviare la password per connetterti al database SAP HANA, per accedere al secret: secretmanager.versions.access

L'amministratore potrebbe anche assegnare all'account di servizio queste autorizzazioni con ruoli personalizzati o altri ruoli predefiniti.

Ruoli SAP HANA obbligatori

Per consentire all'agente di raccogliere le metriche dal database SAP HANA, assicurati che l'utente SAP HANA specificato nel file di configurazione dell'agente abbia il ruolo MONITORING.

Per informazioni su questo ruolo, consulta il documento SAP Ruoli di database standard.

Attivare la raccolta delle metriche di monitoraggio SAP HANA

Per attivare la raccolta delle metriche di monitoraggio di SAP HANA utilizzando Agente per SAP diGoogle Cloud, 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

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

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

Gli esempi seguenti sono file di configurazione completi dell'agente per SAP diGoogle Cloudin esecuzione su un istanza Compute Engine, in cui è abilitata la raccolta delle metriche di monitoraggio di SAP HANA. Tieni presente che la query personalizzata inclusa in questi esempi, denominata custom_query, segue le linee guida per la definizione delle query personalizzate specificate in Definire le query personalizzate.

L'esempio seguente utilizza una chiave del repository degli utenti sicuri (hdbuserstore) per l'autenticazione SAP HANA:

{
  "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
  },
  "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",
        "user": "system",
        "hdbuserstore_key": "user_store_key"
      },
      {
        "name": "remote",
        "sid": "DEH",
        "user": "system",
        "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
      }
    ]
  }
}

L'esempio seguente utilizza un nome utente e un segreto Secret Manager per l'autenticazione SAP HANA:

{
  "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
  },
  "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
      }
    ]
  }
}

L'esempio seguente utilizza un nome utente e una password per l'autenticazione SAP HANA. Ti consigliamo di utilizzare un secret di Secret Manager o una chiave del repository degli utenti protetti (hdbuserstore) per l'autenticazione SAP HANA.

{
  "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
  },
  "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",
        "password": "TempPa55word"
      },
      {
        "name": "remote",
        "sid": "DEH",
        "host": "10.123.0.12",
        "port": "30015",
        "user": "system",
        "password": "TempPa55word"
      }
    ],
    "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

Gli esempi seguenti sono file di configurazione completi dell'agente per SAP diGoogle Cloudin esecuzione su un server Bare Metal Solution, in cui è abilitata la raccolta delle metriche di monitoraggio di SAP HANA. Tieni presente che la query personalizzata inclusa in questi esempi, denominata custom_query, segue le linee guida per la definizione delle query personalizzate specificate in Definire le query personalizzate.

L'esempio seguente utilizza una chiave del repository degli utenti sicuri (hdbuserstore) per l'autenticazione SAP HANA:

{
  "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",
        "user": "system",
        "hdbuserstore_key": "user_store_key"
      },
      {
        "name": "remote",
        "sid": "DEH",
        "user": "system",
        "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
      }
    ]
  }
}

L'esempio seguente utilizza un nome utente e un segreto Secret Manager per l'autenticazione SAP HANA:

{
  "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
      }
    ]
  }
}

L'esempio seguente utilizza un nome utente e una password per l'autenticazione SAP HANA. Ti consigliamo di utilizzare un secret di Secret Manager o una chiave del repository degli utenti protetti (hdbuserstore) per l'autenticazione SAP HANA.

{
  "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",
        "password": "TempPa55word"
      },
      {
        "name": "remote",
        "sid": "DEH",
        "host": "10.123.0.12",
        "port": "30015",
        "user": "system",
        "password": "TempPa55word"
      }
    ],
    "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 per SAP diGoogle Cloudraccoglie 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. Se utilizzi la versione 3.7 dell'agente, per i sistemi SAP HANA ad alta disponibilità eseguiti con la configurazione Attivo/attivo (lettura abilitata), puoi specificare se la query deve essere eseguita sul nodo principale, su quello secondario o su entrambi i nodi del sistema ad alta disponibilità:

    • Per eseguire una query sul nodo principale, includi "run_on": "PRIMARY".
    • Per eseguire una query sul nodo principale, includi "run_on": "SECONDARY".
    • Per eseguire una query sul nodo principale, includi "run_on": "ALL".

    Per saperne di più, consulta Configurare il monitoraggio specifico dei nodi per un sistema SAP HANA HA.

  6. Salva il file di configurazione.

  7. 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 per SAP diGoogle Cloudo nessuna delle query personalizzate che hai definito, 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 Riferimento alle query predefinite.

  4. Per disattivare una query personalizzata, imposta il parametro enabled su false per quella query personalizzata.

  5. Salva il file di configurazione.

  6. Riavvia l'agente per applicare le nuove impostazioni:

    sudo systemctl restart google-cloud-sap-agent

Configurare il monitoraggio specifico del tenant per un database SAP HANA multi-tenant

Dalla versione 3.7 dell'agente per SAP di Google Cloud, puoi configurare il monitoraggio specifico per i tenant per i database SAP HANA multi-tenant. Per farlo, segui questa procedura.

  1. Assicurati di utilizzare la versione 3.7 o successive di Agent for SAP di Google Cloud.
  2. Stabilisci una connessione SSH con l'istanza Compute Engine o con il server Bare Metal Solution.

  3. Apri il file di configurazione dell'agente:

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

  4. Nella sezione hana_monitoring_configuring.hana_instances, per ogni SAP HANA che hai definito, applica la configurazione appropriata:

    • Per eseguire un insieme specifico di query su un'istanza SAP HANA, includi il parametroqueries_to_run.query_name come segue.
    • Per eseguire tutte le query su un'istanza SAP HANA, includi il parametro queries_to_run.run_all come segue.

    Il seguente snippet mostra esempi di queste opzioni:

     "hana_monitoring_configuration": {
   "enabled": true,
   ...
   "hana_instances": [
     {
       "name": "TENANT_DB_1_NAME",
       "sid": "SID",
       ...
       "queries_to_run": {
         "query_name": ["QUERY_NAME_1", "QUERY_NAME_2", ...]
       }
     },
     {
       "name": "TENANT_DB_2_NAME",
       "sid": "SID",
       ...
       "queries_to_run": {
         "run_all": true
       }
     }
     ...
   ]
 }

  5. Salva il file di configurazione.

  6. Entro i 30 secondi successivi, la nuova configurazione diventa effettiva. In alternativa, puoi riavviare manualmente l'agente.

Configurare il monitoraggio specifico dei nodi per un sistema SAP HANA HA

A partire dalla versione 3.7 dell'agente per SAP di Google Cloud, per i sistemi SAP HANA ad alta disponibilità di cui è stato eseguito il deployment con la configurazione Attivo/attivo (lettura abilitata), puoi specificare se le query definite nel file di configurazione dell'agente devono essere eseguite sul nodo principale, sul nodo secondario o su entrambi. A tale scopo, completa i seguenti passaggi:

  1. Assicurati di utilizzare la versione 3.7 o successive di Agent for SAP di Google Cloud.
  2. Stabilisci una connessione SSH con l'istanza Compute Engine o con il server Bare Metal Solution.

  3. Apri il file di configurazione dell'agente:

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

  4. Nella sezione hana_monitoring_configuring.queries, per ogni query che hai definito, applica la configurazione appropriata:

    • Per eseguire una query sul nodo principale, includi "run_on": "PRIMARY".
    • Per eseguire una query sul nodo principale, includi "run_on": "SECONDARY".
    • Per eseguire una query sul nodo principale, includi "run_on": "ALL".

  5. Nella sezione hana_monitoring_configuration.hana_instances, per ogni istanza SAP HANA che hai definito, specifica i parametri instance_num e is_local.

    Lo snippet seguente mostra esempi di tutti gli scenari:

     "hana_monitoring_configuration": {
   "enabled": true,
   ...
   "hana_instances": [
     {
        "name": "INSTANCE_NAME",
        "sid": "SID",
        "instance_num": "10",
        "is_local": true,
        "hdbuserstore_key": "USER_STORE_KEY"
     },
     {
        "name": "INSTANCE_NAME",
        "sid": "SID",
        "instance_num": "11"
        "is_local": true,
        "hdbuserstore_key": "USER_STORE_KEY"
     },
     ...
   ],
   ...
   "queries": [
     {
        "name": "QUERY_NAME_1",
        "enabled": true,
        "run_on": "PRIMARY",
        ...
     },
     {
        "name": "QUERY_NAME_2",
        "enabled": true,
        "run_on": "SECONDARY",
        ...
     },
     {
        "name": "QUERY_NAME_3",
        "enabled": true,
        "run_on": "ALL",
        ...
     }
     ...
   ]
 }

  6. Salva il file di configurazione.

  7. Entro i 30 secondi successivi, la nuova configurazione diventa effettiva. In alternativa, puoi riavviare manualmente l'agente.

Parametri di configurazione

La tabella seguente illustra i parametri di configurazione dell'agente per SAP diGoogle Cloudspecifici 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.
cloud_properties.project_id

String

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

Quando l'agente viene eseguito su un'istanza Compute Engine, per impostazione predefinita 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.
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 è dipiegato.
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 Google Cloud progetto 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.
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 ulteriori informazioni, consulta il codice dell'agente nel google-cloud-sap-agent repository GitHub 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 memorizza le informazioni raccolte sull'host e non le invia a Cloud Logging.

hana_monitoring_configuration.enabled

Boolean

Facoltativo. Per consentire all'agente per SAP di Google Clouddi 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 per SAP di Google Cloudesegue 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 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.send_query_response_time

Boolean

Facoltativo. Specifica true per consentire all'agente di acquisire il tempo di risposta per ogni query di monitoraggio SAP HANA definita nel file di configurazione dell'agente.
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.
  • (Consigliato) Una chiave hdbuserstore per il parametro hdbuserstore_key.

Per l'autenticazione SAP HANA, l'agente utilizza il seguente ordine di preferenza: se specificato, il parametro di configurazione hdbuserstore_key ha la precedenza sul parametro password, che ha la precedenza sul parametro secret_name. Ti consigliamo di impostare una sola opzione di autenticazione nel file di configurazione.
hana_monitoring_configuration.hana_instances.secret_name

String

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

Per l'autenticazione SAP HANA, l'agente utilizza il seguente ordine di preferenza: se specificato, il parametro di configurazione hdbuserstore_key ha la precedenza sul parametro password, che ha la precedenza sul parametro secret_name. Ti consigliamo di impostare una sola opzione di autenticazione nel file di configurazione.
hana_monitoring_configuration.hana_instances.hdbuserstore_key

String

Per connetterti in sicurezza a un sistema SAP HANA, specifica una chiave Secure User Store (hdbuserstore) che hai creato per quel sistema.

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

  • Gli strumenti SAP hdbsql e hdbuserstore sono installati sull'istanza di calcolo che ospita l'agente.
  • La chiave hdbuserstore corrisponde a un'istanza SAP HANA specifica. Non puoi utilizzare chiavi che contengono gli hostname di più istanze SAP HANA.
  • L'utente SIDadm può eseguire query sul database SAP HANA utilizzando questa chiave. Qui SID si riferisce al valore specificato per il parametro sid. Puoi verificarlo eseguendo il seguente comando come utente SIDadm: 
    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 la specifica dei parametri host e port.
hana_monitoring_configuration.hana_instances.is_local

Boolean

Per il monitoraggio dei sistemi HA, specifica true per indicare all'agente che l'istanza SAP HANA definita è ospitata sulla stessa istanza Compute Engine dell'agente. In questo modo, l'agente controlla in fase di esecuzione se l'istanza SAP HANA definita è il node principale o secondario nel sistema HA. Questa consapevolezza è necessaria da parte dell'agente per eseguire le query di monitoraggio di SAP HANA sul tipo di istanza SAP HANA specificato per il parametro queries.run_on.

Il valore predefinito per questo parametro è false, che consente all'agente di eseguire tutte le query di monitoraggio SAP HANA abilitate sull'istanza SAP HANA corrispondente. Per ulteriori informazioni, consulta Monitoraggio per sistemi multi-tenant e HA.

Questo parametro è supportato dalla versione 3.7 dell'agente.
hana_monitoring_configuration.hana_instances.instance_num

String

Specifica il numero di istanza che hai impostato per l'istanza SAP HANA. Queste informazioni sono necessarie per consentire all'agente di rilevare l'istanza SAP HANA.

Questo parametro è supportato dalla versione 3.7 dell'agente.
hana_monitoring_configuration.hana_instances.queries_to_run.run_all

Boolean

Facoltativo. Specifica true per eseguire tutte le query di monitoraggio di SAP HANA, predefinite e personalizzate, abilitate nel file di configurazione dell'agente nell'istanza SAP HANA specificata. Il valore predefinito è false.
hana_monitoring_configuration.hana_instances.queries_to_run.query_name

String

Facoltativo. Specifica le query da eseguire sull'istanza SAP HANA specificata.

Se utilizzi un database SAP HANA multi-tenant, puoi configurare il monitoraggio specifico del tenant utilizzando questo parametro di configurazione. Nel seguente esempio di configurazione, vengono eseguite due query su HANA_TENANT_1 e tutte le query definite nella configurazione vengono eseguite su HANA_TENANT_2:

    "hana_instances": [
      {
        "name": "HANA_TENANT_1,
        "queries_to_run": {
          "query_name": ["QUERY_NAME_1", "QUERY_NAME_2"]
        }
      },
      {
        "name": "HANA_TENANT_2,
        "queries_to_run": {
          "run_all": true
        }
      }
      ...
    ]
hana_monitoring_configuration.hana_instances.enable_ssl

Boolean

Facoltativo. Specifica se il protocollo 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.run_on

String

Facoltativo. Specifica questo parametro se stai monitorando un sistema SAP HANA HA e vuoi eseguire le query di monitoraggio di SAP HANA sul node primario o su quello secondario. Valori supportati: PRIMARY, SECONDARY, ALL. Quando specifichi il valore ALL, l'agente esegue le query di monitoraggio di SAP HANA su entrambi i nodi principali e secondari del cluster HA.

Questo parametro è supportato dalla versione 3.7 dell'agente. Inoltre, per eseguire le query sul nodo secondario, assicurati che il sistema HA sia disegnato con la configurazione Active/Active (lettura abilitata).

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

Convalida la configurazione per la raccolta delle metriche di monitoraggio di SAP HANA

Puoi verificare se hai eseguito la corretta Google Cloud configurazione per la raccolta delle metriche di monitoraggio di SAP HANA eseguendo il comando status dell'agente. Questo comando è supportato dalla versione 3.7 dell'agente.

A tale scopo, completa i seguenti passaggi:

  1. Stabilisci una connessione SSH con l'istanza Compute Engine o con il server Bare Metal Solution.

  2. Esegui questo comando:

    sudo /usr/bin/google_cloud_sap_agent status

    Se la Google Cloud configurazione per la raccolta delle metriche di monitoraggio di SAP HANA è corretta, l'output include quanto segue. La configurazione potrebbe avere valori diversi da quelli di default.

     Agent Status:
    ...
    Systemd Service Enabled: True
    Systemd Service Running: True
    Cloud API Full Scopes: True
    Configuration File: /etc/google-cloud-sap-agent/configuration.json
    Configuration Valid: True
...
----------------------------------------------------------------------------
HANA Monitoring Metrics: Enabled
    Status: Fully Functional
    IAM Permissions: All granted
    Configuration:
        connection_timeout:       120   (default)
        enabled:                  true  (configuration file)
        execution_threads:        10    (default)
        max_connect_retries:      1     (default)
        query_timeout_sec:        300   (default)
        sample_interval_sec:      300   (default)
        send_query_response_time: false (default)
...

  3. Se l'output indica che manca una configurazione, esamina le informazioni fornite nelle sezioni precedenti, esegui le azioni richieste e poi esegui nuovamente il comando status per convalidare nuovamente la configurazione.

Visualizzare le metriche raccolte

Per visualizzare le metriche di monitoraggio SAP HANA raccolte dall'agente, puoi utilizzare le seguenti dashboard personalizzate fornite daGoogle 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, connessioni inattive 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:

Google Cloud console

  1. Nella Google Cloud console, 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 Google Cloud progetto. 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 Google Cloud progetto. Per visualizzare la dashboard, segui le istruzioni riportate in Visualizzare la dashboard installata.

Visualizzare le dashboard installate

Per visualizzare le dashboard installate:

  1. Nella Google Cloud console, 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.

La schermata di acquisizione mostra la dashboard personalizzata per le metriche SAP HANA in Monitoraggio