Versão 1: instalar e configurar o agente do Google Cloud para SAP em um servidor da Solução Bare Metal

Version 1

• Versão 3.5 (latest)
• Versão 2
• Versão 1

Aviso: o suporte para a versão 1 do agente do Google Cloud para SAP foi encerrado em 4 de junho de 2024.

Se você estiver usando a versão 1 do agente, recomendamos que atualize para uma versão com suporte o mais rápido possível. Para informações sobre as versões com suporte, consulte Versões com suporte para SAP no Google Cloud. Para informações sobre como atualizar para uma versão com suporte do agente, consulte Atualizar o agente do Google Cloud para SAP.

O agente do Google Cloud para SAP é necessário para o suporte de sistemas SAP em execução em um servidor da Solução Bare Metal.

Se você usar as seguintes imagens de SO do RHEL ou do SLES "for SAP" fornecidas pelo Google Cloud, o agente do Google Cloud para SAP será empacotado com as imagens do SO:

• RHEL: todas as imagens "for SAP"
• SLES: SLES 15 SP4 para SAP e versões posteriores

Para informações sobre os sistemas operacionais disponíveis para executar o SAP em servidores da Solução Bare Metal, consulte:

• Para o SAP HANA, consulte Sistemas operacionais certificados.
• Para o SAP NetWeaver, consulte Sistemas operacionais certificados.

Para instalar e configurar a versão 1 do agente do Google Cloud para SAP em uma instância do Compute Engine, consulte Instalar o agente do Google Cloud para SAP em uma instância do Compute Engine.

Visão geral da instalação

Instale o agente do Google Cloud para SAP usando comandos padrão de gerenciamento de pacotes do sistema operacional: no RHEL, o comando yum. No SLES, o comando zypper. O comando de gerenciamento de pacotes conclui as seguintes tarefas:

• Faz o download do agente do Google Cloud para SAP.
• Cria o agente como um serviço systemd do Linux, chamado google-cloud-sap-agent.
• Ativa e inicia o serviço google-cloud-sap-agent.

Instalar o agente

Recomendamos que você instale a versão mais recente do agente do Google Cloud para SAP, que dá suporte a mais recursos. Para instruções, consulte Instalar e configurar o agente do Google Cloud para SAP em um servidor da Solução Bare Metal.

Para instalar a versão 1 do agente do Google Cloud para SAP, entre em contato com o Cloud Customer Care.

Depois de instalar o agente do Google Cloud para SAP e o agente de host da SAP, valide a instalação do agente do Google Cloud para SAP, conforme descrito em Validar a instalação do agente.

Validar a instalação do agente

1. Estabeleça uma conexão SSH com o servidor da Solução Bare Metal.

2. Execute este comando:

   systemctl status google-cloud-sap-agent

   Se o agente estiver funcionando corretamente, a saída conterá active (running). Por exemplo:

   google-cloud-sap-agent.service - Google Cloud Agent for SAP
   Loaded: loaded (/usr/lib/systemd/system/google-cloud-sap-agent.service; enabled; vendor preset: disabled)
   Active:  active (running)  since Fri 2022-12-02 07:21:42 UTC; 4 days ago
   Main PID: 1337673 (google-cloud-sa)
   Tasks: 9 (limit: 100427)
   Memory: 22.4 M (max: 1.0G limit: 1.0G)
   CGroup: /system.slice/google-cloud-sap-agent.service
          └─1337673 /usr/bin/google-cloud-sap-agent
   

Se o agente não estiver em execução, reinicie-o.

Verificar se o SAP Host Agent está recebendo métricas

Para verificar se as métricas de infraestrutura são coletadas pelo agente do Google Cloud para SAP e enviadas corretamente ao agente de host da SAP, siga estas etapas:

1. No sistema SAP, insira a transação ST06.

