Solução de problemas da edição SAP BTP do SDK ABAP para Google Cloud

Para resolver problemas com a edição SAP BTP do SDK do ABAP para Google Cloud, a primeira etapa é descobrir a origem do problema. O problema pode estar relacionado à infraestrutura, ao ambiente do SAP BTP e às ferramentas que você está usando ou ao próprio SDK do ABAP para Google Cloud.

Se a análise apontar para um problema com o SDK ABAP para Google Cloud, solucione os problemas usando registros de aplicativos SAP e mensagens de erro.

Se você acredita que o problema está no ambiente ou nas ferramentas SAP, entre em contato com a SAP para receber ajuda.

Verificar os pré-requisitos

Verifique se todos os pré-requisitos foram atendidos para a instalação da edição SAP BTP do SDK do ABAP para Google Cloud. Para informações sobre os pré-requisitos de instalação do SDK, consulte Antes de começar.

Leia a documentação de suporte do SAP

Se você tiver uma conta de usuário da SAP, poderá encontrar a solução para muitos problemas de software da SAP lendo os artigos SAP Notes e a base de conhecimento da SAP, disponíveis no Launchpad de suporte da SAP ONE (em inglês). de dados.

Ver registros

Quando a geração de registros é configurada, a edição SAP BTP do SDK ABAP para Google Cloud registra mensagens de erro nos registros de aplicativos SAP. Para mais informações sobre a geração de registros, consulte Configurar a geração de registros.

Para acessar as mensagens de registro, siga estas etapas:

  1. Acesse a plataforma de lançamento do SAP Fiori do sistema BTP ABAP em que o ABAP SDK for Google Cloud está instalado.
  2. Abra o app SDK do Google: exibição de registros de aplicativos.

  3. Forneça os filtros de registro conforme apropriado:

    • De: selecione uma data de início para filtrar os registros.
    • Para: selecione uma data de término para filtrar os registros.
    • Objetos de registro: selecione um objeto de registro em que os registros precisam ser buscados.
    • Subobjeto de registro: selecione um subobjeto de registro em que os registros precisam ser buscados.
    • Nome do serviço: selecione os nomes dos serviços de API em que os registros precisam ser buscados.

  4. Clique em Ir. A lista de cabeçalhos de registro do aplicativo vai aparecer.

    Cabeçalhos de registro do aplicativo

  5. Clique em um cabeçalho de registro para acessar os registros detalhados do item. As mensagens de registro são exibidas com gravidade e carimbo de data/hora.

    Registros detalhados no nível do item

    Uma mensagem de registro geralmente consiste nas duas entradas a seguir:

    • Enter: fornece informações sobre o local do código em que ocorreu o erro. Para solucionar problemas, use esse local do código como um ponto de interrupção durante a depuração.
    • Mensagem de erro: fornece informações sobre um erro que ocorreu durante a execução de uma operação.

Depuração

Se você tiver a autorização necessária, poderá depurar as classes cliente da API.

Para depurar as classes cliente da API, use uma das seguintes opções:

  • Adicione um ponto de interrupção ao construtor da classe /GOOG/CL_HTTP_CLIENT e execute seu programa.

  • Adicione um ponto de interrupção ao método que você está usando e execute seu programa.

HTTP Trace

Ao solucionar erros, verifique o rastreamento de chamada HTTP nas Conexões de saída do sistema do Monitoramento SAP. Para mais informações, consulte a página da SAP, Como monitorar a comunicação de saída do sistema em geral (em inglês).

Problemas operacionais comuns

Ao consumir APIs do Google Cloud por meio dos métodos públicos de stub do cliente, os desenvolvedores podem encontrar erros e exceções. Esses erros e exceções são amplamente classificados em duas categorias:

Esta seção aborda os erros e as exceções acionadas pelo SDK.

/GOOG/MSG: 503 - HTTP Communication Failure exception occurred during the request sending

