Configura l'agente per SAP per impostare l'osservabilità

Questo documento descrive come configurare l'agente per SAP di Google Cloud per impostare l'osservabilità per il tuo workload SAP utilizzando Workload Manager.

Il servizio di osservabilità di Workload Manager richiede all'agente di raccogliere metriche dal tuo workload SAP e dall'infrastruttura sottostante. Per ulteriori informazioni, consulta Panoramica di SAP Observability.

Prima di iniziare

Configura l'agente per un workload a zona singola

Gestore di estensioni VM

Per configurare e gestire l'agente su un parco risorse di istanze Compute Engine, devi creare una policy di gestore di estensioni VM.

Per configurare l'agente in modo da impostare l'osservabilità per un workload SAP in esecuzione in una singola zona, completa i seguenti passaggi:

  1. Configura Gestore di estensioni VM:

  2. Crea una policy di estensione VM che installi e gestisca l'agente per SAP di Google Cloudsulle istanze di calcolo che eseguono il carico di lavoro SAP:

Gestore di pacchetti

Se gestisci manualmente il ciclo di vita dell'agente anziché utilizzare Gestore di estensioni VM, puoi configurare l'agente per SAP di Google Cloudutilizzando un gestore di pacchetti:

  1. Stabilisci una connessione SSH con l'istanza di computing che esegue il tuo carico di lavoro SAP.

  2. Verifica di utilizzare l'ultima versione dell'agente per SAP.

    Per informazioni su come aggiornare l'agente, vedi Aggiornare l'agente per SAP di Google Cloud.

  3. Per consentire all'agente di cercare i dettagli sul workload SAP e inviarli a Workload Manager:

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

  4. Consenti all'agente di raccogliere le metriche dai processi in esecuzione nel tuo carico di lavoro SAP:

    1. Abilita la funzionalità di monitoraggio dei processi dell'agente:
    sudo /usr/bin/google_cloud_sap_agent configure -feature=process_metrics -enable
    1. Per consentire all'agente di raccogliere metriche di processo relative alle tue istanze del database SAP HANA, devi configurare parametri aggiuntivi nella sezione hana_metrics_config.

    Per saperne di più, consulta Configura la raccolta delle metriche di monitoraggio dei processi.

  5. Consenti all'agente di raccogliere metriche dalle istanze SAP HANA in esecuzione nel tuo workload SAP:

    1. Abilita la funzionalità di monitoraggio SAP HANA dell'agente:
    sudo /usr/bin/google_cloud_sap_agent configure -feature=hana_monitoring -enable
    1. Per consentire all'agente di connettersi alle istanze SAP HANA e raccogliere metriche, devi configurare parametri aggiuntivi.

    Per saperne di più, consulta Configura la raccolta delle metriche di monitoraggio SAP HANA.

  6. Salva il file di configurazione.

Per visualizzare esempi di configurazioni dell'agente per l'osservabilità, consulta Esempi di configurazioni dell'agente.

Configura l'agente per un workload multizona

Gestore di estensioni VM

Per configurare e gestire l'agente su un parco risorse di istanze Compute Engine, devi creare una policy di gestore di estensioni VM.

Per configurare l'agente in modo da impostare l'osservabilità per un workload SAP in esecuzione in due o più zone, completa i seguenti passaggi:

  1. Configura Gestore di estensioni VM:

  2. Crea una policy di estensione VM che installi e gestisca l'agente per SAP di Google Cloud sulle istanze di calcolo che eseguono il sito principale del tuo workload SAP:

  3. Se esegui un workload SAP ad alta disponibilità o disponi di un sito di ripristino di emergenza per il tuo workload SAP, crea una policy di estensione VM che installi e gestisca l'agente per SAP di Google Cloudsulle istanze di computing che eseguono il sito secondario o di RE del tuo workload SAP.

Gestore di pacchetti