2. No painel de visão geral, verifique a disponibilidade e o conteúdo dos seguintes campos para a configuração completa da infraestrutura de monitoramento da SAP e do Google:

   • Provedor de nuvem: Google Cloud Platform
   • Acesso ao monitoramento avançado: TRUE
   • Detalhes do monitoramento avançado: ACTIVE

Configurar o agente do Google Cloud para SAP no Linux

Depois de instalar o agente do Google Cloud para SAP, é possível configurar o agente para ativar a coleta de Métricas de monitoramento de processo e Métricas de avaliação do gerenciador de cargas de trabalho. Por padrão, a coleta apenas das métricas do agente SAP Host está ativada.

A coleta de métricas de avaliação do gerenciador de cargas de trabalho e de métricas do Monitoramento de processos é aceita apenas no Linux.

Se você ativar as métricas de avaliação do Gerenciador de cargas de trabalho e a coleta de métricas do Monitoramento de processo, será necessário atender aos seguintes pré-requisitos:

• Crie uma conta de serviço do IAM para o agente de monitoramento acessar os recursos do Google Cloud. Conceda o papel do IAM necessário à conta de serviço. Consulte Configurar uma conta de serviço para mais informações.
• No servidor da Solução Bare Metal, instale a CLI gcloud. Consulte Instalar a gcloud CLI para mais detalhes.
• Para acessar o Google Cloud, autorize a CLI gcloud. Consulte os detalhes em Autorizar a CLI da gcloud.
• Estabeleça uma conexão com as APIs do Google Cloud. Consulte os detalhes em Como configurar o Acesso privado do Google para hosts locais.

Configurar uma conta de serviço

Para permitir que o agente acesse os recursos do Google Cloud em um ambiente da Solução Bare Metal, configure uma conta de serviço do IAM.

No mínimo, a conta de serviço que o agente usa precisa incluir o papel Gravador de métrica de monitoramento (roles/monitoring.metricWriter).

Para criar uma conta de serviço, siga estas etapas:

1. Create a service account:

   1. In the Google Cloud console, go to the Create service account page.

      Go to Create service account
   2. Select your project.

   3. In the Service account name field, enter a name. The Google Cloud console fills in the Service account ID field based on this name.

      In the Service account description field, enter a description. For example, Service account for quickstart.

   4. Click Create and continue.

   5. Grant the Monitoring > Monitoring Metric Writer role to the service account.

      To grant the role, find the Select a role list, then select Monitoring > Monitoring Metric Writer.

      Note: The Role field affects which resources the service account can access in your project. You can revoke these roles or grant additional roles later.
   6. Click Continue.

   7. Click Done to finish creating the service account.

      Do not close your browser window. You will use it in the next step.

2. Create a service account key:

   1. In the Google Cloud console, click the email address for the service account that you created.
   2. Click Keys.
   3. Click Add key, and then click Create new key.
   4. Click Create. A JSON key file is downloaded to your computer.
   5. Click Close.

Faça upload do arquivo de chave JSON em um local seguro no servidor da Solução Bare Metal acessível ao agente.

Ativar a coleta de métricas do monitoramento de processos e avaliação do gerenciador de cargas de trabalho

Para ativar as métricas de monitoramento de processos e de avaliação do gerenciador de cargas de trabalho, siga estas etapas:

1. Estabeleça uma conexão SSH com o servidor da Solução Bare Metal.

2. Abra o seguinte arquivo de configuração:

   /etc/google-cloud-sap-agent/configuration.json

3. Na seção collection_configuration, defina as seguintes propriedades como true:

   • collect_process_metrics: permite que o agente colete as métricas de monitoramento de processo. Para a coleta de métricas do banco de dados do SAP HANA, para acessar e consultar esse banco de dados, você precisa configurar outros parâmetros na seção hana_metrics_config.
   • collect_workload_validation_metrics: permite que o agente colete métricas de avaliação do gerenciador de cargas de trabalho.

   Para mais informações sobre os parâmetros, consulte a tabela a seguir.

4. Salve o arquivo de configuração.

