Configura la raccolta di metriche per il monitoraggio dei processi

Questa guida mostra come configurare l'agente di Google Cloud per SAP per raccogliere le metriche di Process Monitoring dai tuoi sistemi SAP.

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

Prima di iniziare

Convalida l'installazione dell'agente di Google Cloud per SAP. Per istruzioni, consulta la guida all'installazione per il tuo scenario.
Se hai installato l'agente su un server Bare Metal Solution, assicurati di aver completato i prerequisiti richiesti e di aver configurato un account di servizio. Per le istruzioni, consulta Configurare l'agente Google Cloud per SAP su Linux.

Imposta ruoli IAM

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

Visualizzatore Compute (roles/compute.viewer)
Ruoli Writer metriche Monitoring (roles/monitoring.metricWriter).
Funzione di accesso ai secret di Secret Manager (roles/secretmanager.secretAccessor), se utilizzi Secret Manager per archiviare la password del database SAP HANA.

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

Nella console Google Cloud, vai alla pagina IAM.

Vai a IAM
Selezionare il tuo progetto Google Cloud.
Identifica l'account di servizio a cui vuoi aggiungere un ruolo.
- Se l'account di servizio non è già nell'elenco delle entità, non avrà alcun ruolo assegnato. Fai clic su Aggiungi e inserisci l'indirizzo email dell'account di servizio.
- Se l'account di servizio è già nell'elenco delle entità, ha ruoli esistenti. Fai clic sul pulsante Modifica per l'account di servizio che vuoi modificare.
Seleziona il ruolo richiesto dall'elenco di ruoli disponibili:
- Visualizzatore Compute
- Monitoring > Writer metriche Monitoring
- Secret Manager > Funzione di accesso ai secret di Secret Manager
Fai clic su Aggiungi o Salva per applicare i ruoli all'account di servizio.

Abilita la raccolta di metriche per il monitoraggio dei processi

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

Stabilisci una connessione SSH con l'istanza VM host.
Apri il file di configurazione dell'agente:
```
/etc/google-cloud-sap-agent/configuration.json
```
In alternativa, puoi eseguire questa configurazione tramite comandi. Per maggiori informazioni, consulta Comandi di configurazione per l'agente di Google Cloud per SAP.
Nella sezione collection_configuration, esegui queste operazioni:
- Per il parametro collect_process_metrics, specifica il valore true.
- Per abilitare la raccolta di metriche di monitoraggio dei processi relative alle istanze del database SAP HANA, devi configurare parametri aggiuntivi nella sezione hana_metrics_config. Per informazioni su questi parametri, consulta Parametri di configurazione.
Se vuoi, nella sezione cloud_properties puoi aggiornare i valori dei parametri impostati automaticamente. Per farlo, aggiungi la sezione cloud_properties al file di configurazione e specifica i parametri richiesti e i relativi valori.
Salva il file di configurazione.
Riavvia l'agente per applicare le nuove impostazioni:
```
sudo systemctl restart google-cloud-sap-agent
```

File di configurazione di esempio

Istanza VM di Compute Engine

L'esempio seguente è un file di configurazione completo dell'agente per SAP di Google Cloud, in esecuzione su un Istanza VM di Compute Engine, in cui è abilitata la raccolta delle metriche di monitoraggio dei processi:

{
  "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",
      "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
  },
  "hana_monitoring_configuration": {
    "enabled": false
  }
}

Server Bare Metal Solution

L'esempio seguente è un file di configurazione completo dell'agente per SAP di Google Cloud, in esecuzione su un server Bare Metal Solution, in cui è abilitata la raccolta delle metriche di monitoraggio dei processi:

{
  "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",
      "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
  },
  "hana_monitoring_configuration": {
    "enabled": false
  }
}

Parametri di configurazione

La seguente tabella illustra i parametri di configurazione dell'agente di Google Cloud per SAP specifici per la raccolta delle metriche di Process Monitoring.

