Versão 2: guia de operações do agente do Google Cloud para SAP

Neste guia, abordamos considerações e procedimentos operacionais para executar a versão 2 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 a versão do agente

Depois de instalar ou reiniciar o agente do Google Cloud para SAP, é possível verificar a versão do agente.

Para acessar a versão do agente, siga estas etapas:

Linux

Para o RHEL, siga estas etapas:

Use o SSH para se conectar à máquina host.
Execute este comando:
```
yum info google-cloud-sap-agent
```

Para SLES, siga estas etapas:

Use o SSH para se conectar à máquina host.
Execute este comando:
```
zypper info google-cloud-sap-agent
```

Windows

Use o RDP para se conectar à máquina host.
Como administrador, execute o seguinte comando no PowerShell:
```
googet installed google-cloud-sap-agent
```

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

Conferir as métricas do SAP Host Agent

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

Para conferir as métricas do agente SAP Host coletadas pelo agente do Google Cloud para 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>

Conferir as outras métricas

Depois de atualizar a configuração do agente do Google Cloud para SAP a fim de coletar as métricas de monitoramento do processo, métricas de avaliação do Gerenciador de carga de trabalho, ou as métricas de monitoramento do SAP HANA, visualize-as para verificar se o agente está coletando as métricas como esperado.

Para ver as métricas e informações coletadas pelo agente do Google Cloud para SAP no Cloud 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 ou o servidor da Solução Bare Metal.

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 para o agente do Google Cloud para SAP de outros agentes do Google Cloud

A instalação do agente do Google Cloud para SAP detecta automaticamente versões anteriores do agente de monitoramento para SAP NetWeaver e do agente de monitoramento para SAP HANA e depois os desativa e remove das máquinas host durante a instalação.

Se esses agentes do Google Cloud forem detectados, as configurações nos seus arquivos de configuração também serão migradas para o agente do Google Cloud para SAP durante a instalação. Para fins de backup e referência, a configuração do agente de monitoramento para SAP HANA é copiada para o seguinte arquivo:

/etc/google-cloud-sap-agent/backup-of-hanamonitoring-configuration.yaml

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.

Como fazer upgrade de instâncias com SSL ativado

Se você tiver configurado o agente de monitoramento do SAP HANA para usar certificados SSL para comunicação com as instâncias do SAP HANA, ao instalar o agente do Google Cloud para SAP, toda a configuração de monitoramento do SAP HANA, exceto o SSL, são migradas para o agente do Google Cloud para SAP. Nesse caso, para usar o agente do Google Cloud para SAP a fim de monitorar as instâncias do SAP HANA, é preciso concluir as seguintes etapas:

Estabeleça uma conexão SSH com a instância de VM do host ou o servidor da Solução Bare Metal.
Abra o arquivo de configuração do agente do Google Cloud para SAP:
```
/etc/google-cloud-sap-agent/configuration.json
```
Na seção hana_monitoring_configuration, defina a propriedade enabled como true.
Na seção hana_monitoring_configuration.hana_instances, faça o seguinte para cada instância do SAP HANA que usa o protocolo TLS/SSL para comunicação segura:
1. Especifique o parâmetro enable_ssl e defina o valor dele como true.
2. Especifique o parâmetro host_name_in_certificate e defina o nome do host do SAP HANA, conforme especificado no certificado TLS/SSL, como o valor.
3. Especifique o parâmetro tls_root_ca_file e defina o caminho em que o certificado TLS/SSL está armazenado, bem como o valor dele.
Salve o arquivo de configuração.
Reinicie o agente para que as novas configurações entrem em vigor.
```
sudo systemctl restart google-cloud-sap-agent
```
Verifique se o agente está coletando as métricas de monitoramento do SAP HANA. Para mais instruções, consulte Acessar as outras métricas.
Desinstalar o agente de monitoramento para SAP HANA.

Se você tiver problemas de conexão com as instâncias do SAP HANA após esse upgrade, será possível visualizar os registros do agente na geração de registros e usar a guia de solução de problemas para resolvê-los.

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 a instância de VM do host ou o servidor da Solução Bare Metal.

Execute este comando:

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

SLES

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

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 a instância de VM do host ou o servidor da Solução Bare Metal.

Execute este comando:

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

SLES

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

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 o uso do agente de monitoramento do SAP HANA

Se você quiser reverter para usar o agente de monitoramento para SAP HANA e parar de usar o recurso de monitoramento do SAP HANA do agente do Google Cloud para SAP, siga estas etapas:

RHEL

Estabeleça uma conexão SSH com a instância de VM do host ou o servidor da Solução Bare Metal.
Para evitar a coleta de métricas duplicadas, desative a coleta de métricas de monitoramento do SAP HANA pelo agente do Google Cloud para SAP:
1. Abra o arquivo de configuração do agente do Google Cloud para SAP:
```
/etc/google-cloud-sap-agent/configuration.json
```
2. Na seção hana_monitoring_configuration, defina o parâmetro enabled como false.
3. Salve o arquivo de configuração.
4. Reinicie o agente para que as novas configurações entrem em vigor.
```
sudo systemctl restart google-cloud-sap-agent
```
Copie a configuração do agente de monitoramento do SAP HANA deste arquivo:
```
/etc/google-cloud-sap-agent/backup-of-hanamonitoring-configuration.yaml
```
Instale o agente de monitoramento para SAP HANA versão 2. Para instruções de instalação, consulte o Guia de instalação e operação do agente de monitoramento para SAP HANA V2.0.
No arquivo a seguir, cole a configuração do agente de monitoramento para SAP HANA que você copiou em uma etapa anterior:
```
/usr/sap/google-saphanamonitoring-agent/conf/configuration.yaml
```

Reinicie o agente de monitoramento do SAP HANA:

sudo systemctl start google-saphanamonitoring-agent

SLES

Estabeleça uma conexão SSH com a instância de VM do host ou o servidor da Solução Bare Metal.
Para evitar a coleta de métricas duplicadas, desative a coleta de métricas de monitoramento do SAP HANA pelo agente do Google Cloud para SAP:
1. Abra o arquivo de configuração do agente do Google Cloud para SAP:
```
/etc/google-cloud-sap-agent/configuration.json
```
2. Na seção hana_monitoring_configuration, defina o parâmetro enabled como false.
3. Salve o arquivo de configuração.
4. Reinicie o agente para que as novas configurações entrem em vigor.
```
sudo systemctl restart google-cloud-sap-agent
```
Copie a configuração do agente de monitoramento do SAP HANA deste arquivo:
```
/etc/google-cloud-sap-agent/backup-of-hanamonitoring-configuration.yaml
```
Instale o agente de monitoramento para SAP HANA versão 2. Para instruções de instalação, consulte o Guia de instalação e operação do agente de monitoramento para SAP HANA V2.0.
No arquivo a seguir, cole a configuração do agente de monitoramento para SAP HANA que você copiou em uma etapa anterior:
```
/usr/sap/google-saphanamonitoring-agent/conf/configuration.yaml
```

Reinicie o agente de monitoramento do SAP HANA:

sudo systemctl start google-saphanamonitoring-agent

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.