5. Reinicie o agente para que as novas configurações entrem em vigor.

   sudo systemctl restart google-cloud-sap-agent

Parâmetros de configuração

A tabela a seguir explica os parâmetros de configuração da versão 1 do agente do Google Cloud para SAP.

Parâmetros
provide_sap_host_agent_metrics	Boolean Para ativar a coleta de métricas exigidas pelo agente de host SAP, especifique true. O padrão é true. Não defina provide_sap_host_agent_metrics como false, a menos que isso seja orientado pelo Cloud Customer Care ou pelo suporte da SAP.
bare_metal	Boolean Quando o agente for instalado em um servidor da Solução Bare Metal, especifique true. O padrão é false.
log_level	String Para definir o nível de geração de registros do agente, defina o valor necessário. Os níveis de registro disponíveis são estes: DEBUG INFO WARNING ERROR O padrão é INFO. Não altere o nível de geração de registros, a menos que isso seja orientado pelo Cloud Customer Care.
log_to_cloud	Boolean Para redirecionar os registros do agente para o Cloud Logging, especifique true. O padrão é true.
cloud_properties.project_id	String Se o sistema SAP estiver em execução em um servidor da Solução Bare Metal, especifique o ID do projeto do Google Cloud que você está usando com a Solução Bare Metal. Por padrão, quando o agente é executado em uma instância de VM, ele detecta o ID do projeto automaticamente.
cloud_properties.instance_id	String Especifique o nome do servidor da Solução Bare Metal em que você instalou o agente.
cloud_properties.region	String Se o sistema SAP estiver em execução em um servidor da Solução Bare Metal, especifique a região do servidor da Solução Bare Metal. Por padrão, quando o agente é executado em uma instância de VM, ele usa a região da instância em que o agente está instalado.
cloud_properties.zone	String Por padrão, quando o agente é executado em uma instância de VM, ele usa a zona da instância da VM em que o agente está instalado.
cloud_properties.image	String Especifique o nome da imagem do SO da instância. Por padrão, quando o agente é executado em uma instância de VM, ele detecta a imagem do SO da instância de VM em que o agente está instalado.
cloud_properties.numeric_project_id	String Especifique o ID numérico do projeto do Google Cloud em que o sistema SAP está sendo executado. Por padrão, quando o agente é executado em uma instância de VM, ele detecta o ID numérico do projeto automaticamente.
collection_configuration.collect_process_metrics	Boolean Para ativar a coleta de métricas de monitoramento de processo, especifique true. O padrão é false. Esse parâmetro é aplicável somente ao Linux. Se você ativar a coleta de métricas de processo para o SAP HANA, será necessário configurar outros parâmetros listados em hana_metrics_config.
collection_configuration.process_metrics_frequency	Int Especifique a frequência de coleta das métricas do monitoramento de processos em segundos. O valor padrão desse parâmetro é 5 segundos. Embora seja possível atualizar a frequência de coleta das métricas do monitoramento de processos, recomendamos usar o valor padrão. Se você precisar modificar o valor padrão, adicione o parâmetro process_metrics_frequency na seção collection_configuration e forneça o valor necessário.
collection_configuration.hana_metrics_config.hana_db_user	String Especifique a conta de usuário do banco de dados que o agente usa para consultar o SAP HANA. O padrão é SYSTEM.
collection_configuration.hana_metrics_config.hana_db_password	String Especifique a senha de texto simples para a conta de usuário do banco de dados que o agente usa para consultar o SAP HANA. Em vez de especificar uma senha de texto simples, recomendamos que você use uma das seguintes opções: hana_db_password_secret_name, para o qual você especifica um secret armazenado no Secret Manager.
collection_configuration.hana_metrics_config.hana_db_password_secret_name	String Para fornecer com segurança a senha da conta de usuário do banco de dados que o agente usa para consultar o SAP HANA, especifique o nome do secret que contém as credenciais de segurança para a conta de usuário do banco de dados. Importante: o secret e a instância de VM do host precisam existir no mesmo projeto do Google Cloud. O agente coleta as métricas relacionadas ao SAP HANA somente quando você especifica hana_db_password_secret_name, ou hana_db_password.
collection_configuration.hana_metrics_config.sid	String Especifique o SID da instância do SAP HANA. Se estiver usando uma chave HANA Userstore, consulte a seção hdbuserstore_key.
collection_configuration.collect_workload_validation_metrics	Boolean Para ativar a coleta de métricas de avaliação do gerenciador de cargas de trabalho, especifique true. A partir da versão 3.2, o valor padrão é true. Esse parâmetro é aplicável somente a Linux.
collection_configuration.workload_validation_metrics_frequency	Int A frequência de coleta das métricas de avaliação do gerenciador de cargas de trabalho em segundos. O valor padrão é de 300 segundos. Recomendamos que você não modifique a frequência de coleta padrão, porque isso pode afetar todo o recurso. Se você precisar modificar a frequência de coleta das métricas do gerenciador de cargas de trabalho, adicione o parâmetro workload_validation_metrics_frequency na seção collection_configuration e forneça o valor necessário.
collection_configuration.workload_validation_db_metrics_config.hana_db_user	String Especifique a conta de usuário usada para consultar a instância do SAP HANA. A conta de usuário precisa ter a permissão de leitura para o banco de dados SAP HANA.
collection_configuration.workload_validation_db_metrics_config.hana_db_password_secret_name	String Especifique o nome do secret no Secret Manager que armazena a senha da conta de usuário.
collection_configuration.workload_validation_db_metrics_config.sid	String Especifique o SID da instância do SAP HANA.
collection_configuration.workload_validation_db_metrics_config.hostname	String Especifique o identificador da máquina local ou remota que hospeda a instância do SAP HANA. Confira a seguir os valores compatíveis: Se o host for uma máquina local, especifique a string localhost ou o endereço IP do loopback do localhost, como 127.0.0.1. Se o host for uma máquina remota, especifique o endereço IP interno ou externo.
collection_configuration.workload_validation_db_metrics_config.port	String Especifique a porta em que a instância do SAP HANA aceita consultas. Para a primeira ou única instância do banco de dados do locatário, a porta é 3NN15, em que NN é o número da instância do SAP HANA.
collection_configuration.workload_validation_db_metrics_frequency	Int A frequência de coleta das métricas do banco de dados SAP HANA, em segundos, para avaliação do Gerenciador de cargas de trabalho. O padrão é 3600 segundos. Embora seja possível atualizar a frequência de coleta das métricas do banco de dados SAP HANA, recomendamos o uso do valor padrão. Se você precisar modificar o valor padrão, adicione o parâmetro workload_validation_db_metrics_frequency na seção collection_configuration e forneça o valor necessário. Não defina uma frequência de coleta maior que 3600 segundos.

