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, instâncias bare metal 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:
- É preciso instalar o agente do Google Cloud para SAP em cada instância 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 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 comandosaposcol
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 do Compute Engine.
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
Windows
Use o RDP para se conectar à instância do Compute Engine.
Como administrador, emita o seguinte comando no PowerShell:
Se o agente estiver em execução, o status mostrará$(Get-Service -Name 'google-cloud-sap-agent' -ErrorAction Ignore).Status
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
- Provedor de nuvem:
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 do host do Compute Engine ou o 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. Por 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 do Compute Engine.
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. Por 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.
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 computação do host.
Execute este comando:
sudo systemctl restart google-cloud-sap-agent
Windows
Estabeleça uma conexão RDP com a instância de computação do host.
Como administrador, emita 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.6 (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 computação do host.
Execute este comando:
sudo yum check-update google-cloud-sap-agent
SLES
Estabeleça uma conexão SSH com a instância de computação do host.
Execute este comando:
sudo zypper list-updates -r google-cloud-sap-agent
Windows
Estabeleça uma conexão RDP com a instância de computação do host.
Como administrador, emita 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.6 (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 computação do host.
Execute este comando:
sudo yum --nogpgcheck update google-cloud-sap-agent
SLES
Estabeleça uma conexão SSH com a instância de computação do host.
Execute este comando:
sudo zypper --no-gpg-checks update google-cloud-sap-agent
Windows
Estabeleça uma conexão RDP com a instância de computação do host.
Como administrador, emita 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 a instância de computação 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 a instância de computação 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 a instância de computação do host.
Como administrador, emita 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 do Compute Engine 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.
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ê encontra os registros gerados pelas instâncias do agente em execução em todas as instâncias do Compute Engine 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 do host do Compute Engine 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 parafalse
.Salve o arquivo de configuração.
Reinicie o agente para que essa alteração entre em vigor.