Configurare la raccolta delle metriche di monitoraggio dei processi

Questa guida mostra come configurare l'agente di Google Cloud per SAP per raccogliere le metriche di monitoraggio dei processi dai sistemi SAP.

Per informazioni su questa funzione, vedi Monitoraggio dei processi utilizzando l'agente di Google Cloud per SAP.

Prima di iniziare

Imposta ruoli IAM

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

Per aggiungere questi ruoli obbligatori al tuo account di servizio, segui questi passaggi:

  1. Nella console Google Cloud, vai alla pagina IAM.

    Vai a IAM

  2. Selezionare il tuo progetto Google Cloud.

  3. Identifica l'account di servizio a cui vuoi aggiungere un ruolo.

    • Se l'account di servizio non è già nell'elenco delle entità, non gli sono stati assegnati ruoli. Fai clic su Aggiungi e inserisci all'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 modifica.

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

    • Visualizzatore Compute
    • Monitoraggio > Writer metriche Monitoring
    • Secret Manager > Funzione di accesso ai secret di Secret Manager

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

Abilita la raccolta delle metriche di Process Monitoring

Per abilitare la raccolta di metriche di Process Monitoring utilizzando di Google Cloud per SAP, segui questi passaggi:

  1. Stabilisci una connessione SSH con la tua istanza VM host.

  2. Apri il file di configurazione dell'agente:

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

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

  3. Nella sezione collection_configuration:

    • Per il parametro collect_process_metrics, specifica il valore true.
    • Per attivare la raccolta delle metriche di monitoraggio dei processi relative alle tue istanze di database SAP HANA, devi configurare parametri aggiuntivi nella sezione hana_metrics_config. Per informazioni su questi consulta Parametri di configurazione.

  4. Se vuoi, nella sezione cloud_properties puoi aggiornare i valori dei parametri impostati automaticamente. A questo scopo, aggiungi la sezione cloud_properties al tuo di configurazione del deployment e specificare i parametri richiesti e i relativi valori.

  5. Salva il file di configurazione.

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

    sudo systemctl restart google-cloud-sap-agent

File di configurazione di esempio

Istanza VM di Compute Engine

I seguenti esempi sono file di configurazione completati di Google Cloud per SAP, in esecuzione su una Istanza VM Compute Engine, in cui è abilitata la raccolta di metriche di Process Monitoring:

Per l'autenticazione SAP HANA, l'agente utilizza il seguente ordine di preferenza: se specificata, la configurazione hdbuserstore_key è preferibile utilizzare il parametro hana_db_password, che è preferibile al parametro hana_db_password_secret_name. Ti consigliamo di impostare una sola opzione di autenticazione nel file di configurazione.

  • 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": true,
    "process_metrics_frequency": 5,
    "slow_process_metrics_frequency": 30,
    "hana_metrics_config": {
      "hana_db_user": "db_user_name",
      "sid": "DEH",
      "hdbuserstore_key": "user_store_key"
    }
  },
  "cloud_properties": {
    "project_id": "my-project",
    "instance_name": "vm-instance-1",
    "image": "rhel-8"
  },
  "discovery_configuration": {
    "enable_discovery": true,
    "enable_workload_discovery": true
  },
  "hana_monitoring_configuration": {
    "enabled": false
  }
}
  • L'esempio seguente utilizza un nome utente e Secret Manager secret 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": true,
    "process_metrics_frequency": 5,
    "slow_process_metrics_frequency": 30,
    "hana_metrics_config": {
      "hana_db_user": "db_user_name",
      "sid": "DEH",
      "hana_db_password_secret_name": "db_pwd_secret_name"
    }
  },
  "cloud_properties": {
    "project_id": "my-project",
    "instance_name": "vm-instance-1",
    "image": "rhel-8"
  },
  "discovery_configuration": {
    "enable_discovery": true,
    "enable_workload_discovery": true
  },
  "hana_monitoring_configuration": {
    "enabled": false
  }
}
  • L'esempio seguente utilizza un nome utente e una password per SAP HANA autenticazione. Ti consigliamo di utilizzare invece una Secret Manager o Chiave archivio utenti sicuro (hdbuserstore) per 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": true,
    "process_metrics_frequency": 5,
    "slow_process_metrics_frequency": 30,
    "hana_metrics_config": {
      "hana_db_user": "db_user_name",
      "sid": "DEH",
      "hana_db_password": "TempPa55word"
    }
  },
  "cloud_properties": {
    "project_id": "my-project",
    "instance_name": "vm-instance-1",
    "image": "rhel-8"
  },
  "discovery_configuration": {
    "enable_discovery": true,
    "enable_workload_discovery": true
  },
  "hana_monitoring_configuration": {
    "enabled": false
  }
}

