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

Neste guia, mostramos como resolver problemas com a versão 2 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
Coleta de métricas de monitoramento do SAP HANA

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, métricas de avaliação do Gerenciador de cargas de trabalho ou métricas de monitoramento do SAP HANA, os escopos de acesso da instância de VM do host também precisarão ter acesso de gravação para publicar dados de métricas do 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 o está executando foi criado sem um endereço IP público.

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: a coleta das métricas de monitoramento do SAP HANA falhou

Problema: ao fazer upgrade do agente de monitoramento para SAP HANA, depois de instalar o agente do Google Cloud para SAP, aparece uma mensagem de erro semelhante a esta:

tls: failed to verify certificate: x509: certificate relies on legacy Common Name field, use SANs instead

Causa: o agente do Google Cloud para SAP não pode iniciar a coleta de métricas de monitoramento do SAP HANA porque as instâncias de destino do SAP HANA usam certificados SSL especificados com o nome comum (CN, na sigla em inglês).

Resolução: para resolver esse problema, siga estas etapas:

  1. Para as instâncias do SAP HANA que você quer monitorar usando o agente do Google Cloud para SAP, é necessário começar a usar um certificado SSL de nome de assunto alternativo (SAN) em vez de certificados SSL que são especificados com um nome comum (CN).

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

  3. Abra o arquivo de configuração do agente do Google Cloud para SAP:

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

  4. Na seção hana_monitoring_configuration, defina a propriedade enabled como true.

  5. 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 SAP HANA, conforme especificado no certificado TLS/SSL, bem como o valor correspondente.

    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.

  6. Salve o arquivo de configuração.

  7. Reinicie o agente do Google Cloud para SAP para que as novas configurações entrem em vigor:

    sudo systemctl restart google-cloud-sap-agent

  8. Verifique se o agente está coletando as métricas de monitoramento do SAP HANA. Para mais instruções, consulte Acessar as outras métricas.

  9. Desinstalar o agente de monitoramento para SAP HANA.

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.

Problema: para as imagens do SO SLES 15 SP4 para SAP e posteriores, o agente do Google Cloud para SAP não está em execução

Problema: quando você usa as imagens do SO SLES "para SAP", o agente do Google Cloud para SAP é pré-instalado. Porém, para as imagens do SO SLES 15 SP4 para SAP e posteriores, o agente pré-instalado para SAP não inicia sozinho.

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

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

  2. Execute este comando: 

    systemctl status google-cloud-sap-agent

    Se o agente não estiver em execução, a saída conterá inactive (dead). Exemplo: 

    google-cloud-sap-agent.service - Google Cloud Agent for SAP
 Loaded: loaded (/usr/lib/systemd/system/google-cloud-sap-agent.service; disabled; vendor preset: disabled)
 Active: inactive (dead)

Causa: o agente para SAP não inicia por conta própria devido a um problema com o empacotamento do SO.

Resolução: para resolver esse problema, siga estas etapas:

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

  2. Execute os comandos a seguir:

    sudo sed -i 's~ /usr/sap~ -/usr/sap~g' /usr/lib/systemd/system/google-cloud-sap-agent.service
sudo systemctl restart google-cloud-sap-agent

  3. Verificar se o agente está em execução: 

    systemctl status google-cloud-sap-agent

    O resultado será semelhante a este:

    google-cloud-sap-agent.service - Google Cloud Agent for SAP
  Loaded: loaded (/usr/lib/systemd/system/google-cloud-sap-agent.service; disabled; vendor preset: disabled)
  Active: active (running) since Wed 2023-07-12 03:07:23 UTC; 7s ago
Main PID: 6117 (google_cloud_sa)
   Tasks: 6
  Memory: 8.8M (max: 1.0G limit: 1.0G available: 1015.1M)
  CGroup: /system.slice/google-cloud-sap-agent.service
           └─ 6117 /usr/bin/google_cloud_sap_agent startdaemon

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 Versão 2: informações de diagnóstico do agente do Google Cloud para SAP.