Configuração padrão

{
  "provide_sap_host_agent_metrics": true,
  "log_level": "INFO",
  "log_to_cloud": true,
  "collection_configuration": {
    "collect_workload_validation_metrics": false,
    "collect_process_metrics": false
  }
}

Exemplo de configuração

Para instalar o agente em um servidor da Solução Bare Metal, você precisa adicionar as propriedades necessárias ao arquivo de configuração. No exemplo a seguir, mostramos um arquivo de configuração completo para instalar o agente em um servidor da Solução Bare Metal.

{
  "provide_sap_host_agent_metrics": true,
  "bare_metal": true,
  "log_level": "INFO",
  "log_to_cloud": true,
  "collection_configuration": {
    "collect_workload_validation_metrics": false,
    "collect_process_metrics": true,
    "hana_metrics_config": {
      "hana_db_user": "user",
      "hana_db_password_secret_name": "secret-name"
    }
  },
  "cloud_properties": {
    "project_id": "my-project",
    "instance_id": "bms-machine-1",
    "image": "rhel-8",
    "region": "us-central1"
  }
}

Acessar as métricas coletadas

Para visualizar as métricas do monitoramento de processos coletadas pelo agente, use os seguintes painéis personalizados fornecidos pelo Google Cloud:

• Agente do SAP: visão geral do HANA: este painel fornece gráficos que exibem a visão geral do status das seguintes métricas: Disponibilidade do SAP HANA, Disponibilidade de alta disponibilidade do SAP HANA, Replicação de alta disponibilidade do SAP HANA, Status de serviço do SAP HANA, Cluster de alta disponibilidade - Estado do nó e Cluster de alta disponibilidade - Estado de recurso para instâncias SAP.

  O arquivo JSON desse painel é sap-agent-status-overview.json.