Parametri
`provide_sap_host_agent_metrics`	`Boolean` Per abilitare la raccolta delle metriche richieste dall'agente host SAP, specifica `true`. Il valore predefinito è `true`. Non impostare `provide_sap_host_agent_metrics` su `false` a meno che non ti venga richiesto dall'assistenza clienti Google Cloud o dall'Assistenza SAP.
`bare_metal`	`Boolean` Quando l'agente viene installato su un server Bare Metal Solution, specifica `true`. Il valore predefinito è `false`.
`log_level`	`String` Per impostare il livello di logging dell'agente, imposta il valore richiesto. I livelli di log disponibili sono i seguenti: `DEBUG` `INFO` `WARNING` `ERROR` Il valore predefinito è `INFO`. Non modificare il livello di logging a meno che non ti venga richiesto dall'assistenza clienti Google Cloud.
`log_to_cloud`	`Boolean` Per reindirizzare i log dell'agente a Cloud Logging, specifica `true`. Il valore predefinito è `true`.
`cloud_properties.project_id`	`String` Se il tuo sistema SAP è in esecuzione su un server Bare Metal Solution, specifica l'ID del progetto Google Cloud che stai utilizzando con Bare Metal Solution. Quando l'agente viene eseguito su un'istanza VM, per impostazione predefinita rileva automaticamente l'ID progetto.
`cloud_properties.instance_name`	`String` Se il tuo sistema SAP è in esecuzione su un'istanza VM di Compute Engine, specifica il nome dell'istanza VM. L'agente rileva automaticamente il nome dell'istanza VM al momento dell'installazione. Se il tuo sistema SAP è in esecuzione su un server Bare Metal Solution, specifica il nome del server.
`cloud_properties.region`	`String` Se il sistema SAP è in esecuzione su un server Bare Metal Solution, specifica la regione del server Bare Metal Solution. Quando l'agente viene eseguito su un'istanza VM, per impostazione predefinita utilizza la regione dell'istanza VM in cui è installato.
`cloud_properties.zone`	`String` Per impostazione predefinita, quando l'agente viene eseguito su un'istanza VM utilizza la zona dell'istanza VM in cui è installato.
`cloud_properties.image`	`String` Specifica il nome dell'immagine del sistema operativo per l'istanza. Quando l'agente viene eseguito su un'istanza VM, per impostazione predefinita rileva l'immagine del sistema operativo dell'istanza VM su cui è installato.
`cloud_properties.numeric_project_id`	`String` Specifica l'ID numerico del progetto Google Cloud in cui è in esecuzione il sistema SAP. Quando l'agente viene eseguito su un'istanza VM, per impostazione predefinita rileva automaticamente l'ID progetto numerico.
`discovery_configuration.enable_workload_discovery`	`Boolean` Per consentire all'agente di raccogliere i nomi e le versioni dei prodotti SAP in esecuzione sull'host, specifica `true`. Il valore predefinito è `true`. Per maggiori informazioni, consulta il codebase dell'agente nel repository GitHub di `google-cloud-sap-agent` in GoogleCloudPlatform/sapagent.
`discovery_configuration.enable_discovery`	`Boolean` Per inviare a Cloud Logging le informazioni raccolte dall'agente sui prodotti SAP in esecuzione sull'host, specifica `true`. Il valore predefinito è `true`. Se specifichi il valore `false`, l'agente archivia le informazioni raccolte sull'host e non le invia a Cloud Logging.
`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 abiliti la raccolta delle metriche di elaborazione per SAP HANA, devi configurare parametri aggiuntivi elencati in `hana_metrics_config`.
`collection_configuration.process_metrics_frequency`	`Int` Dalla versione 2.6, questo parametro determina la frequenza di raccolta in secondi delle metriche di monitoraggio dei processi in rapida evoluzione. 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 monitoraggio dei processi (a lenta modifica) vengono raccolte con una frequenza predefinita di 30 secondi. Per modificare la frequenza di raccolta delle metriche di monitoraggio dei processi che cambiano lenta, 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 in lenta modifica, in secondi. Il valore predefinito di questo parametro è di `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 valore separato da virgole dei nomi delle metriche di monitoraggio dei processi. 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 che l'agente utilizza 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 che l'agente utilizza per eseguire query su SAP HANA. Anziché utilizzare una password in testo normale, ti consigliamo di utilizzare un secret in Secret Manager specificando il nome del secret in `hana_db_password_secret_name`. Non specificare una password se utilizzi Secret Manager per archiviare le credenziali utente del database. Quando nella configurazione sono specificati entrambi i criteri `hana_db_password` e `hana_db_password_secret_name`, viene attivato un errore e l'agente non può connettersi al database.
`collection_configuration.hana_metrics_config.hana_db_password_secret_name`	`String` Per fornire in modo sicuro la password per l'account utente del database che l'agente utilizza per eseguire query su SAP HANA, specifica il nome del secret che contiene le credenziali di sicurezza per l'account utente del database. Le metriche relative a SAP HANA vengono raccolte solo se è impostata l'opzione `hana_db_password_secret_name` o `hana_db_password`. Importante: il secret e l'istanza VM host devono esistere nello stesso progetto Google Cloud.

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:

