Configure o agente para SAP para a recolha de métricas

O agente da Google Cloud para SAP oferece suporte para a monitorização das suas cargas de trabalho SAP em execução em instâncias do Compute Engine e ajuda a executar sistemas SAP de forma eficiente no Google Cloud.Google Cloud Tem de instalar o agente do Google Cloud para SAP em todas as VMs que executam qualquer sistema SAP. Google CloudEste agente recolhe e envia todas as informações necessárias que a SAP exige ao agente do anfitrião da SAP. Para mais informações, consulte a nota SAP 2469354.

Para recolher as métricas da infraestrutura subjacente e da aplicação que são usadas para a observabilidade, tem de ativar funcionalidades adicionais para o agente para SAP.

Este documento descreve como ativar estas funcionalidades no agente para SAP.

Lista de verificação do agente para SAP

A seguinte lista de verificação resume as tarefas que tem de realizar para garantir que o agente para SAP está configurado corretamente para observabilidade:

Instale e configure o agente para SAP		 Instale e configure o agente da Google Cloud's para SAP em cada VM do Compute Engine que quer monitorizar.
O agente para SAP está incluído nas seguintes imagens de SO públicas "para SAP":
  • RHEL: todas as imagens "for SAP"
  • SLES: SLES 15 SP4 para SAP e versões posteriores

Para mais informações, consulte o artigo Instale e configure o agente para SAP numa VM.
Atualize o agente para SAP		 A versão 3.5 do agente para SAP contém todas as funcionalidades necessárias para configurar a observabilidade para SAP. Se o agente tiver sido instalado anteriormente, recomendamos que o atualize para a versão mais recente.

Para ver anotações das ocorrências de eventos SAP predefinidos, precisa da versão 3.7 ou posterior do agente.

Para mais informações, consulte o artigo Atualize Google Cloudo agente para SAP.
Ative a funcionalidade de deteção do sistema do agente para SAP		 No ficheiro de configuração do agente, os seguintes parâmetros têm de estar definidos como true. Se instalou o agente após 14 de fevereiro de 2024, estas flags estão definidas como true por predefinição e não é necessária nenhuma alteração.
  • discovery_configuration.enable_workload_discovery
  • discovery_configuration.enable_discovery
Se instalou o agente antes de 14 de fevereiro de 2024 ou se desativou a funcionalidade de deteção 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 o artigo Configure o Google Cloudagente para SAP.
Ative o agente para a recolha de métricas de monitorização de processos da SAP		 No ficheiro de configuração do agente, o parâmetro collection_configuration.collect_process_metrics tem de ser definido como true. Para ativar a funcionalidade, execute o seguinte comando: 
         sudo /usr/bin/google_cloud_sap_agent configure -feature=process_metrics -enable

Para mais informações, consulte o artigo Configure a recolha de métricas de monitorização de processos.
Ative a recolha de métricas do agente para a monitorização do SAP HANA		 Nas VMs do HANA, tem de ativar a recolha de métricas de monitorização de processos do HANA. Para ativar esta funcionalidade, execute o seguinte comando: 
         sudo /usr/bin/google_cloud_sap_agent configure -feature=hana_monitoring -enable

Edite a secção hana_monitoring_configuration no ficheiro de configuração do agente para fornecer o nome da instância do HANA, o SID, o anfitrião, a porta, o utilizador e a palavra-passe (através de Secret ou de uma chave hdbuserstore).

Tenha em atenção que o utilizador do HANA especificado tem de ter acesso de leitura às tabelas consultadas pelas consultas predefinidas.

Para mais informações, consulte o artigo Configure a recolha de métricas de monitorização do SAP HANA.
Valide a configuração do agente e Google Cloud configure-o		 Verifique se o agente está configurado corretamente executando o seguinte comando: 
         sudo /usr/bin/google_cloud_sap_agent status

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

Para mais informações, consulte o artigo Reinicie o agente.

Valide a configuração da observabilidade do Workload Manager

Pode validar se tem a Google Cloud configuração correta para usar o serviço de observabilidade do Workload Manager executando o comando status do agente. Este comando é suportado a partir da versão 3.7 do agente.

Para validar a Google Cloud configuração, conclua os seguintes passos:

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

  2. Execute o seguinte comando:

    sudo /usr/bin/google_cloud_sap_agent status

    Se a Google Cloud configuração para usar o serviço de observabilidade do Workload Manager estiver correta, o resultado inclui o seguinte. A sua configuração pode ter valores diferentes dos valores 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:      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 o resultado indicar que falta alguma configuração, reveja as informações fornecidas nas secções anteriores, execute as ações necessárias e, em seguida, execute novamente o comando status para validar novamente a configuração.

Exemplo de ficheiro de configuração

Depois de ativar as funcionalidades de observabilidade, o ficheiro de configuração do agente para SAP tem um aspeto semelhante ao seguinte:

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

O que se segue?