Configurar o agente para SAP para configurar a capacidade de observação

Este documento descreve como configurar o agente do Google Cloudpara SAP e configurar a capacidade de observação da sua carga de trabalho do SAP usando o Gerenciador de cargas de trabalho.

O serviço de observabilidade do Gerenciador de cargas de trabalho precisa do agente para coletar métricas da sua carga de trabalho SAP e da infraestrutura subjacente. Para mais informações, consulte a Visão geral da observabilidade da SAP.

Antes de começar

Valide a instalação do agente do Google Cloudpara SAP em todas as instâncias do Compute Engine que executam a carga de trabalho do SAP para a qual você quer configurar a capacidade de observação.

Para informações sobre como validar a instalação do agente, consulte Validar a instalação do agente.
Verifique se você concluiu os Pré-requisitos para a observabilidade do SAP.

Configurar o agente para uma carga de trabalho de zona única

VM Extension Manager

Para configurar e gerenciar o agente em uma frota de instâncias do Compute Engine, crie uma política do VM Extension Manager.

Para configurar o agente e definir a capacidade de observação de uma carga de trabalho do SAP que está sendo executada em uma única zona, siga estas etapas:

Configure o VM Extension Manager:
- Na documentação do Gerenciador de extensões de VM, revise a seção Antes de começar.
- Configure os papéis do IAM necessários para criar e gerenciar políticas do VM Extension Manager. Para ver mais informações, consulte os tópicos a seguir:
Crie uma política de extensão de VM que instale e gerencie o agente do Google Cloud para SAP nas instâncias de computação que executam sua carga de trabalho do SAP:
- Crie a política de extensão de VM na zona em que a carga de trabalho SAP está sendo executada. Para informações sobre como criar uma política de extensão de VM zonal, consulte Criar uma política de extensão de VM zonal.
- Para conferir exemplos de configurações de agente para observabilidade, consulte Exemplos de configurações de agente.

Gerenciador de pacotes

Se você gerenciar o ciclo de vida do agente manualmente em vez de usar o VM Extension Manager, poderá configurar o agente do Google Cloudpara SAP usando um gerenciador de pacotes:

Estabeleça uma conexão SSH com a instância de computação que executa sua carga de trabalho do SAP.
Verifique se você está executando a versão mais recente do agente para SAP.

Para saber como atualizar o agente, consulte Atualizar o agente do Google Cloudpara SAP.

Para permitir que o agente pesquise detalhes sobre a carga de trabalho do SAP e os envie ao Gerenciador de cargas de trabalho:

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

Permita que o agente colete métricas dos processos em execução na sua carga de trabalho do SAP:
1. Ative o recurso de monitoramento de processos do agente:
```
sudo /usr/bin/google_cloud_sap_agent configure -feature=process_metrics -enable
```
1. Para permitir que o agente colete métricas de processo relacionadas às suas instâncias de banco de dados do SAP HANA, é preciso configurar outros parâmetros na seção hana_metrics_config.
Para mais informações, consulte Configurar a coleta de métricas de monitoramento de processos.
Permita que o agente colete métricas das instâncias do SAP HANA em execução na carga de trabalho do SAP:
1. Ative o recurso de monitoramento do SAP HANA do agente:
```
sudo /usr/bin/google_cloud_sap_agent configure -feature=hana_monitoring -enable
```
1. Para permitir que o agente se conecte às instâncias do SAP HANA e colete métricas, é preciso configurar outros parâmetros.
Para mais informações, consulte Configurar a coleta de métricas de monitoramento do SAP HANA.
Salve o arquivo de configuração.

Para conferir exemplos de configurações de agente para observabilidade, consulte Exemplos de configurações de agente.

Configurar o agente para uma carga de trabalho multizonal

VM Extension Manager

Para configurar e gerenciar o agente em uma frota de instâncias do Compute Engine, crie uma política do VM Extension Manager.

Para configurar o agente e definir a capacidade de observação de uma carga de trabalho do SAP que está em execução em duas ou mais zonas, siga estas etapas:

Configure o VM Extension Manager:
- Na documentação do Gerenciador de extensões de VM, revise a seção Antes de começar.
- Configure os papéis do IAM necessários para criar e gerenciar políticas do VM Extension Manager. Para ver mais informações, consulte os tópicos a seguir:
Crie uma política de extensão de VM que instale e gerencie o agente do Google Cloud para SAP nas instâncias de computação que executam o site principal da sua carga de trabalho SAP:
- Crie a política de extensão de VM na zona em que o site principal da carga de trabalho do SAP está sendo executado. Para informações sobre como criar uma política de extensão de VM zonal, consulte Criar uma política de extensão de VM zonal.
- Para conferir exemplos de configurações de agente para observabilidade, consulte Exemplos de configurações de agente.
Se você estiver executando uma carga de trabalho do SAP de alta disponibilidade ou tiver um site de recuperação de desastres (DR) para sua carga de trabalho do SAP, crie uma política de extensão de VM que instale e gerencie o agente do Google Cloudpara SAP nas instâncias de computação que executam o site secundário ou de DR da sua carga de trabalho do SAP.