Server Bare Metal Solution

I seguenti esempi sono file di configurazione completati di Agent for SAP di Google Cloud, in esecuzione su unserver Bare Metal Solution, in cui è abilitata la raccolta delle metriche di monitoraggio dei processi:

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 hana_db_password, che è preferito rispetto al parametro hana_db_password_secret_name. Ti consigliamo di impostare una sola opzione di autenticazione nel file di configurazione.

  • 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": true,
    "process_metrics_frequency": 5,
    "slow_process_metrics_frequency": 30,
    "hana_metrics_config": {
      "hana_db_user": "db_user_name",
      "sid": "DEH",
      "hdbuserstore_key": "user_store_key"
    }
  },
  "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": 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": true,
    "process_metrics_frequency": 5,
    "slow_process_metrics_frequency": 30,
    "hana_metrics_config": {
      "hana_db_user": "db_user_name",
      "sid": "DEH",
      "hana_db_password_secret_name": "db_pwd_secret_name"
    }
  },
  "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": false
  }
}
  • L'esempio seguente utilizza un nome utente e una password per SAP HANA autenticazione. Ti consigliamo di utilizzare invece una Secret Manager o Chiave archivio utenti sicuro (hdbuserstore) per 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": true,
    "process_metrics_frequency": 5,
    "slow_process_metrics_frequency": 30,
    "hana_metrics_config": {
      "hana_db_user": "db_user_name",
      "sid": "DEH",
      "hana_db_password": "TempPa55word"
    }
  },
  "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": false
  }
}

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

Parametri
provide_sap_host_agent_metrics

Boolean

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

bare_metal

Boolean

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

String

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

  • DEBUG
  • INFO
  • WARNING
  • ERROR

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

Boolean

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

String

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

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

String

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

Se il sistema SAP è in esecuzione su un server Bare Metal Solution: specifica il nome di quel server.
cloud_properties.region

String

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

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

String

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

String

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

Quando l'agente viene eseguito su un'istanza VM, per impostazione predefinita rileva l'immagine del sistema operativo dell'istanza VM su cui è installato.
cloud_properties.numeric_project_id

String

Specifica l'ID numerico del progetto Google Cloud in cui è in esecuzione il sistema SAP.

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

Boolean

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

Per ulteriori informazioni, controlla il codebase dell'agente nella 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. La il valore predefinito è true.

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

collection_configuration.collect_process_metrics

Boolean

Per abilitare la raccolta delle metriche di monitoraggio dei processi, specifica true. Il valore predefinito è false.
Questo parametro è applicabile solo a Linux.

Se attivi la raccolta delle metriche di processo per SAP HANA, devi configurare i parametri aggiuntivi elencati in hana_metrics_config.
collection_configuration.process_metrics_frequency

Int

Dalla versione 2.6, questo parametro determina la frequenza di raccolta delle metriche di monitoraggio dei processi in rapida evoluzione, in secondi. Le metriche di monitoraggio dei processi in rapida evoluzione sono: sap/hana/availability, sap/hana/ha/availability e sap/nw/availability.

Il valore predefinito di questo parametro è 5 secondi. Ti consigliamo di utilizzare questo valore predefinito.

Tutte le altre metriche di Process Monitoring (in lento cambiamento) vengono raccolte in un frequenza predefinita di 30 secondi. Per modificare la frequenza di raccolta delle metriche di monitoraggio dei processi con variazioni lente, utilizza il parametro slow_process_metrics_frequency.
collection_configuration.slow_process_metrics_frequency

Int

Specifica la frequenza di raccolta delle metriche di monitoraggio dei processi con variazioni lente, in secondi.

Il valore predefinito di questo parametro è 30 secondi.
collection_configuration.process_metrics_to_skip

Array

Specifica le metriche di monitoraggio dei processi che non vuoi che l'agente raccolga. Questo parametro accetta un parametro valore separato da virgole dei nomi delle metriche di Process Monitoring. Ad esempio: "process_metrics_to_skip": ["/sap/nw/abap/sessions", "/sap/nw/abap/rfc"].

collection_configuration.hana_metrics_config.hana_db_user

String

