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

Impostare i ruoli IAM

Per consentire all'agente di Google Cloudper SAP 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, 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à 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.

Per un livello granulare di accesso, puoi impostare le seguenti autorizzazioni IAM sul tuo ruolo personalizzato:

  • Raccolta di metriche:
    • monitoring.timeSeries.create
  • Secret Manager:
    • secretmanager.versions.access

Per ulteriori informazioni su come creare un ruolo personalizzato, consulta Creare e gestire i ruoli personalizzati.

Attivare la raccolta delle metriche di monitoraggio di 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

I seguenti esempi sono file di configurazione completati dell'agente per SAP diGoogle Cloudin esecuzione su unIndividuazione di un'istanza Compute Engine, dove è 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 protetto (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
  },
  "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",
        "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
  },
  "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
      }
    ]
  }
}

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 protetto (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
  },
  "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",
        "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

I seguenti esempi sono file di configurazione completati dell'agente per SAP diGoogle Cloudin esecuzione su unserver Bare Metal Solution, dove è 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 protetto (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 protetto (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 diGoogle Cloudper SAP raccoglie le metriche di monitoraggio di 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 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 per SAP diGoogle Cloudo 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 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

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.

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.
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.
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 per il parametro sample_interval_sec. Gli intervalli di campionamento devono essere di almeno 5 secondi.
hana_monitoring_configuration.query_timeout_sec

Int

Facoltativo. Specifica il timeout per ogni query 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.
  • (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 è preferito rispetto al parametro password, che è preferito rispetto al 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 è preferito rispetto al parametro password, che è preferito rispetto al 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.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 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, collegamenti inattivi 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.

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