Configurare l'agente per SAP per la raccolta delle metriche

L'agente per SAP diGoogle Cloudsupporta il monitoraggio dei carichi di lavoro SAP in esecuzione su istanze Compute Engine e ti aiuta a eseguire in modo efficiente i sistemi SAP su Google Cloud. Devi installare l'agente per SAP di Google Cloudsu tutte le VM che eseguono qualsiasi sistema SAP. Questo agente raccoglie e invia tutte le informazioni richieste da SAP all'agente host SAP. Per ulteriori informazioni, consulta la nota SAP 2469354.

Per raccogliere le metriche dell'infrastruttura e dell'applicazione sottostanti utilizzate per l'osservabilità, devi attivare funzionalità aggiuntive per Agent for SAP.

Questo documento descrive come attivare queste funzionalità in Agent for SAP.

Elenco di controllo per l'agente per SAP

Il seguente elenco di controllo riassume le attività che devi eseguire per assicurarti che l'agente per SAP sia configurato correttamente per l'osservabilità:

Installa e configura Agent for SAP		 Installa e configura l'agente per SAP di Google Cloudsu ogni VM Compute Engine che vuoi monitorare.
L'agente per SAP è pacchettizzato con le seguenti immagini del sistema operativo pubblico "per SAP":
  • RHEL: tutte le immagini "per SAP"
  • SLES: SLES 15 SP4 for SAP e versioni successive

Per ulteriori informazioni, vedi Installare e configurare Agent for SAP su una VM.
Aggiornare l'agente per SAP		 La versione 3.5 dell'agente per SAP contiene tutte le funzionalità necessarie per configurare l'osservabilità per SAP. Se l'agente è stato installato in precedenza, ti consigliamo di aggiornarlo alla versione più recente.

Per ulteriori informazioni, vedi Aggiornare l'agente di Google Cloudper SAP.
Attivare la funzionalità di rilevamento del sistema di Agent for SAP		 Nel file di configurazione dell'agente, i seguenti parametri devono essere impostati su true. Se hai installato l'agente dopo il 14 febbraio 2024, questi flag sono impostati su true per impostazione predefinita e non è richiesta alcuna modifica.
  • discovery_configuration.enable_workload_discovery
  • discovery_configuration.enable_discovery
Se hai installato l'agente prima del 14 febbraio 2024 o se hai disabilitato la funzionalità di rilevamento del sistema, esegui i seguenti comandi:
         sudo /usr/bin/google_cloud_sap_agent configure -feature=sap_discovery -enable 

         sudo /usr/bin/google_cloud_sap_agent configure -feature=workload_discovery -enable

Per ulteriori informazioni, consulta Configurare l'agente per SAP di Google Cloud.
Abilita la raccolta delle metriche di monitoraggio dei processi dell'agente per SAP		 Nel file di configurazione dell'agente, il parametro collection_configuration.collect_process_metrics deve essere impostato su true. Per attivare la funzionalità, esegui il seguente comando: 
         sudo /usr/bin/google_cloud_sap_agent configure -feature=process_metrics -enable

Per ulteriori informazioni, consulta Configurare la raccolta delle metriche di monitoraggio dei processi.
Abilita la raccolta delle metriche di monitoraggio di SAP HANA per l'agente		 Nelle VM HANA, devi attivare la raccolta delle metriche di monitoraggio dei processi HANA. Per attivare questa funzionalità, esegui il seguente comando: 
         sudo /usr/bin/google_cloud_sap_agent configure -feature=hana_monitoring -enable

Modifica la sezione hana_monitoring_configuration nel file di configurazione dell'agente per fornire il nome, il SID, l'host, la porta, l'utente e la password dell'istanza HANA (utilizzando Secret o una chiave hdbuserstore).

Tieni presente che l'utente HANA specificato deve disporre dell'accesso in lettura alle tabelle su cui vengono eseguite query dalle query predefinite.

Per ulteriori informazioni, consulta Configurare la raccolta delle metriche di monitoraggio di SAP HANA.
Convalida la configurazione e la Google Cloud configurazione dell'agente		 Verifica che l'agente sia configurato correttamente eseguendo il seguente comando: 
         sudo /usr/bin/google_cloud_sap_agent status

Per ulteriori informazioni, consulta Convalidare la configurazione per l'osservabilità di Workload Manager.
Riavvia l'agente per SAP		 Riavviare l'agente affinché le modifiche vengano applicate eseguendo il seguente comando: 
         sudo systemctl restart google-cloud-sap-agent

Per ulteriori informazioni, vedi Riavviare l'agente.

Convalida la configurazione dell'osservabilità di Workload Manager

Puoi verificare se hai eseguito la Google Cloud configurazione corretta per l'utilizzo del servizio di osservabilità Workload Manager eseguendo il comando status dell'agente. Questo comando è supportato dalla versione 3.7 dell'agente.

Per convalidare la Google Cloud configurazione, completa i seguenti passaggi:

  1. Stabilisci una connessione SSH con l'istanza Compute Engine.

  2. Esegui questo comando:

    sudo /usr/bin/google_cloud_sap_agent status

    Se la Google Cloud configurazione per l'utilizzo del servizio di osservabilità di Workload Manager è corretta, l'output include quanto segue. La configurazione potrebbe avere valori diversi da quelli di default.

    Agent Status:
    Installed version: 3.7-....
    ...
    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
...
----------------------------------------------------------------------------
Process Metrics: Enabled
    Status: Fully Functional
    IAM Permissions: All granted
    Configuration:
        collect_process_metrics:        true (configuration file)
        process_metrics_frequency:      5    (default)
        process_metrics_to_skip:        []   (default)
        slow_process_metrics_frequency: 30   (default)
...
----------------------------------------------------------------------------
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)
...
----------------------------------------------------------------------------
System Discovery: Enabled
    Status: Fully Functional
    IAM Permissions: All granted
    Configuration:
        enable_discovery:                  true  (default)
        enable_workload_discovery:         true  (default)
        sap_instances_update_frequency:    60    (default)
        system_discovery_update_frequency: 14400 (default)
...

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

File di configurazione di esempio

Dopo aver attivato le funzionalità di osservabilità, il file di configurazione dell'agente per SAP sarà simile al seguente:

  {
    "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
  },
  "discovery_configuration": {
     "enable_workload_discovery": true,
     "enable_discovery": true
  },
  "hana_monitoring_configuration": {
    "enabled": true,
    "hana_instances": [
      {
        "name": "local",
        "sid": "DEH",
        "host": "localhost",
        "port": "30015",
        "user": "system",
        "secret_name": "password-secret-name"
      },
    ],
   }
  }

Passaggi successivi