Problema: falha na solicitação HTTP para um método de API.

Causa: esse problema pode ser causado por problemas de conectividade.

Resolução: no projeto do Google Cloud de onde você está tentando acessar as APIs do Google Cloud, ative as APIs de destino. Para informações sobre como ativar as APIs do Google Cloud, consulte Como ativar APIs.

/GOOG/MSG:400 - Error generating STS token:Bad Request-invalid_request-Invalid value for " audience". This value should be the full resource name of the Identity Provider. See https://cloud.google.com/iam/docs/reference/sts/rest/v1/TopLevel/token for the list of possible formats.

Problema: não é possível gerar o token do Security Token Service (STS).

Causa: quando você está se autenticando no Google Cloud usando tokens por meio da federação de identidade da carga de trabalho ou da chave de API armazenada no Secret Manager, sua configuração de autenticação não tem as configurações necessárias.

Resolução: verifique e atualize os seguintes detalhes:

  • No app Arranjo de comunicação, atualize o ID do pool de federação da identidade da carga de trabalho e o ID do provedor de federação de identidade da carga de trabalho.

  • No aplicativo SDK do Google: configuração principal, para seu mapa de comunicação, atualize o ID do projeto do Google Cloud e o número do projeto do Google Cloud para a chave de cliente.

Para mais informações, consulte Configurar o SDK ABAP para o Google Cloud para usar a federação de identidade da carga de trabalho.

/GOOG/MSG:400 - Error generating STS token:Bad Request-invalid_scope-Invalid scope provided in the request

Problema: não é possível autenticar no Google Cloud.

Causa: ao se autenticar no Google Cloud usando tokens por meio da federação de identidade da carga de trabalho ou da chave de API armazenada no Secret Manager, o escopo do Google Cloud é inválido.

Resolução: no app SDK do Google: configuração principal, para seu mapa de comunicação, verifique se o Escopo do Google Cloud está https://www.googleapis.com/auth/cloud-platform:

/GOOG/MSG:461 - API Key not valid. Please pass a valid API Key

Problema: não é possível se autenticar no Google Cloud usando a autenticação baseada em chave de API.

Causa: uma chave de API inválida foi fornecida no acordo de comunicação.

Resolução: para resolver esse problema, mantenha um nome e uma versão válidos de chave secreta no acordo de comunicação associado. Além disso, verifique se uma chave de API válida está configurada no secret.

Para mais informações, consulte Configurar o SDK ABAP para o Google Cloud para usar uma chave de API armazenada no Secret Manager.

/GOOG/MSG: 461 - Communication Map entry for authentication service not maintained

Problema: o SDK não consegue determinar os artefatos de comunicação para autenticação.

Causa: o serviço de autenticação não tem um mapa de comunicação mantido.

Resolução: no app SDK do Google: configuração principal, crie um mapa de comunicação e mantenha o Tipo de autenticação correto para de autenticação que você usa.

Para criar um mapa de comunicação, consulte as instruções de métodos de autenticação em Configurar autenticação para a edição SAP BTP do SDK do ABAP para Google Cloud.

/GOOG/MSG: 461 - Communication Scenario not valid for default Google Authentication

Problema: o SDK não consegue determinar a estrutura de comunicação para autenticação.

Causa: a entrada mantida para o serviço de autenticação é inválida.

Resolução: no app SDK do Google: configuração principal, para a entrada do mapa de comunicação, verifique se a estrutura de comunicação está configurada com as configurações corretas de comunicação e o sistema de comunicação.

Para atualizar um acordo de comunicação, consulte as instruções sobre métodos de autenticação em Configurar a autenticação para a edição SAP BTP do SDK do ABAP para Google Cloud.

/GOOG/MSG:400 - Error generating IDP token: Not found

Problema: não é possível gerar o token do provedor de identidade com o serviço XSUAA.

