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 carico di lavoro SAP utilizzando Workload Manager.

Il servizio di osservabilità di Workload Manager richiede all'agente di raccogliere le metriche del carico di lavoro SAP e dell'infrastruttura sottostante. Per saperne di più, consulta la Panoramica dell'osservabilità SAP.

Prima di iniziare

Convalida l'installazione dell'agente per SAP di Google Cloudsu tutte le istanze Compute Engine che eseguono il workload SAP per il quale vuoi configurare l'osservabilità.

Per informazioni su come convalidare l'installazione dell'agente, vedi Convalidare l'installazione dell'agente.
Verifica di aver completato i prerequisiti per l'osservabilità SAP.

Configura l'agente per un workload a zona singola

VM Extension Manager

Per configurare e gestire l'agente su un gruppo di istanze Compute Engine, devi creare una policy di VM Extension Manager.

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

Configura Gestore di estensioni VM:
- Nella documentazione di VM Extension Manager, consulta la sezione Prima di iniziare.
- Configura i ruoli IAM necessari per creare e gestire le policy di VM Extension Manager. Per saperne di più, consulta le seguenti risorse:
Crea una policy di estensione VM che installi e gestisca l'agente per SAP di Google Cloudsulle istanze di Compute che eseguono il carico di lavoro SAP:
- Crea la policy di estensione VM nella zona in cui è in esecuzione il tuo workload SAP. Per informazioni su come creare una policy di estensione VM di questo tipo, consulta Crea una policy di estensione VM a livello di zona.
- Per visualizzare esempi di configurazioni dell'agente per l'osservabilità, consulta Esempi di configurazioni dell'agente.

Gestore di pacchetti

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

Stabilisci una connessione SSH con l'istanza di calcolo che esegue il tuo carico di lavoro SAP.
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.

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

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

VM Extension Manager

Per configurare e gestire l'agente su un gruppo di istanze Compute Engine, devi creare una policy di VM Extension Manager.

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:

Configura Gestore di estensioni VM:
- Nella documentazione di VM Extension Manager, consulta la sezione Prima di iniziare.
- Configura i ruoli IAM necessari per creare e gestire le policy di VM Extension Manager. Per saperne di più, consulta le seguenti risorse:
Crea una policy di estensione VM che installi e gestisca l'agente per SAP di Google Cloudsulle istanze di Compute che eseguono il sito principale del tuo workload SAP:
- Crea la policy di estensione VM nella zona in cui è in esecuzione il sito principale del workload SAP. Per informazioni su come creare una policy di estensione VM di questo tipo, consulta Crea una policy di estensione VM a livello di zona.
- Per visualizzare esempi di configurazioni dell'agente per l'osservabilità, consulta Esempi di configurazioni dell'agente.
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 di Google Cloudper SAP sulle 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 VM Extension Manager, puoi configurare l'agente per SAP di Google Cloudutilizzando un gestore di pacchetti:

Stabilisci una connessione SSH con l'istanza di calcolo che esegue il tuo carico di lavoro SAP.
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.

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

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 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.
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.
Salva il file di configurazione.
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 hai la configurazione Google Cloud corretta per utilizzare il servizio di osservabilità Workload Manager eseguendo il comando statusdell'agente.

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

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

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

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

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.
Se utilizzi più di un'istanza di calcolo per eseguire il tuo carico di lavoro, ripeti questa procedura per tutte le altre istanze di calcolo 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 invece di utilizzare 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 Gestore carichi di lavoro nella console Google Cloud .

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

Configura l'agente per SAP per impostare l'osservabilità Mantieni tutto organizzato con le raccolte Salva e classifica i contenuti in base alle tue preferenze.

Prima di iniziare

Configura l'agente per un workload a zona singola

VM Extension Manager

Gestore di pacchetti

Configura l'agente per un workload multizona

VM Extension Manager

Gestore di pacchetti

Convalida la configurazione per l'osservabilità di Workload Manager

Configurazioni agente di esempio

Passaggi successivi

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