Guia de operações do agente de monitoramento do Google Cloud para SAP NetWeaver

Neste guia, abordamos considerações operacionais e procedimentos para executar o agente de monitoramento do SAP NetWeaver em VMs do Compute Engine e em servidores da Solução Bare Metal.

Noções básicas sobre o ciclo de vida do agente de monitoramento

Ao gerenciar operações de monitoramento, é útil entender o que o agente de monitoramento do SAP NetWeaver está fazendo. Veja como isso funciona:

É necessário instalar o agente de monitoramento do SAP NetWeaver em cada VM do Compute Engine ou servidor da Solução Bare Metal que hospeda sistemas SAP. O agente de monitoramento é executado como um serviço do Windows ou do Linux.
Nas VMs do Compute Engine, o Cloud Monitoring tem um agente local que coleta métricas, eventos e metadados do Google Cloud. O Compute Engine também fornece APIs que fornecem funcionalidade de monitoramento.
Nas VMs do Compute Engine, o agente de monitoramento do SAP NetWeaver combina dados de monitoramento do Monitoring com as APIs Compute Engine. Nos servidores da Solução Bare Metal, o agente não acessa as APIs do Google Cloud.
O SAP Host Agent pesquisa, em HTTP, no agente de monitoramento do SAP NetWeaver pelos dados armazenados em cache. Ele agrega as métricas, gera relatórios e as armazena no banco de dados SAP NetWeaver.
As métricas agregadas são exibidas pela transação ST06 do SAP ou pela interface de linha de comando saposcol.
É possível visualizar os dados do agente de monitoramento do SAP NetWeaver executando um comando em uma janela de terminal.

Acesso à API Cloud para o agente de monitoramento do SAP NetWeaver

Quando o agente de monitoramento do SAP NetWeaver está em execução em uma VM do Compute Engine, ele lê dados do Monitoring.

O acesso às APIs do Monitoring pode ser controlado pelas permissões do IAM concedidas à conta de serviço da VM do host, pelos escopos de acesso da API Google Cloud concedidos à VM ou pelos dois.

O Compute Engine recomenda usar apenas as permissões do IAM da conta de serviço da VM para controlar o acesso aos recursos do Google Cloud e definir os escopos de acesso da VM para permitir acesso total a todas as APIs do Cloud. Para mais informações, consulte Práticas recomendadas.

O agente de monitoramento do SAP NetWeaver usa a conta de serviço da VM host para recuperar métricas do Cloud Monitoring. Consequentemente, o agente de monitoramento exige que a VM do host tenha uma conta de serviço e que ela inclua a permissão monitoring.timeSeries.list, que está contida no papel predefinido Visualizador do Monitoring.

Se você limitar o acesso às APIs do Cloud, o agente de monitoramento do SAP NetWeaver exigirá os seguintes escopos mínimos de acesso da API Cloud na instância da VM do host:

Compute Engine: somente leitura
API Stackdriver Monitoring: somente leitura

Se você estiver executando o SAP NetWeaver em uma VM que não tem um endereço IP externo, será necessário ativar o acesso às APIs e aos serviços do Google Cloud para o agente de monitoramento do SAP NetWeaver.

Para ativar o acesso particular do Google em uma VM do Compute Engine em uma sub-rede, consulte Como configurar o acesso particular do Google.

Se você estiver executando o SAP NetWeaver em um servidor em uma extensão regional da Solução Bare Metal, o agente de monitoramento do SAP NetWeaver não exigirá acesso às APIs do Google Cloud.

Verificar se o agente de monitoramento do SAP NetWeaver está em execução

O agente de monitoramento do SAP NetWeaver é um servidor HTTP local.

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

Linux

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

Execute este comando:

sudo systemctl status google-sapnetweavermonitoring-agent

Se o agente de monitoramento do SAP NetWeaver estiver funcionando corretamente, a saída conterá active (running). Exemplo:

google-sapnetweavermonitoring-agent.service - Google Cloud monitoring agent for SAP NetWeaver
Loaded: loaded (/usr/lib/systemd/system/google-sapnetweavermonitoring-agent.service; enabled; vendor preset: disabled)
Active:  active (running)  since Thu 2021-09-02 07:21:42 UTC; 742ms ago
Main PID: 10723 (java)
Tasks: 26 (limit: 512)
CGroup: /system.slice/google-sapnetweavermonitoring-agent.service
       └─10723 /usr/sap/google-sapnetweavermonitoring-agent/jre/bin/java -Xms32m -Xmx64m -cp /usr/sap/google-sapnetweavermonitoring-age...

Windows

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

Execute este comando:

Get-Service -Name google-sapnetweavermonitoring-agent

Se o agente de monitoramento do SAP NetWeaver estiver funcionando corretamente, a coluna Status mostrará Running. Exemplo:

    Status   Name               DisplayName
    ------   ----               -----------
    Running  google-sapnetwe... Google Cloud monitoring agent for S...

Para verificar as métricas coletadas, consulte Visualizar as métricas monitoradas.

Se o agente de monitoramento do SAP NetWeaver não estiver em execução, consulte Reiniciar o agente de monitoramento do SAP NetWeaver.

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

