Guia de solução de problemas do agente do Google Cloud para SAP

Neste guia, mostramos como resolver problemas com a versão 3.2 (mais recente) do agente do Google Cloud para SAP.

Para informações de solução de problemas e suporte do SAP, consulte as seguintes notas da 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

Se você ativou o recurso do Backint do agente do Google Cloud para SAP, analise os seguintes registros:

  • O arquivo backup.log do SAP HANA, que contém informações sobre as operações de backup e recuperação do SAP HANA.
  • O arquivo backint.log do SAP HANA, que contém as chamadas para a interface de backup usada pelo recurso Backint do agente e outras ferramentas de backup externas.
  • O arquivo de registros do Backint do agente do Google Cloud para SAP: /var/log/google-cloud-sap-agent/backint.log. Esse arquivo inclui informações sobre quando o recurso do Backint foi ativado, eventos operacionais relacionados e indicações de erros de comunicação com o Cloud Storage e problemas de configuração ou permissões relacionados.
  • Os registros do Google Cloud no Cloud Logging, que podem conter erros relacionados à conta de serviço usada pelo agente do Google Cloud para SAP. Para conferir esses registros, acesse a página Explorador de registros no console do Google Cloud.

Problemas comuns

As seções a seguir fornecem informações sobre problemas comuns relacionados ao uso do Agente do Google Cloud para SAP, suas causas e resolução.

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 usada pelo agente não tem as permissões do IAM necessárias para acessar a API Cloud Monitoring ou se você estiver usando o recurso Backint do agente e permissões suficientes para acessar o bucket do Cloud Storage.

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

  1. 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.

  2. Acesse a página IAM e administrador e, para a conta de serviço indicada, verifique se ela 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
    Backup e recuperação baseados em Backint para SAP HANA
    • Administrador de objetos do Storage (roles/storage.objectAdmin)
    • Criptografador/descriptografador de CryptoKey do Cloud KMS (roles/cloudkms.cryptoKeyEncrypterDecrypter), se você tiver usado uma chave de criptografia gerenciada pelo cliente para criptografar seus backups do SAP HANA no Cloud Storage. Para mais informações sobre esse recurso, consulte Opções de criptografia para backups.

    Para mais informações, consulte as Permissões necessárias do Cloud Storage.

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 as 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 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.

  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
    

Problema: baixa capacidade de processamento

Problema:a capacidade de processamento é menor do que a esperada.

Causa:para o recurso Backint do agente do Google Cloud para SAP, talvez você tenha ativado a compactação usando o parâmetro de configuração compress.

Resolução: para resolver esse problema, verifique se a compactação não está ativada. Para fazer isso, siga as etapas a seguir:

  1. Conecte-se ao host do SAP HANA usando SSH.

  2. Abra o arquivo de configuração do Backint:

    /usr/sap/SID/SYS/global/hdb/opt/backint/backint-gcs/parameters.json

    Substitua SID pelo SID do sistema em que você instalou os arquivos relacionados ao Backint.

  3. Verifique se o parâmetro compress está definido como false.

  4. Se você fizer alguma alteração, salve o arquivo de configuração.

Problema: erros de multistreaming

Problema: ocorrem erros ao fazer vários backups de dados.

Causa: para o recurso do Backint do agente do Google Cloud para SAP, talvez você tenha especificado um número maior de fluxos paralelos.

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

  1. Conecte-se ao host do SAP HANA usando SSH.

  2. Abra o arquivo de configuração do Backint:

    /usr/sap/SID/SYS/global/hdb/opt/backint/backint-gcs/parameters.json

    Substitua SID pelo SID do sistema em que você instalou os arquivos relacionados ao Backint.

  3. Se você definiu um valor para o parâmetro parallel_streams, diminua-o para 1.

    Se isso não resolver o erro, entre em contato com o atendimento ao cliente.

Problema ao se conectar ao Cloud Storage

Problema: você está com um problema de conectividade no seu bucket do Cloud Storage.

Causa: isso pode ser causado pelo seguinte:

  • Um problema temporário de conectividade.
  • A conta de serviço usada pelo agente do Google Cloud para SAP não tem as permissões necessárias para acessar seu Cloud Storage.
  • Há um problema com sua cota

Resolução:para solucionar um problema de conectividade com o bucket do Cloud Storage, verifique o seguinte:

  • Tente fazer o backup novamente ou recuperar para garantir que o erro não foi apenas um problema de conectividade momentâneo.
  • Se o agente do Google Cloud para SAP estiver usando a conta de serviço da sua VM, verifique se a VM tem acesso a todos os escopos da nuvem ou, se você estiver limitando o acesso, verifique se a VM tem acesso a storage.googleapis.com. Para mais informações, consulte Ativar o acesso a APIs do Cloud e servidores de metadados.
  • Se você criou uma conta de serviço para usar com o agente do Google Cloud para SAP, verifique o seguinte:
    • A conta de serviço recebe o papel Administrador de objetos do Storage.
    • A conta de serviço receberá o papel criptografador/descriptografador do CryptoKey do Cloud KMS se você estiver usando uma chave de criptografia gerenciada pelo cliente para criptografar backups no Cloud Storage. Para mais informações, consulte Criptografia para backups.
  • Verifique se você especificou corretamente os parâmetros no arquivo de configuração do Backint, PARAMETERS.json, e no arquivo global.ini do SAP HANA.

