Versão 1: Guia de operações do agente do Google Cloud para SAP

Neste guia, abordamos considerações e procedimentos operacionais para executar a versão 1 do agente do Google Cloud para SAP em instâncias de VM do Compute Engine e servidores da Solução Bare Metal.

Entenda o ciclo de vida do agente

Ao gerenciar as operações do agente do Google Cloud para SAP, é útil entender o que o agente faz. Veja como isso funciona:

Você precisa instalar o agente do Google Cloud para SAP em cada instância de VM do Compute Engine ou no servidor da Solução Bare Metal que hospeda sistemas SAP. O agente é executado como um serviço do Linux ou do Windows.
Nas instâncias de VM do Compute Engine, o agente combina dados de monitoramento do Monitoring e das APIs Compute Engine.
Em servidores da Solução Bare Metal, para a coleta apenas de métricas do Agente de Host da SAP, o agente não acessa as APIs do Google Cloud.
O Agente de Host da SAP pesquisa o Agente do Google Cloud para SAP em busca de dados em cache, por HTTP. Ele agrega as métricas do agente de host do SAP, relata-as e as armazena no banco de dados SAP NetWeaver.
A transação ST06 ou a interface de linha de comando saposcol do SAP exibe as métricas agregadas do SAP Host Agent.
É possível conferir as métricas do Agente de Host da SAP no Agente do Google Cloud para SAP executando um comando em uma janela de terminal.

Verificar se o agente está em execução

Depois de instalar ou reiniciar o agente, é possível verificar se ele está sendo executado conforme o esperado.

Para verificar se o agente está em execução, siga estas etapas:

Linux

Estabeleça uma conexão SSH com o servidor da Solução Bare Metal ou a instância de VM.

Execute este comando:

systemctl status google-cloud-sap-agent

Se o agente estiver funcionando corretamente, a saída conterá active (running). 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

Windows

Use o RDP para se conectar à instância de VM.
Como administrador, execute o seguinte comando no PowerShell:
```
$(Get-Service -Name 'google-cloud-sap-agent' -ErrorAction Ignore).Status
```
Se o agente estiver em execução, o status mostrará Running.

Se o agente do Google Cloud para SAP não estiver em execução, reinicie o agente.

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:

No sistema SAP, insira a transação ST06.
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

Ver as métricas monitoradas

Depois de instalar ou atualizar a configuração do agente do Google Cloud para SAP, é possível conferir as métricas monitoradas do agente de host da SAP.

Para visualizar as métricas monitoradas do Agente de Host da SAP, siga estas etapas:

Linux

Estabeleça uma conexão SSH com a instância de VM do host do servidor da Solução Bare Metal.

Execute este comando:

curl http://localhost:18181

Se as métricas estiverem disponíveis, você receberá uma saída XML com informações sobre o sistema. Exemplo:

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
  <metrics>
  <metric category="cpu" context="vm" type="double" unit="Percent" last-refresh="1670422670" refresh-interval="60">
  <name>VM Processing Power Consumption</name>
  <value>0.0</value>
  </metric>

Windows

Use o RDP para se conectar à instância de VM.

Como administrador, emita o seguinte comando no PowerShell:

(Invoke-WebRequest -Uri 'http://localhost:18181').RawContent

Se as métricas estiverem disponíveis, uma saída XML será exibida com informações sobre o sistema. Exemplo:

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
  <metrics>
  <metric category="cpu" context="vm" type="double" unit="Percent" last-refresh="1670422528" refresh-interval="60">
  <name>VM Processing Power Consumption</name>
  <value>10.0</value>
  </metric>

Verificar as métricas de monitoramento de processos e de avaliação do gerenciador de cargas de trabalho

Depois de atualizar a configuração, verifique se as métricas de monitoramento de processos e de avaliação do gerenciador de cargas de trabalho estão disponíveis. É possível acessar as métricas e informações coletadas pelo agente do Google Cloud para SAP no Cloud Monitoring.

Para verificar as métricas no Monitoring, siga estas etapas:

No console do Google Cloud, acesse a página do Metrics Explorer do Monitoring.

Acessar o Metrics Explorer
Selecione a guia Configuração.
Abra o menu Selecionar uma métrica.
No menu Recursos, selecione Instância de VM.
No menu Categoria da métrica, selecione sap.
No menu Métrica, selecione metric: workload.googleapis.com/sap/service/active ou qualquer uma das novas métricas para criar um gráfico.
Clique em Aplicar.

Um gráfico será exibido com os valores das métricas de série temporal.

Reinicie o agente.

Se o agente do Google Cloud para SAP parar de funcionar ou você atualizar a configuração, reinicie o agente.

Selecione seu sistema operacional e siga estas etapas:

Linux

Estabeleça uma conexão SSH com a instância de VM do host.

Execute este comando:

sudo systemctl restart google-cloud-sap-agent

Windows

