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

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

Il servizio di osservabilità di Workload Manager ha bisogno dell'agente per raccogliere le metriche dal tuo workload SAP e dall'infrastruttura sottostante. Per saperne di più, consulta Panoramica dell'osservabilità SAP.

Prima di iniziare

Configurare 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 del 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 il gestore di estensioni VM:

  2. Crea una policy di estensione VM che installa e gestisce Google Cloud's agente per SAP sulle istanze di calcolo che eseguono il tuo workload SAP:

Gestore di pacchetti

Se gestisci manualmente il ciclo di vita dell'agente anziché utilizzare il gestore di estensioni VM, puoi configurare Google Cloud's Agent for SAP di utilizzando un gestore di pacchetti:

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

  2. Verifica di utilizzare la versione più recente dell'agente per SAP.

    Per informazioni su come aggiornare l'agente, consulta Aggiornare Google Cloud's Agente per SAP.

  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 workload 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 le metriche dei processi correlate alle istanze del database SAP HANA, devi configurare parametri aggiuntivi nella sezione hana_metrics_config.

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

  5. Consenti all'agente di raccogliere le 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 le metriche, devi configurare parametri aggiuntivi.

    Per saperne di più, consulta Configurare 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.

Configurare 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 del 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 il gestore di estensioni VM:

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

  3. Se esegui un workload SAP ad alta disponibilità o hai un sito di ripristino di emergenza (RE) per il tuo workload SAP, crea una policy di estensione VM che installa e gestisce Google Cloudl'agente per SAP di sulle istanze di calcolo 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 il gestore di estensioni VM, puoi configurare Google Cloud's Agent for SAP di utilizzando un gestore di pacchetti:

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

  2. Verifica di utilizzare la versione più recente dell'agente per SAP.

    Per informazioni su come aggiornare l'agente, consulta Aggiornare Google Cloud's Agente per SAP.

  3. Per consentire all'agente di raccogliere 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 workload 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 le metriche dei processi correlate alle istanze del database SAP HANA, devi configurare parametri aggiuntivi nella sezione hana_metrics_config.

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

  5. Consenti all'agente di raccogliere le 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 le metriche, devi configurare parametri aggiuntivi.

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

  6. Salva il file di configurazione.

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

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

Convalidare la configurazione per l'osservabilità di Workload Manager

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

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 Google Cloud configurazione per l'osservabilità:

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

    Agent Status:
    Installed version: 3.15-....
    ...
    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, esamina le informazioni fornite nelle sezioni precedenti, esegui le azioni richieste e poi esegui di nuovo il comando status per riconvalidare la configurazione.

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

Esempi di configurazioni dell'agente

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

L'esempio seguente utilizza una chiave dell'archivio utenti sicuro (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"
        }
      ]
    }
  }

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,
      "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"
        }
      ]
    }
  }

L'esempio seguente utilizza un nome utente e una password per l'autenticazione SAP HANA. Ti consigliamo di utilizzare invece una chiave dell'archivio utenti sicuro (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, consulta Parametri di configurazione.

Passaggi successivi

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

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