É possível testar o acesso ao bucket do Cloud Storage usando o recurso de autodiagnóstico integrado ao agente para SAP do Google Cloud. Para mais informações, consulte Autodiagnóstico.

Problema com uma operação de backup ou recuperação baseada em snapshot do disco

Problema: uma operação de backup ou recuperação realizada para o SAP HANA usando o comando hanadiskbackup ou hanadiskrestore do agente não é bem-sucedida.

Causa: esse problema pode ocorrer pelos seguintes motivos:

  • O agente apresenta um erro e sai da operação de backup ou recuperação.
  • O agente leva mais tempo do que o esperado para criar o snapshot do disco ou fazer upload dele para o Cloud Storage devido a um problema com um serviço subjacente do Google Cloud.
  • O agente falha sem um erro claro ou uma mensagem de sucesso.
  • A operação de backup ou recuperação falha devido a um problema no nível do sistema operacional.
  • O agente precisa aguardar mais tempo do que o esperado pelo banco de dados SAP HANA, o que pode ocorrer porque o banco de dados está com uma carga de trabalho muito pesada.

Resolução: para resolver esse problema, use as seguintes informações:

  • Se for uma operação de backup que não for bem-sucedida, faça o seguinte:

    1. Verifique se o agente está em execução. Se não estiver, reinicie o agente e, em seguida, tente realizar a operação de backup novamente.

    2. Se o agente estiver funcionando conforme esperado, o status da criação do snapshot:

      gcloud compute snapshots list
        --filter="sourceDisk:projects/PROJECT_ID/zones/ZONE_ID/disks/DISK_NAME"
      

      Substitua:

      • PROJECT_ID: o projeto do Google Cloud em que o disco de origem é implantado.
      • ZONE_ID: a zona do Compute Engine em que o disco de origem é implantado, por exemplo, us-central1-a.
      • DISK_NAME: o nome do disco de origem.

      O status de saída pode ser um dos seguintes: CREATING, UPLOADING ou READY.

    3. Se o status da criação do snapshot for CREATING ou UPLOADING, recomendamos que você aguarde a conclusão dessa operação, especialmente se esse for o primeiro snapshot que você está criando para o disco que hospeda seu volume /hana/data.

      Se essa operação falhar, o agente sairá automaticamente do procedimento e atualizará os registros. Tente criar o backup novamente executando o comando hanadiskbackup. O agente cuida da conclusão da operação de backup malsucedida no banco de dados SAP HANA e cria um novo backup baseado em snapshot.

    4. Se o status da criação do snapshot for READY, mas o comando hanadiskbackup ainda parecer estar em execução, isso indica que o agente está aguardando que o SAP HANA faça sua parte do procedimento de backup.

    5. Se o comando hanadiskbackup parecer estar em execução por mais tempo do que o esperado, faça o seguinte para retomar as operações normais do seu banco de dados SAP HANA:

      1. Descongele o sistema de arquivos XFS que contém o volume /hana/data:

        xfs_freeze -u PATH_TO_HANA_DATA_VOLUME
      2. No banco de dados do SAP HANA, consiga o ID de backup do snapshot de armazenamento com falha:

        SELECT BACKUP_ID, STATE_NAME, COMMENT FROM M_BACKUP_CATALOG WHERE ENTRY_TYPE_NAME = 'data snapshot' and STATE_NAME = 'prepared'
      3. No SAP HANA, atualize a entrada do snapshot com falha como malsucedido:

        BACKUP DATA FOR FULL SYSTEM CLOSE SNAPSHOT BACKUP_ID UNSUCCESSFUL 'Do not use - manually terminated';
        

      Substitua BACKUP_ID pelo BACKUP_ID que você procurou na etapa anterior.

    6. Para resolver o problema da operação de backup malsucedida, entre em contato com o Atendimento ao cliente com o pacote de suporte do agente.

  • Se for uma operação de recuperação malsucedida, conclua as etapas a seguir:

    1. Verifique se o disco original que hospeda o volume /hana/data está anexado à VM do host. Se não estiver, anexe-o usando o comando gcloud compute instances attach-disk.

    2. Verifique novamente os grupos de volumes e volumes lógicos:

      sudo /sbin/dmsetup remove_all
      sudo /sbin/vgscan -v --mknodes
      sudo /sbin/vgchange -ay
      sudo /sbin/lvscan
      sudo mount -av
      
    3. Se a nova verificação não for bem-sucedida, reinicie a VM do host. Isso faz com que o sistema operacional verifique novamente os grupos de volumes.

    4. No SAP HANA, verifique se o volume /hana/data está ativo.

    5. Se o volume /hana/data ainda não estiver ativo, entre em contato com o atendimento ao cliente do pacote de suporte do agente para resolver o problema.

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.