Estabeleça uma conexão RDP com sua instância de VM do host.
Como administrador, execute o seguinte comando no PowerShell:
```
Restart-Service -Name 'google-cloud-sap-agent' -Force
```

Faça upgrade do agente de monitoramento para SAP NetWeaver para o agente do Google Cloud para SAP

A instalação do agente do Google Cloud para SAP detecta automaticamente as versões mais antigas do agente de monitoramento para SAP NetWeaver, desativa o agente e, em seguida, remove o agente do servidor host durante a instalação.

Se o agente de monitoramento do SAP NetWeaver for detectado e um arquivo de configuração for encontrado durante a instalação, o processo vai migrar automaticamente as configurações para o agente do Google Cloud para SAP.

Para instruções sobre como instalar e configurar o agente do Google Cloud para SAP, consulte Escolher o guia de instalação e configuração do agente do Google Cloud para SAP.

Atualizar o agente do Google Cloud para SAP

Nesta seção, apresentamos as etapas para verificar se há uma versão atualizada do agente do Google Cloud para SAP disponível e como é possível atualizá-lo para a versão 3.2 (mais recente).

Se precisar atualizar para uma versão do agente que não seja a mais recente, entre em contato com o Cloud Customer Care.

Verificar se há atualizações

Selecione seu sistema operacional e siga estas etapas:

RHEL

Estabeleça uma conexão SSH com sua instância de VM do host.

Execute este comando:

sudo yum check-update google-cloud-sap-agent

SLES

Estabeleça uma conexão SSH com sua instância de VM do host.

Execute este comando:

sudo zypper list-updates -r google-cloud-sap-agent

Windows

Estabeleça uma conexão RDP com sua instância de VM do host.
Como administrador, execute o seguinte comando no PowerShell:
```
googet latest google-cloud-sap-agent
```

Instalar uma atualização

Para atualizar sua instância do agente do Google Cloud para SAP para a versão 3.2 (mais recente), selecione seu sistema operacional e siga as etapas abaixo.

Se você precisar instalar uma versão do agente que não seja a mais recente, entre em contato com o Cloud Customer Care.

RHEL

Estabeleça uma conexão SSH com sua instância de VM do host.

Execute este comando:

sudo yum --nogpgcheck update google-cloud-sap-agent

SLES

Estabeleça uma conexão SSH com sua instância de VM do host.

Execute este comando:

sudo zypper --no-gpg-checks update google-cloud-sap-agent

Windows

Estabeleça uma conexão RDP com sua instância de VM do host.
Como administrador, execute o seguinte comando no PowerShell:
```
googet install google-cloud-sap-agent
```

Reverter para uma versão anterior

Se necessário, reverta o agente do Google Cloud para SAP versão 1 para o agente de monitoramento para SAP NetWeaver versão 2.

Selecione seu sistema operacional e siga estas etapas:

RHEL

Estabeleça uma conexão SSH com sua instância de VM do host.
Execute este comando:
```
sudo yum remove google-cloud-sap-agent
```
Instale o agente de monitoramento para SAP NetWeaver versão 2. Para instruções sobre como instalar o agente de monitoramento para SAP NetWeaver, consulte este guia.

SLES

Estabeleça uma conexão SSH com sua instância de VM do host.

Execute este comando:

sudo zypper remove google-cloud-sap-agent

Instale o agente de monitoramento para SAP NetWeaver versão 2. Para instruções sobre como instalar o agente de monitoramento para SAP NetWeaver, consulte este guia de instalação.

Windows

Estabeleça uma conexão RDP com sua instância de VM do host.
Como administrador, execute o seguinte comando no PowerShell:
```
googet remove google-cloud-sap-agent
```
Instale o agente de monitoramento para SAP NetWeaver versão 2. Para instruções sobre como instalar o agente de monitoramento para SAP NetWeaver, consulte este guia de instalação.

Ver os registros do agente no Cloud Logging

Por padrão, os registros do agente do Google Cloud para SAP são redirecionados das instâncias de VM e dos servidores da Solução Bare Metal para o Cloud Logging.

Para ver os registros do agente no Logging, siga estas etapas:

No console do Google Cloud, acesse a página do Explorador de registros.

Acessar o "Explorador de registros"
Acesse o painel Consulta.
No menu suspenso Recursos, selecione Global e clique em Aplicar.
No editor de consultas, insira google-cloud-sap-agent.
Clique em Executar consulta.

Você verá os registros gerados pelas instâncias do agente em execução em todas as instâncias de VM ou nos servidores da Solução Bare Metal. Para filtrar os registros de uma máquina específica, use os filtros disponíveis na interface.

É possível desativar esse redirecionamento padrão dos registros do agente. Para fazer isso, siga estas etapas:

Estabeleça uma conexão SSH com a instância de VM do host do servidor da Solução Bare Metal.

Abra o seguinte arquivo de configuração:

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

Para o parâmetro log_to_cloud, atualize o valor para false.
Salve o arquivo de configuração.
Reinicie o agente para que essa alteração entre em vigor.