Causa: quando você está autenticando no Google Cloud usando tokens por meio da federação de identidade da carga de trabalho ou da chave de API armazenada no Secret Manager, o URL do nome do host do serviço XSUAA ou o caminho é inválido no sistema de comunicação.

Resolução: verifique e atualize os seguintes detalhes:

  • No sistema de comunicação do serviço XSUAA ou no destino BTP usado no sistema de comunicação, mantenha o URL do nome do host correto.
  • No acordo de comunicação, mantenha um caminho válido.

/GOOG/MSG:400 - Error generating STS token: Not found

Problema: não é possível gerar o token do Security Token Service necessário para a autenticação.

Causa: quando você está se autenticando no Google Cloud usando tokens por meio da federação de identidade da carga de trabalho ou da chave de API armazenada no Secret Manager, e está usando um acordo de comunicação para o serviço STS, o sistema de comunicação associado ao serviço STS é inválido.

Resolução: verifique e atualize os seguintes detalhes:

  • No sistema de comunicação do serviço STS ou no destino BTP usado no sistema de comunicação, mantenha o URL do nome do host correto.
  • No acordo de comunicação, mantenha um caminho válido.

/GOOG/MSG:400 - Error generating IAM token: Not found

Problema: não é possível gerar o token do IAM necessário para a autenticação.

Causa: quando você está autenticando no Google Cloud usando tokens por meio da federação de identidade da carga de trabalho ou a chave de API armazenada no Secret Manager, e está usando um acordo de comunicação para o serviço do IAM o mapa de comunicação e o sistema de comunicação associados ao serviço IAM forem inválidos.

Resolução: verifique e atualize os seguintes detalhes:

  • No sistema de comunicação do serviço IAM ou no destino BTP usado no sistema de comunicação, mantenha o URL correto do nome do host.
  • No acordo de comunicação, mantenha um caminho válido.

Erros de validação de configuração

G001 | Check communication scenario

Causa: o cenário de comunicação configurado no mapa de comunicação não é compatível com a classe de autorização padrão /GOOG/CL_AUTH_GOOGLE.

Resolução: se você estiver usando /GOOG/CL_AUTH_GOOGLE como a classe de autorização, confira se um do cenário de comunicação a seguir é especificado no mapa de comunicação, dependendo do método de autenticação. :

Cenário de comunicação Autenticação
/GOOG/COM_SDK_WIF Federação de identidade da carga de trabalho
/GOOG/COM_SDK_APIKSM Chave de API com o Secret Manager

Para atualizar um mapa de comunicação, consulte as instruções sobre métodos de autenticação em Configurar a autenticação para a edição SAP BTP do SDK do ABAP para Google Cloud.

W001 | Check Comm. arrangement for WIF

Causa: o acordo de comunicação não pode ser identificado usando o cenário e o sistema de comunicação especificados no app SDK do Google: configuração principal.

Resolução: verifique se a disposição de comunicação do serviço de autenticação usa um cenário de comunicação e um sistema de comunicação válidos.

Para mais informações, consulte Configurar o SDK ABAP para o Google Cloud para usar a federação de identidade da carga de trabalho.

W002 | Fetch XSUAA token

Causa: ocorreu uma falha na recuperação do token XSUAA.

Resolução: verifique se a instância do serviço XSUAA está configurada corretamente.

Para mais informações, consulte Criar uma instância de serviço de autorização e confiança (XSUAA).

W003 | Fetch WIF Pool ID

Causa: o ID do pool de federação da identidade da carga de trabalho não existe no acordo de comunicação.

Resolução: no acordo de comunicação usado para o serviço de autenticação, verifique se o cenário de comunicação /GOOG/COM_SDK_WIF é usado e se um ID válido do pool de federação de identidade da carga de trabalho está especificados.

Para mais informações, consulte Configurar o SDK ABAP para o Google Cloud para usar a federação de identidade da carga de trabalho.

W004 | Fetch WIF Provider ID

Causa: o ID do provedor de federação da identidade da carga de trabalho não existe no acordo de comunicação.

