Configurar o agente para SAP para a coleta de métricas

O agente doGoogle Cloudpara SAP oferece suporte ao monitoramento de cargas de trabalho SAP em execução em instâncias do Compute Engine e ajuda a executar sistemas SAP de maneira eficiente no Google Cloud. É necessário instalar o agente do Google Cloudpara SAP em todas as VMs que executam qualquer sistema SAP. Esse agente coleta e envia todas as informações necessárias que a SAP exige para o agente de host do SAP. Para mais informações, consulte a Nota SAP 2469354.

Para coletar as métricas de infraestrutura e aplicativo usadas para observabilidade, ative outros recursos para o Agente para SAP.

Este documento descreve como ativar esses recursos no Agente para SAP.

Lista de verificação para o agente para SAP

A lista de verificação a seguir resume as tarefas que você precisa realizar para garantir que o agente para SAP esteja configurado corretamente para a observabilidade:

Instalar e configurar o agente para SAP		 Instale e configure o agente do Google Cloudpara SAP em cada VM do Compute Engine que você quer monitorar.
O agente para SAP é empacotado com as seguintes imagens públicas do SO "for SAP":
  • RHEL: todas as imagens "for SAP"
  • SLES: SLES 15 SP4 para SAP e versões posteriores

Para mais informações, consulte Instalar e configurar o Agente para SAP em uma VM.
Atualizar o agente para SAP		 A versão 3.5 do agente para SAP contém todos os recursos necessários para configurar a observabilidade do SAP. Se o agente já tiver sido instalado, recomendamos que você atualize para a versão mais recente.

Para mais informações, consulte Atualizar o agente do Google Cloudpara SAP.
Ativar o recurso de descoberta de sistema do agente para SAP		 No arquivo de configuração do agente, os parâmetros a seguir precisam ser definidos como true. Se você instalou o agente após 14 de fevereiro de 2024, essas flags são definidas como true por padrão, e não é necessário fazer nenhuma mudança.
  • discovery_configuration.enable_workload_discovery
  • discovery_configuration.enable_discovery
Se você instalou o agente antes de 14 de fevereiro de 2024 ou desativou o recurso de descoberta do sistema, execute os seguintes comandos:
         sudo /usr/bin/google_cloud_sap_agent configure -feature=sap_discovery -enable 

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

Para mais informações, consulte Configurar o agente do Google Cloudpara SAP.
Ativar a coleta de métricas do Monitoramento de processos do agente para SAP		 No arquivo de configuração do agente, o parâmetro collection_configuration.collect_process_metrics precisa ser definido como true. Para ativar o recurso, execute o seguinte comando: 
         sudo /usr/bin/google_cloud_sap_agent configure -feature=process_metrics -enable

Para mais informações, consulte Configurar a coleta de métricas do monitoramento de processos.
Ativar a coleta de métricas de monitoramento do HANA do agente para SAP		 Nas VMs do HANA, é necessário ativar a coleta de métricas de monitoramento de processo do HANA. Para ativar esse recurso, execute o seguinte comando: 
         sudo /usr/bin/google_cloud_sap_agent configure -feature=hana_monitoring -enable

Edite a seção hana_monitoring_configuration no arquivo de configuração do agente para informar o nome da instância do HANA, SID, host, porta, usuário e senha (usando o secret ou uma chave hdbuserstore).

O usuário do HANA especificado precisa ter acesso de leitura às tabelas consultadas pelas consultas padrão.

Para mais informações, consulte Configurar a coleta de métricas de monitoramento do SAP HANA.
Validar a configuração do agente e a Google Cloud configuração		 Para verificar se o agente está configurado corretamente, execute este comando: 
         sudo /usr/bin/google_cloud_sap_agent status

Para mais informações, consulte Validar a configuração da observabilidade do Workload Manager.
Reiniciar o agente para SAP		 Reinicie o agente para que as mudanças entrem em vigor executando o seguinte comando: 
         sudo systemctl restart google-cloud-sap-agent

Para mais informações, consulte Reiniciar o agente.

Validar a configuração da observabilidade do Workload Manager

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. Esse comando tem suporte a partir da versão 3.7 do agente.

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

  1. Estabeleça uma conexão SSH com a instância do Compute Engine.

  2. Execute este comando:

    sudo /usr/bin/google_cloud_sap_agent status

    Se a configuração Google Cloud para usar o serviço de observabilidade do Workload Manager estiver correta, a saída incluirá o seguinte: Sua configuração pode ter valores diferentes dos de default.

    Agent Status:
    Installed version: 3.7-....
    ...
    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:      5    (default)
        process_metrics_to_skip:        []   (default)
        slow_process_metrics_frequency: 30   (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 a saída indicar que alguma configuração está faltando, revise as informações fornecidas nas seções anteriores, realize as ações necessárias e execute novamente o comando status para validar a configuração.

Exemplo: arquivo de configuração

Depois de ativar os recursos de observabilidade, o arquivo de configuração do agente para SAP vai ficar parecido com este:

  {
    "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
  },
  "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": "system",
        "secret_name": "password-secret-name"
      },
    ],
   }
  }

A seguir