Agent for SAP - HANA Overview: Questa dashboard fornisce grafici che mostrano una panoramica dello stato per le seguenti metriche: Disponibilità SAP HANA, Disponibilità SAP HANA HA, Replica SAP HANA HA, Stato del servizio SAP HANA, Cluster ad alta disponibilità - Stato del nodo e Cluster ad alta disponibilità - Stato risorsa per le istanze SAP.

Il file JSON per questa dashboard è sap-agent-status-overview.json.
Agente per SAP - Metriche non elaborate di HANA: Questa dashboard fornisce grafici che mostrano valori delle metriche non elaborati per le seguenti metriche: Disponibilità SAP HANA , Disponibilità SAP HANA HA, Replica SAP HANA HA, Stato del servizio SAP HANA, Cluster ad alta disponibilità - Stato del nodo e Cluster ad alta disponibilità - Stato della risorsa per le istanze SAP.

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

Installa dashboard

Per installare una dashboard personalizzata, completa i seguenti passaggi:

Console Google Cloud

Nella console Google Cloud, vai alla pagina Monitoring:

Vai a Monitoring
Nel pannello di navigazione di Monitoring, fai clic su Dashboard.
Fai clic sulla scheda Raccolta di esempio.
Per filtrare le dashboard personalizzate specifiche dell'agente, digita Agent for SAP nel campo Filtro.
(Facoltativo) Per visualizzare i dettagli di una dashboard o per visualizzarne l'anteprima, fai clic su Anteprima.
Seleziona la dashboard da installare.
Fai clic su Importa e poi su Conferma.

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

Google Cloud CLI

Apri Cloud Shell:

Apri Cloud Shell

In Cloud Shell, clona o scarica il repository:

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

In Cloud Shell, installa la dashboard richiesta utilizzando il file JSON corrispondente:
```
gcloud monitoring dashboards create --config-from-file=CONFIG_FROM_FILE
```
Sostituisci CONFIG_FROM_FILE con il percorso del file JSON che contiene la configurazione della dashboard. I file di configurazione della dashboard possono essere trovati nel percorso: monitoring-dashboard-samples/dashboards/google-cloud-agent-for-sap.

La dashboard viene aggiunta alle dashboard disponibili nel tuo progetto Google Cloud. Per vedere la dashboard, segui le istruzioni in Visualizzare la dashboard installata.

Visualizza le dashboard installate

Per visualizzare le dashboard installate:

Nella console Google Cloud, vai alla pagina Monitoring:

Vai a Monitoring
Nel pannello di navigazione di Monitoring, fai clic su Dashboard.
Fai clic sul nome della dashboard nell'elenco.

Se disponi di molte dashboard, puoi filtrare in base alle dashboard personalizzate o al nome della nuova dashboard. Per informazioni su come filtrare questo elenco, consulta Visualizzare le dashboard personalizzate.

L'immagine seguente è un esempio che mostra una parte della dashboard personalizzata per le metriche SAP HANA in Monitoring.

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