Resolução: no acordo de comunicação usado para o serviço de autenticação, verifique se o cenário de comunicação /GOOG/COM_SDK_WIF é usado e se um ID válido do provedor da federação de identidade da carga de trabalho está especificados.

Para mais informações, consulte Configurar o SDK ABAP para o Google Cloud para usar a federação de identidade da carga de trabalho.

W005 | Fetch STS token

Causa: falha na recuperação do token STS.

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

W006 | Fetch IAM credential token

Causa: ocorreu uma falha na recuperação do token do IAM na API IAM Credentials.

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

  • No mapa de comunicação, verifique se o número do projeto do Google Cloud está sendo mantido corretamente. Para mais informações, consulte Configurar o SDK ABAP para o Google Cloud para usar a federação de identidade da carga de trabalho.
  • No mapa de comunicação, se uma entrada for mantida para o serviço iamcredentials:v1, verifique se o arranjo de comunicação mantido é válido, disponível no sistema, usa o mesmo cenário de comunicação e sistema de comunicação padrão, conforme especificado no app de configuração do SDK.

V001 | Check Comm. Arr. for API Key(SM)

Causa: o acordo de comunicação não pode ser identificado usando o cenário e o sistema de comunicação especificados no app SDK do Google: configuração principal.

Resolução: verifique se o acordo de comunicação mantido para o serviço de autenticação é válido, está disponível no sistema e usa o mesmo cenário e sistema de comunicação de acordo com o app de configuração do SDK.

Para mais informações, acesse Configurar o SDK ABAP para o Google Cloud para usar a chave de API do Secret Manager.

V002 | Fetch Secret Name

Causa: o nome do secret não existe no acordo de comunicação.

Resolução: no acordo de comunicação usado para o serviço de autenticação, verifique se o cenário de comunicação /GOOG/COM_SDK_APIKSM é usado e se um secret válido foi especificado.

Para mais informações, acesse Configurar o SDK ABAP para o Google Cloud para usar a chave de API do Secret Manager.

V003 | Fetch Secret Version

Causa: a propriedade Versão do secret não contém um valor válido no acordo de comunicação.

Resolução: no acordo de comunicação usado para o serviço de autenticação, verifique se o cenário de comunicação /GOOG/COM_SDK_APIKSM é usado e se uma versão válida do secret foi especificada.

Para mais informações, acesse Configurar o SDK ABAP para o Google Cloud para usar a chave de API do Secret Manager.

V004 | Fetch Token from Secret Manager

Causa: a API Secret Manager não conseguiu recuperar o secret que contém a chave de API.

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

Mensagens de erro retornadas pelas APIs do Google Cloud

Todos os stubs de cliente da API têm os parâmetros de exportação que fornecem o código de retorno da API e as mensagens de erro.

  • ev_ret_code contém os códigos de status HTTP. No caso de um erro retornado por uma API, esse parâmetro contém um valor 4XX.

  • ev_err_resp contém a categoria e a mensagem de erro retornada por uma API.

O exemplo a seguir mostra um erro retornado pela API quando você cria um novo tópico do Pub/Sub com um nome de tópico já existente.

  • ERROR_TEXT: conflito
  • ERROR_DESCRIPTION: o recurso já existe no projeto (resource=SAMPLE_TOPIC_01)

Para erros retornados por APIs, recomendamos que você consulte a documentação pública das APIs correspondentes.

Receba suporte da comunidade

Faça suas perguntas e discuta o ABAP SDK for Google Cloud com a comunidade nos Fóruns do Cloud.

Receber suporte

Se você precisar de ajuda para resolver problemas com a edição SAP BTP do SDK do ABAP para Google Cloud, colete todas as informações de diagnóstico disponíveis e entre em contato com o Cloud Customer Care.

Para mais informações sobre como entrar em contato com o atendimento ao cliente, consulte Como receber suporte para o SAP no Google Cloud.