Versão 1: guia de solução de problemas do agente do Google Cloud para SAP

Neste guia, mostramos como resolver problemas com a versão 1 do agente do Google Cloud para SAP.

Geração de registros

Verifique os registros no diretório que são específicos do seu sistema operacional.

Para ver os registros do agente do Google Cloud para SAP, navegue até os seguintes caminhos:

Linux

/var/log/google-cloud-sap-agent.log

Windows

C:\Program Files\Google\google-cloud-sap-agent\logs\google-cloud-sap-agent.log

Problemas comuns

Problema: permissões insuficientes do IAM

Problema: o agente do Google Cloud para registros SAP mostra um erro de permissões de IAM insuficiente.

Causa: a conta de serviço não tem as permissões de IAM necessárias para acessar a API Cloud Monitoring.

Resolução: no console do Google Cloud, na página de detalhes da instância de VM, anote o nome da conta de serviço da VM. Por exemplo, sap-example@example-project-123456.iam.gserviceaccount.com. Na página inicial do IAM e do administrador, verifique se a conta de serviço inclui os seguintes papéis do IAM:

Recurso Papéis do IAM obrigatórios
Coleta de métricas do agente de host da SAP
Coleta de métricas do monitoramento de processos
Coleta de métricas de avaliação do gerenciador de cargas de trabalho

Para mais informações sobre a autenticação necessária para o agente do Google Cloud para SAP, consulte Autenticação e acesso.

Para confirmar as permissões exigidas pelo agente do Cloud Monitoring, consulte a seguinte documentação do Monitoring:

Problema: escopos de acesso incorretos para a conta de serviço da VM

Problema: se você limitar os escopos de acesso na instância de VM do host, o agente do Google Cloud para registros SAP poderá mostrar um erro de permissões de IAM insuficiente.

Causa: o agente do Google Cloud para SAP exige escopos de acesso mínimos da API Cloud na instância da VM do host. Esse erro ocorre quando a conta de serviço não tem os escopos de acesso necessários.

Resolução: os escopos de acesso são o método legado de especificação das permissões da sua instância de VM. O Compute Engine recomenda configurar as instâncias de VM para permitir escopo de acesso total a todas as APIs do Cloud, assim como recomenda usar apenas as permissões do IAM da conta de serviço da VM para controlar o acesso aos recursos do Google Cloud.

Para resolver esse problema, como prática recomendada, defina todo o escopo de acesso cloud-platform na instância de VM e limite com segurança o acesso à API da conta de serviço com papéis do IAM. Exemplo:

  • https://www.googleapis.com/auth/cloud-platform

Se você limitar os escopos de acesso da instância de VM, verifique se a VM do host tem os seguintes escopos de acesso:

  • https://www.googleapis.com/auth/source.read_write
  • https://www.googleapis.com/auth/compute
  • https://www.googleapis.com/auth/servicecontrol
  • https://www.googleapis.com/auth/service.management.readonly
  • https://www.googleapis.com/auth/logging.admin
  • https://www.googleapis.com/auth/monitoring
  • https://www.googleapis.com/auth/trace.append
  • https://www.googleapis.com/auth/devstorage.full_control

Se você tiver ativado a coleta de métricas do Monitoramento de processos ou de avaliação do Gerenciador de cargas de trabalho, os escopos de acesso da instância da VM do host também precisarão ter acesso de gravação para publicar dados de métricas no seu projeto do Google Cloud:

  • https://www.googleapis.com/auth/monitoring.write

Para alterar os escopos de acesso, você precisa interromper a instância de VM, fazer as alterações e depois reiniciar a instância. Para receber instruções, consulte a documentação do Compute Engine. Você não precisa fazer alterações nas permissões dos papéis do IAM para esse problema.

Problema: agente de host da SAP ausente ou incorreto

Problema: o agente do Google Cloud para registros SAP mostra o erro do agente de host da SAP ausente ou incorreto.

Causa:: o agente de host da SAP ou o nível mínimo de patch obrigatório para o agente de host da SAP não está instalado. Para que o agente do Google Cloud para SAP funcione, seu sistema SAP precisa ter o SAP Host Agent instalado e o nível mínimo de patch necessário para ser mantido.

Resolução: para resolver esse problema, instale a versão necessária do agente de host da SAP. Para receber instruções sobre como instalar o agente de host da SAP, consulte a documentação da SAP.

Para ver os requisitos de versão do agente de host da SAP, consulte as seguintes notas SAP:

Problema: a instalação do agente do Google Cloud para SAP falhou

Problema: a instalação do agente falha quando o comando de instalação do gerenciador de pacotes (yum, zypper ou googet) é executado.

Causa: a instalação do agente falha porque o servidor host que está executando o agente foi criado sem um endereço IP público ou externo.

Resolução: para resolver esse problema, configure um gateway NAT que forneça ao servidor host acesso de saída à Internet. Para informações sobre como configurar um gateway NAT, consulte o guia de implantação do sistema SAP. Por exemplo, para SAP NetWeaver, consulte:

Problema: erro de conexão recusada

Problema: os registros do agente de host da SAP mostram o erro de conexão recusada.

Causa: não é possível iniciar o agente do Google Cloud para SAP porque a porta 18181 não está disponível. O agente do Google Cloud para SAP detecta solicitações na porta 18181. Essa porta precisa estar disponível para que o agente seja iniciado.

Resolução: para resolver esse problema, verifique se a porta 18181 está disponível para o agente do Google Cloud para SAP. Se outro serviço estiver usando a porta 18181, talvez seja necessário reiniciar esse outro serviço ou reconfigurá-lo para usar outra porta.

Como receber suporte para o agente do Google Cloud para SAP

Se você precisar de ajuda para resolver um problema com o agente do Google Cloud para SAP, colete as informações de diagnóstico necessárias e entre em contato com o Cloud Customer Care. Para mais informações, consulte Agente de informações de SAP do Google Cloud.