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

Questo documento descrive come configurare Google Cloud's Agent for SAP per configurare l'osservabilità per il tuo workload SAP utilizzando Workload Manager.

Il servizio di osservabilità di Workload Manager richiede l'agente per raccogliere le metriche dal tuo workload SAP e dall'infrastruttura sottostante. Per saperne di più, consulta la panoramica sull'osservabilità di 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, consulta Convalida l'installazione dell'agente.
Verifica di aver completato i prerequisiti per l'osservabilità di SAP.

Configurare l'agente per un workload a zona singola

VM Extension Manager

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:

Configura gestore di estensioni VM:
- Nella documentazione di gestore di estensioni VM, consulta la sezione Prima di iniziare.
- Configura i ruoli IAM necessari per creare e gestire le policy del gestore di estensioni VM. Per saperne di più, consulta le seguenti risorse:
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:
- 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 Gestore di estensioni VM, puoi configurare Google Cloud's Agent per SAP utilizzando un gestore di pacchetti:

Stabilisci una connessione SSH con l'istanza di computing che esegue il tuo workload SAP.
Verifica di utilizzare la versione più recente dell'agente per SAP di.

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

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 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 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 le metriche dalle istanze SAP HANA in esecuzione nel tuo workload SAP:
1. Abilita la funzionalità di monitoraggio di 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 Configura la raccolta delle metriche di monitoraggio di SAP HANA.
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

VM Extension Manager

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:

Configura gestore di estensioni VM:
- Nella documentazione di gestore di estensioni VM, consulta la sezione Prima di iniziare.
- Configura i ruoli IAM necessari per creare e gestire le policy del gestore di estensioni VM. Per saperne di più, consulta le seguenti risorse:
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:
- Crea la policy di estensione VM nella zona in cui è in esecuzione il sito principale del 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.
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 Gestore di estensioni VM, puoi configurare Google Cloud's Agent per SAP utilizzando un gestore di pacchetti:

Stabilisci una connessione SSH con l'istanza di computing che esegue il tuo workload SAP.
Verifica di utilizzare la versione più recente dell'agente per SAP di.

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

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

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 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 le metriche dalle istanze SAP HANA in esecuzione nel tuo workload SAP:
1. Abilita la funzionalità di monitoraggio di 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 Configura la raccolta delle metriche di monitoraggio di SAP HANA.
Salva il file di configurazione.
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 per l'utilizzo del servizio di osservabilità di Workload Manager è corretta eseguendo il comando dell'agente. Google Cloud status

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

sudo /usr/bin/google_cloud_sap_agent status

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

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

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

Configurare l'agente per un workload a zona singola

VM Extension Manager

Gestore di pacchetti

Configurare l'agente per un workload multizona

VM Extension Manager

Gestore di pacchetti

Convalidare la configurazione per l'osservabilità di Workload Manager

Esempi di configurazioni dell'agente

Passaggi successivi

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