• Agente do SAP: métricas brutas do HANA: este painel fornece gráficos que mostram valores de métricas brutas para as seguintes métricas: Disponibilidade do SAP HANA, Disponibilidade de alta disponibilidade do SAP HANA, Replicação de alta disponibilidade do SAP HANA, Status de serviço do SAP HANA, Cluster de alta disponibilidade - Estado do nó e Cluster de alta disponibilidade - Estado de recurso para instâncias SAP.

  O arquivo JSON desse painel é sap-agent-raw-metrics.json.

Instalar painéis

Para instalar um painel personalizado, siga estas etapas:

Console do Google Cloud

1. No Console do Google Cloud, acesse a página Monitoring.

   Acessar Monitoring

2. No painel de navegação do Monitoring, clique em Painéis.

3. Clique na guia Biblioteca de exemplo.

   

4. Para filtrar os painéis personalizados específicos do agente, digite Agent for SAP no campo Filtro.

5. (Opcional) Para conferir detalhes sobre um painel ou o conteúdo, clique em Visualizar.

6. Selecione o painel que você quer editar.

7. Clique em Importar e em Confirmar.

   O painel é adicionado aos painéis disponíveis no projeto do Google Cloud. Para consultar o painel, siga as instruções em Consultar o painel instalado.

Google Cloud CLI

1. Abra o Cloud Shell:

   Abrir o Cloud Shell

2. No Cloud Shell, clone ou faça o download do repositório:

   git clone https://github.com/GoogleCloudPlatform/monitoring-dashboard-samples/

3. No Cloud Shell, instale o painel necessário usando o arquivo JSON correspondente:

   gcloud monitoring dashboards create --config-from-file=CONFIG_FROM_FILE

   Substitua CONFIG_FROM_FILE pelo caminho para o arquivo JSON que contém a configuração do painel. Os arquivos de configuração do painel podem estar localizados no caminho: monitoring-dashboard-samples/dashboards/google-cloud-agent-for-sap.

   O painel é adicionado aos painéis disponíveis no projeto do Google Cloud. Para acessar o painel, siga as instruções em Visualizar o painel instalado.

Consultar os painéis instalados

Para consultar os painéis instalados, siga estas etapas:

1. No Console do Google Cloud, acesse a página Monitoring.

   Acessar Monitoring

2. No painel de navegação do Monitoring, clique em Painéis.

3. Clique no nome do painel na lista.

Se você tiver muitos painéis, filtre por painéis personalizados ou pelo nome do novo painel. Para mais informações sobre como filtrar essa lista, consulte Consultar painéis personalizados.

A imagem a seguir é um exemplo que mostra uma parte do painel personalizado para métricas do SAP HANA no Monitoring.

Solução de problemas

Para informações sobre como diagnosticar e resolver problemas que você pode encontrar ao instalar e configurar o agente do Google Cloud para SAP, consulte o guia de solução de problemas do agente do Google Cloud para SAP.

Receber suporte

Se você precisar de ajuda para resolver problemas com o agente do Google Cloud para SAP, colete todas as informações de diagnóstico disponíveis e entre em contato com o Cloud Customer Care. Para mais informações sobre como entrar em contato com o atendimento ao cliente, consulte Como receber suporte para o SAP no Google Cloud.