É possível visualizar as métricas monitoradas pesquisando o servidor. Siga estas etapas:

Linux

Use SSH para se conectar à máquina host que você precisa monitorar.
No prompt de comando, digite o seguinte comando:
```
curl http://localhost:18181
```

Windows

Use o RDP para se conectar à máquina host que você precisa monitorar.
Em um navegador da Web, acesse o seguinte URL:
```
http://localhost:18181
```

O exemplo a seguir mostra as primeiras linhas da saída XML do agente de monitoramento do SAP NetWeaver.

VM do Compute Engine

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<metrics>
<metric category="config" context="vm" type="string" unit="none"
  last-refresh="1614389614" refresh-interval="0"><name>Data
  Provider Version</name><value>1.1.1.0</value>
</metric>
<metric category="config" context="host" type="string" unit="none"
last-refresh="1614389614" refresh-interval="0">
  <name>Cloud Provider</name><value>Google Cloud
  Platform</value>
</metric>
<metric category="config" context="vm" type="string" unit="none"
last-refresh="1614389614" refresh-interval="0">
  <name>Instance Type</name><value>n2-standard-16</value>
</metric>
<metric category="config" context="host" type="string" unit="none"
last-refresh="1614389614" refresh-interval="0">
  <name>Virtualization Solution</name><value>KVM</value>
</metric>
...
</metrics>

Servidor da Solução Bare Metal

O agente de monitoramento do SAP NetWeaver será configurado corretamente para uma máquina host da solução Bare Metal se o valor Instance Type mostrar bms-nn e o valor Hardware Model for Google Cloud Bare Metal, como mostrado no exemplo a seguir.

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<metrics>
<metric category="config" context="vm" type="string" unit="none"
last-refresh="1614391024" refresh-interval="0"><name>Data
Provider Version</name><value>1.1.1.0</value>
</metric><metric category="config" context="host" type="string"
unit="none" last-refresh="1614391024" refresh-interval="0">
<name>Cloud Provider</name><value>Google Cloud
Platform</value></metric><metric category="config"
context="vm" type="string" unit="none" last-refresh="1614391024"
refresh-interval="0"><name>Instance Type</name>
<value>bms-16.0</value></metric><metric
category="config" context="host" type="string" unit="none"
last-refresh="1614391024" refresh-interval="0"><name>Virtualization
Solution</name><value>N/A</value></metric><metric
category="config" context="host" type="string" unit="none"
last-refresh="1614391024" refresh-interval="0"><name>Hardware Manufacturer</name><value>Google</value></metric>
<metric category="config" context="host" type="string" unit="none"
last-refresh="1614391024" refresh-interval="0"><name>Hardware
Model</name><value>Google Cloud Bare Metal</value>
</metric>
...
</metrics>

Reiniciar o agente de monitoramento do SAP NetWeaver

Se o agente de monitoramento do SAP NetWeaver parar de funcionar, reinicie-o.

Selecione seu sistema operacional:

Linux

Estabeleça uma conexão SSH com sua VM do host.

Use o comando a seguir:

systemctl restart google-sapnetweavermonitoring-agent

Windows

Estabeleça uma conexão RDP com sua VM do host.

Use o comando a seguir:

Restart-Service -Force google-sapnetweavermonitoring-agent

Atualizar o agente de monitoramento para SAP NetWeaver

Para garantir que você tenha a versão mais recente do agente de monitoramento do SAP NetWeaver, verifique se há atualizações periodicamente.

Verificar se há atualizações

Selecione seu sistema operacional:

RHEL

Para verificar as atualizações do agente de monitoramento usando o gerenciador de pacotes:

Estabeleça uma conexão SSH com sua VM do host.

Use o comando a seguir:

sudo yum check-update google-sapnetweavermonitoring-agent

SLES

Para verificar as atualizações do agente de monitoramento usando o gerenciador de pacotes:

Estabeleça uma conexão SSH com sua VM do host.

Use o comando a seguir:

sudo zypper list-updates -r google-sapnetweavermonitoring-agent

Windows

Para verificar as atualizações do agente de monitoramento:

Estabeleça uma conexão RDP com sua VM do host.

Como administrador, emita o seguinte comando no PowerShell:

C:\Program Files\Google\google-sapnetweavermonitoring-agent\bin\updatecheck.ps1

Instalar uma atualização

Selecione seu sistema operacional:

RHEL

Para instalar o agente de monitoramento usando o gerenciador de pacotes:

Estabeleça uma conexão SSH com sua VM do host.

Use o comando a seguir:

sudo yum --nogpgcheck update google-sapnetweavermonitoring-agent

SLES

Para instalar o agente de monitoramento usando o gerenciador de pacotes:

Estabeleça uma conexão SSH com sua VM do host.

Use o comando a seguir:

sudo zypper --no-gpg-checks update google-sapnetweavermonitoring-agent

Windows

Para instalar o agente de monitoramento:

Estabeleça uma conexão RDP com sua VM do host.

Como administrador, emita o seguinte comando no PowerShell:

. { Invoke-WebRequest -useb https://storage.googleapis.com/cloudsapdeploy/netweaver-agent-windows/install.ps1 } | iex