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

Este documento descreve como configurar Google Cloud's Agent for SAP para configurar a observabilidade da carga de trabalho SAP usando o Workload Manager.

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

Antes de começar

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

Gerenciador de extensões de VM

Para configurar e gerenciar o agente em uma frota de instâncias do Compute Engine, é necessário criar uma política do Gerenciador de extensões de VM.

Para configurar o agente para definir a observabilidade de uma carga de trabalho SAP que está em execução em uma única zona, siga as seguintes etapas:

  1. Configure o Gerenciador de extensões de VM:

  2. Crie uma política de extensão de VM que instale e gerencie o Google Cloud's agente do Google Cloud para SAP nas instâncias de computação que executam a carga de trabalho SAP:

Gerenciador de pacotes

Se você gerenciar o ciclo de vida do agente manualmente em vez de usar o Gerenciador de extensões de VM, poderá configurar Google Cloudo agente do Google Cloud para SAP usando um gerenciador de pacotes:

  1. Estabeleça uma conexão SSH com a instância de computação que executa a carga de trabalho SAP.

  2. Verifique se você está executando a versão mais recente do agente do Google Cloud para SAP.

    Para informações sobre como atualizar o agente, consulte Atualizar Google Cloud's Agente para SAP.

  3. Para permitir que o agente procure detalhes sobre a carga de trabalho SAP e os envie ao 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
    
  4. Permita que o agente colete métricas dos processos em execução na carga de trabalho 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 processos relacionadas às instâncias de banco de dados do SAP HANA, é necessário configurar parâmetros adicionais na seção hana_metrics_config.

    Para mais informações, consulte Configurar a coleta de métricas de monitoramento de processos.

  5. Permita que o agente colete métricas das instâncias do SAP HANA em execução na carga de trabalho 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, é necessário configurar parâmetros adicionais.

    Para mais informações, consulte Configurar a coleta de métricas de monitoramento do SAP HANA.

  6. Salve o arquivo de configuração.

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

Configurar o agente para uma carga de trabalho multizonal

Gerenciador de extensões de VM

Para configurar e gerenciar o agente em uma frota de instâncias do Compute Engine, é necessário criar uma política do Gerenciador de extensões de VM.

Para configurar o agente para definir a observabilidade de uma carga de trabalho SAP que está em execução em duas ou mais zonas, siga as seguintes etapas:

  1. Configure o Gerenciador de extensões de VM:

  2. Crie uma política de extensão de VM que instale e gerencie Google Cloudo agente do Google Cloud para SAP nas instâncias de computação que executam o site principal da carga de trabalho SAP:

  3. Se você estiver executando uma carga de trabalho SAP de alta disponibilidade ou tiver um site de recuperação de desastres (DR) para a carga de trabalho SAP, 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 secundário ou de DR da carga de trabalho SAP. Google Cloud

Gerenciador de pacotes

Se você gerenciar o ciclo de vida do agente manualmente em vez de usar o Gerenciador de extensões de VM, poderá configurar Google Cloudo agente do Google Cloud para SAP usando um gerenciador de pacotes:

  1. Estabeleça uma conexão SSH com a instância de computação que executa a carga de trabalho SAP.

  2. Verifique se você está executando a versão mais recente do agente do Google Cloud para SAP.

    Para informações sobre como atualizar o agente, consulte Atualizar Google Cloud's Agente para SAP.

  3. Para permitir que o agente colete detalhes sobre a carga de trabalho SAP e os envie ao 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
    
  4. Permita que o agente colete métricas dos processos em execução na carga de trabalho 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 processos relacionadas às instâncias de banco de dados do SAP HANA, é necessário configurar parâmetros adicionais na seção hana_metrics_config.

    Para mais informações, consulte Configurar a coleta de métricas de monitoramento de processos.

  5. Permita que o agente colete métricas das instâncias do SAP HANA em execução na carga de trabalho 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, é necessário configurar parâmetros adicionais.

    Para mais informações, consulte Configurar a coleta de métricas de monitoramento do SAP HANA.

  6. Salve o arquivo de configuração.

  7. Se você estiver executando uma carga de trabalho SAP de alta disponibilidade ou tiver um site de recuperação de desastres (DR) para a carga de trabalho SAP, repita esse procedimento para todas as outras instâncias de computação que estão executando a carga de trabalho SAP.

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

Validar a configuração da observabilidade do Workload Manager

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

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

  1. Estabeleça uma conexão SSH com a instância do Compute Engine que está executando a carga de trabalho SAP.
  2. Verifique a Google Cloud configuração da observabilidade:

    sudo /usr/bin/google_cloud_sap_agent status
    

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

    Agent Status:
        Installed version: 3.13-....
        ...
        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 a saída indicar que alguma configuração está ausente, revise as informações fornecidas nas seções anteriores, execute as ações necessárias e execute o comando status novamente para validar a configuração.

  4. Se você estiver usando mais de uma instância de computação para executar a carga de trabalho, repita esse procedimento para todas as outras instâncias de computação que estão executando a carga de trabalho.

Exemplos de configurações de agentes

Os exemplos a seguir são arquivos de configuração concluídos do Google Cloudagente do Google Cloud para SAP configurado para oferecer suporte à observabilidade de uma carga de trabalho do SAP HANA:

O exemplo a seguir usa uma chave de repositório seguro de usuário (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 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. Recomendamos que você use uma chave de armazenamento seguro de usuário (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 com suporte do agente, consulte Parâmetros de configuração.

A seguir

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

    Para informações sobre como observar a carga de trabalho SAP, consulte Conferir métricas de observabilidade do SAP.