Se gestisci manualmente il ciclo di vita dell'agente anziché utilizzare Gestore di estensioni VM, puoi configurare l'agente per SAP di Google Cloudutilizzando un gestore di pacchetti:

  1. Stabilisci una connessione SSH con l'istanza di computing che esegue il tuo carico di lavoro SAP.

  2. Verifica di utilizzare l'ultima versione dell'agente per SAP.

    Per informazioni su come aggiornare l'agente, vedi Aggiornare l'agente per SAP di Google Cloud.

  3. Per consentire all'agente di raccogliere i dettagli sul carico di lavoro SAP e inviarli a Workload Manager:

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

  4. Consenti all'agente di raccogliere le metriche dai processi in esecuzione nel tuo carico di lavoro SAP:

    1. Abilita la funzionalità di monitoraggio dei processi dell'agente:
    sudo /usr/bin/google_cloud_sap_agent configure -feature=process_metrics -enable
    1. Per consentire all'agente di raccogliere metriche di processo relative alle tue istanze del database SAP HANA, devi configurare parametri aggiuntivi nella sezione hana_metrics_config.

    Per saperne di più, consulta Configura la raccolta delle metriche di monitoraggio dei processi.

  5. Consenti all'agente di raccogliere metriche dalle istanze SAP HANA in esecuzione nel tuo workload SAP:

    1. Abilita la funzionalità di monitoraggio SAP HANA dell'agente:
    sudo /usr/bin/google_cloud_sap_agent configure -feature=hana_monitoring -enable
    1. Per consentire all'agente di connettersi alle istanze SAP HANA e raccogliere metriche, devi configurare parametri aggiuntivi.

    Per saperne di più, consulta Configura la raccolta delle metriche di monitoraggio SAP HANA.

  6. Salva il file di configurazione.

  7. Se esegui un workload SAP ad alta disponibilità o disponi di un sito di ripristino di emergenza per il tuo workload SAP, ripeti questa procedura per tutte le altre istanze di computing che eseguono il tuo workload SAP.

Per visualizzare esempi di configurazioni dell'agente per l'osservabilità, consulta Esempi di configurazioni dell'agente.

Convalida la configurazione per l'osservabilità di Workload Manager

Puoi verificare se la configurazione Google Cloud per l'utilizzo del servizio di osservabilità Workload Manager è corretta eseguendo il comando statusdell'agente.

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

  1. Stabilisci una connessione SSH con l'istanza Compute Engine che esegue il tuo workload SAP.

  2. Controlla la configurazione di Google Cloud per l'osservabilità:

    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 default.

    Agent Status:
    Installed version: 3.14-....
    ...
    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.

  4. Se utilizzi più di un'istanza di computing per eseguire il tuo carico di lavoro, ripeti questa procedura per tutte le altre istanze di computing che eseguono il tuo carico di lavoro.

Configurazioni agente di esempio

Gli esempi seguenti sono file di configurazione completi dell'agente per SAP di Google Cloudconfigurato per supportare l'osservabilità per un workload SAP HANA:

L'esempio seguente utilizza una chiave Secure User Store (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,
      "hana_metrics_config": {
        "hana_db_user": "db_user_name",
        "sid": "DEH",
        "hdbuserstore_key": "user_store_key"
      }
    },
    "discovery_configuration": {
      "enable_workload_discovery": true,
      "enable_discovery": true
    },
    "hana_monitoring_configuration": {
      "enabled": true,
      "hana_instances": [
        {
          "name": "local",
          "sid": "DEH",
          "user": "system",
          "hdbuserstore_key": "user_store_key"
        },
        {
          "name": "remote",
          "sid": "DEH",
          "user": "system",
          "hdbuserstore_key": "user_store_key"
        }
      ]
    }
  }

Il seguente esempio utilizza un nome utente e un secret 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": true,
      "hana_metrics_config": {
        "hana_db_user": "db_user_name",
        "sid": "DEH",
        "hana_db_password_secret_name": "db_pwd_secret_name"
      }
    },
    "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": "db_user_name",
          "hdbuserstore_key": "user_store_key"
        },
        {
          "name": "remote",
          "sid": "DEH",
          "host": "10.123.0.12",
          "port": "30015",
          "user": "db_user_name",
          "secret_name": "db_pwd_secret_name"
        }
      ]
    }
  }

Il seguente esempio utilizza un nome utente e una password per l'autenticazione SAP HANA. Ti consigliamo di utilizzare invece una chiave Secure User Store (hdbuserstore) o un secret di 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": true,
      "hana_metrics_config": {
        "hana_db_user": "db_user_name",
        "sid": "DEH",
        "hana_db_password": "TempPa55word"
      }
    },
    "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": "db_user_name",
          "password": "TempPa55word"
        },
        {
          "name": "remote",
          "sid": "DEH",
          "host": "10.123.0.12",
          "port": "30015",
          "user": "db_user_name",
          "password": "TempPa55word"
        }
      ]
    }
  }

Per informazioni sui parametri di configurazione supportati dall'agente, vedi Parametri di configurazione.

Passaggi successivi

  • Una volta completata la configurazione dell'osservabilità per un carico di lavoro SAP, possono essere necessari fino a 15 minuti prima che il carico di lavoro venga visualizzato nella pagina Osservabilità di Workload Manager nella console Google Cloud .

    Per informazioni su come osservare il tuo workload SAP, vedi Visualizzare le metriche di osservabilità per SAP.