Gerenciador de pacotes

Se você gerenciar o ciclo de vida do agente manualmente em vez de usar o VM Extension Manager, poderá configurar o agente do Google Cloudpara SAP usando um gerenciador de pacotes:

Estabeleça uma conexão SSH com a instância de computação que executa sua carga de trabalho do SAP.
Verifique se você está executando a versão mais recente do agente para SAP.

Para saber como atualizar o agente, consulte Atualizar o agente do Google Cloudpara SAP.

Para permitir que o agente colete detalhes sobre a carga de trabalho do SAP e os envie ao gerenciador de cargas de trabalho:

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

Permita que o agente colete métricas dos processos em execução na sua carga de trabalho do SAP:
1. Ative o recurso de monitoramento de processos do agente:
```
sudo /usr/bin/google_cloud_sap_agent configure -feature=process_metrics -enable
```
1. Para permitir que o agente colete métricas de processo relacionadas às suas instâncias de banco de dados do SAP HANA, é preciso configurar outros parâmetros na seção hana_metrics_config.
Para mais informações, consulte Configurar a coleta de métricas de monitoramento de processos.
Permita que o agente colete métricas das instâncias do SAP HANA em execução na carga de trabalho do SAP:
1. Ative o recurso de monitoramento do SAP HANA do agente:
```
sudo /usr/bin/google_cloud_sap_agent configure -feature=hana_monitoring -enable
```
1. Para permitir que o agente se conecte às instâncias do SAP HANA e colete métricas, é preciso configurar outros parâmetros.
Para mais informações, consulte Configurar a coleta de métricas de monitoramento do SAP HANA.
Salve o arquivo de configuração.
Se você estiver executando uma carga de trabalho do SAP de alta disponibilidade ou tiver um site de recuperação de desastres (DR) para sua carga de trabalho do SAP, repita esse procedimento para todas as outras instâncias de computação que estão executando sua carga de trabalho do SAP.

Para conferir exemplos de configurações de agente para observabilidade, consulte Exemplos de configurações de agente.

Validar a configuração da capacidade de observação do Gerenciador de cargas de trabalho

Para validar se você tem a configuração Google Cloud correta para usar o serviço de observabilidade do Workload Manager, execute o comando status do agente.

Para validar a configuração do Google Cloud , siga estas etapas:

Estabeleça uma conexão SSH com a instância do Compute Engine que está executando sua carga de trabalho do SAP.

Verifique a configuração do Google Cloud para observabilidade:

sudo /usr/bin/google_cloud_sap_agent status

Se a configuração do Google Cloud para usar o serviço de observabilidade do Workload Manager estiver correta, a saída vai incluir o seguinte. Sua configuração pode ter valores diferentes dos de 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 a saída indicar que falta alguma configuração, revise as informações fornecidas nas seções anteriores, execute as ações necessárias e execute novamente o comando status para validar a configuração.
Se você estiver usando mais de uma instância de computação para executar sua carga de trabalho, repita esse procedimento para todas as outras instâncias de computação que executam sua carga de trabalho.

Exemplos de configurações de agente

Os exemplos a seguir são arquivos de configuração completos do agente do Google Cloud para SAP, configurado para oferecer suporte à capacidade de observação de uma carga de trabalho do SAP HANA:

O exemplo a seguir usa uma chave de repositório de usuários seguro (hdbuserstore) para autenticação do 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"
        }
      ]
    }
  }

O exemplo a seguir usa um nome de usuário e um secret do Secret Manager para autenticação do 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"
        }
      ]
    }
  }

O exemplo a seguir usa um nome de usuário e uma senha para autenticação do SAP HANA. Em vez disso, recomendamos que você use uma chave de repositório de usuários seguro (hdbuserstore) ou um secret do Secret Manager para autenticação do 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"
        }
      ]
    }
  }

Para informações sobre os parâmetros de configuração aceitos pelo agente, consulte Parâmetros de configuração.

A seguir

Depois de concluir a configuração de observabilidade para uma carga de trabalho do SAP, pode levar até 15 minutos para que ela apareça na página Observabilidade do Gerenciador de cargas de trabalho no console do Google Cloud .

Para informações sobre como observar sua carga de trabalho SAP, consulte Ver métricas de observabilidade para SAP.

Configurar o agente para SAP para configurar a capacidade de observação Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.

Antes de começar

Configurar o agente para uma carga de trabalho de zona única

VM Extension Manager

Gerenciador de pacotes

Configurar o agente para uma carga de trabalho multizonal

VM Extension Manager

Gerenciador de pacotes

Validar a configuração da capacidade de observação do Gerenciador de cargas de trabalho

Exemplos de configurações de agente

A seguir

Configurar o agente para SAP para configurar a capacidade de observação