Configurare l'agente per SAP per la raccolta delle metriche

L'agente per SAP diGoogle Cloudfornisce supporto per il monitoraggio dei carichi di lavoro SAP in esecuzione su istanze Compute Engine e ti aiuta a eseguire i sistemi SAP in modo efficiente 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 delle applicazioni sottostanti utilizzate per l'osservabilità, devi abilitare funzionalità aggiuntive per l'agente per 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 l'agente per SAP		 Installa e configura l'agente per SAP di Google Cloudsu ogni VM Compute Engine che vuoi monitorare.
L'agente per SAP è incluso nei seguenti sistemi operativi pubblici "per SAP":
  • RHEL: tutte le immagini "per SAP"
  • SLES: SLES 15 SP4 per SAP e versioni successive

Per maggiori informazioni, vedi Installa e configura l'agente per 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 all'ultima versione.

Per visualizzare le annotazioni per le occorrenze di eventi SAP predefiniti, devi disporre della versione 3.7 o successive dell'agente.

Per saperne di più, consulta Aggiornamento dell'agente per SAP di Google Cloud.
Attivare la funzionalità di rilevamento del sistema dell'agente per 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 è necessaria alcuna modifica.
  • discovery_configuration.enable_workload_discovery
  • discovery_configuration.enable_discovery
Se hai installato l'agente prima del 14 febbraio 2024 o se hai disattivato 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 maggiori informazioni, vedi Configura 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 abilitare la funzionalità, esegui questo comando: 
         sudo /usr/bin/google_cloud_sap_agent configure -feature=process_metrics -enable

Per saperne di più, consulta Configurare la raccolta delle metriche di monitoraggio dei processi.
Abilitare la raccolta delle metriche di monitoraggio HANA dell'agente per SAP		 Sulle VM HANA, devi abilitare la raccolta delle metriche di monitoraggio dei processi HANA. Per attivare questa funzionalità, esegui questo 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 dell'istanza HANA, il SID, l'host, la porta, l'utente e la password (utilizzando Secret o una chiave hdbuserstore).

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

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

Per maggiori informazioni, consulta Convalidare la configurazione per l'osservabilità di Workload Manager.
Riavvia l'agente per SAP		 Riavvia l'agente per far sì che le modifiche diventino effettive eseguendo il seguente comando: 
         sudo systemctl restart google-cloud-sap-agent

Per ulteriori informazioni, vedi Riavviare l'agente.

Convalidare la configurazione per l'osservabilità di Workload Manager

Puoi verificare se hai la configurazione Google Cloud corretta per utilizzare il servizio di osservabilità Workload Manager eseguendo il comando status dell'agente. Questo comando è supportato a partire 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 configurazione di Google Cloud per l'utilizzo del servizio di osservabilità Workload Manager è corretta, l'output include quanto segue. La tua 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:      30    (default)
        process_metrics_to_skip:        []   (default)
        slow_process_metrics_frequency: 120   (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, rivedi le informazioni fornite nelle sezioni precedenti, esegui le azioni richieste e poi esegui nuovamente il comando status per convalidare di nuovo la configurazione.

File di configurazione di esempio

Una volta abilitate le funzionalità di osservabilità, il file di configurazione dell'agente per SAP è 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