Specifica l'account utente del database utilizzato dall'agente per eseguire query su SAP HANA. Il valore predefinito è SYSTEM.
collection_configuration.hana_metrics_config.hana_db_password

String

Specifica la password in testo normale per l'account utente del database utilizzato dall'agente per eseguire query su SAP HANA.

Anziché specificare una password in testo normale, ti consigliamo di utilizzare una delle seguenti opzioni:

Per l'autenticazione SAP HANA, l'agente utilizza il seguente ordine di preferenza: se specificata, la configurazione hdbuserstore_key è preferibile utilizzare il parametro hana_db_password, che è preferibile al parametro hana_db_password_secret_name. Ti consigliamo di impostare una sola opzione di autenticazione nel file di configurazione.

collection_configuration.hana_metrics_config.hana_db_password_secret_name

String

Per fornire in modo sicuro la password per l'account utente del database utilizzato dall'agente per eseguire query su SAP HANA, specifica il nome del token segreto che contiene le credenziali di sicurezza per l'account utente del database.

L'agente raccoglie le metriche relative a SAP HANA solo se specifichi hana_db_password_secret_name, hdbuserstore_key o hana_db_password.

Per l'autenticazione SAP HANA, l'agente utilizza il seguente ordine di preferenza: se specificata, la configurazione hdbuserstore_key è preferibile utilizzare il parametro hana_db_password, che è preferibile al parametro hana_db_password_secret_name. Ti consigliamo di impostare una sola opzione di autenticazione nel file di configurazione.

collection_configuration.hana_metrics_config.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 sulla piattaforma 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 per verificarlo eseguendo questo comando come SIDadm utente: 
    hdbsql -U HDB_USERSTORE_KEY "SELECT * FROM DUMMY"

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

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 hana_db_password, che è preferito rispetto al parametro hana_db_password_secret_name. Ti consigliamo di impostare una sola opzione di autenticazione nel file di configurazione.

collection_configuration.hana_metrics_config.sid

String

Specifica il SID della tua istanza SAP HANA. Se utilizzi una chiave hdbuserstore per l'autenticazione in SAP HANA, quindi fai riferimento Sezione hdbuserstore_key.

Visualizzare le metriche raccolte

Per visualizzare le metriche di monitoraggio dei processi raccolte dall'agente, puoi utilizzare le seguenti dashboard personalizzate fornite da Google Cloud:

  • Agente per SAP - Panoramica di HANA: Questa dashboard fornisce grafici che mostrano una panoramica dello stato per le seguenti metriche: Disponibilità SAP HANA, Disponibilità SAP HANA HA, Repliche SAP HANA HA, Stato del servizio SAP HANA, Cluster HA - Stato del nodo e Cluster HA - Stato della risorsa per le istanze SAP.

    Il file JSON per questa dashboard è sap-agent-status-overview.json.

  • Agente per SAP - Metriche non elaborate HANA: Questa dashboard fornisce grafici che visualizzano i valori delle metriche non elaborati per le seguenti metriche: Disponibilità SAP HANA, disponibilità SAP HANA, replica SAP HANA HA, Stato del servizio SAP HANA, cluster ad alta disponibilità - stato nodo Cluster ad alta disponibilità - Stato della risorsa per istanze SAP.

    Il file JSON per questa dashboard è sap-agent-raw-metrics.json.

Installare le dashboard

Per installare una dashboard personalizzata, completa i seguenti passaggi:

Console Google Cloud

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

    Vai a Monitoring

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

  3. Fai clic sulla scheda Raccolta di esempi.

    Visualizzazione della scheda della Raccolta di esempio selezionata.

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

  5. (Facoltativo) Per visualizzare i dettagli di una dashboard o per visualizzarne l'anteprima contenuti, fai clic su Anteprima.

  6. Seleziona la dashboard da installare.

  7. Fai clic su Importa, quindi su Conferma.

    La dashboard viene aggiunta alle dashboard disponibili nel progetto Google Cloud. Per visualizzare la dashboard, segui le istruzioni in Visualizza la dashboard installata.

Google Cloud CLI

  1. Apri Cloud Shell:

    Apri Cloud Shell

  2. In Cloud Shell, clona o scarica il repository:

    git clone https://github.com/GoogleCloudPlatform/monitoring-dashboard-samples/

  3. In Cloud Shell, installa la dashboard richiesta utilizzando 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.

Visualizza le dashboard installate

Per visualizzare le dashboard installate:

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

    Vai a Monitoring

  2. Nel riquadro 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 Metriche SAP HANA in Monitoring.

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