Administração e troubleshooting

/IWFND/ERROR_LOG e /IWBEP/ERROR_LOG

/IWFND/ERROR_LOG e /IWBEP/ERROR_LOG são os logs de erros do SAP Gateway: a /IWFND/ERROR_LOG registra requisições OData com falha no lado do hub do Gateway, e a /IWBEP/ERROR_LOG registra erros gerados na implementação do serviço no back-end. Juntos, os dois logs de erros do SAP Gateway são o primeiro ponto de diagnóstico quando um app SAP Fiori mostra um erro ou nenhum dado.

Resumo

Tipo: Transações de troubleshooting do SAP Gateway
Camada: Serviços e APIs
/IWFND/ERROR_LOG: Lado do hub: erros de roteamento, autorização e framework
/IWBEP/ERROR_LOG: Lado do back-end: erros da implementação do serviço
Recursos principais: Contexto do erro, call stack, reexecução no SAP Gateway Client
Quem usa: Equipes de suporte SAP Fiori, desenvolvedores ABAP, administradores de basis
Aplica-se a: SAP S/4HANA on-premise e Private Edition, SAP ERP (ECC)

Camada: Serviços e APIsOnde se encaixa ▾

Camada: Serviços e APIs

Abrir o mapa de arquitetura →

O que fazem a /IWFND/ERROR_LOG e a /IWBEP/ERROR_LOG?

O SAP Gateway grava uma entrada sempre que uma requisição OData falha em tempo de execução. Os dois logs seguem a divisão entre os componentes de hub e de back-end:

/IWFND/ERROR_LOG é executado no sistema hub do Gateway. Registra erros de roteamento, de localização do serviço e do framework, além dos erros devolvidos pelo back-end, com o contexto da requisição para todos os usuários do mandante.
/IWBEP/ERROR_LOG é executado no sistema back-end. Registra o erro no ponto em que a implementação do serviço o gerou, incluindo o call stack.

Em uma implantação embedded, as duas são executadas no mesmo sistema. Cada entrada oferece o contexto do erro, os dados da requisição e opções de reexecução. A /IWFND/ERROR_LOG informa que e onde uma requisição falhou; a /IWBEP/ERROR_LOG informa por que o back-end a recusou.

Como rastrear uma requisição com falha passo a passo?

Um comprador da Alder Manufacturing abre um app de pedidos de compra e não recebe nenhum dado da Bright Freight:

Reproduza o problema e anote o horário, e localize a chamada OData com falha e seu status HTTP nas ferramentas de desenvolvedor do navegador.
Abra a /IWFND/ERROR_LOG, filtre por usuário e horário e selecione a entrada.
Leia o contexto do erro: o serviço, a URI da requisição, o método HTTP e o texto da mensagem.
Siga a entrada até o back-end e abra a entrada correspondente na /IWBEP/ERROR_LOG para ver o call stack e a mensagem do back-end.
Reexecute a requisição no SAP Gateway Client, sem o app, alterando um parâmetro de cada vez.
Aumente temporariamente o nível do log se faltarem detalhes: em Global Configuration, mude do nível padrão Secure para Full e depois volte.

Seguir a entrada do hub até a entrada do back-end transforma os logs de erros do SAP Gateway de uma lista de sintomas em um caminho até a causa raiz.

O que significam as entradas comuns nos logs de erros do SAP Gateway?

Padrão da entrada	Causa provável	Próximo passo
Serviço não encontrado para um namespace e nome	Serviço não registrado ou versão errada	Verificar a /IWFND/MAINT_SERVICE
Nenhum system alias encontrado	Alias ausente para o serviço	Atribuir o alias
Recurso não encontrado para o segmento '…'	Entity set ou chave errados na URI	Comparar a URI com os metadados do serviço
Erro de negócio vindo do back-end	A lógica de validação ou de lançamento rejeitou os dados	Ler a mensagem do back-end na /IWBEP/ERROR_LOG
Exceção de runtime	Dump na implementação	Verificar o short dump na ST22

Falhas de autorização costumam aparecer com mais clareza na SU53 ou na STAUTHTRACE. A maioria das entradas na /IWFND/ERROR_LOG aponta para configuração; a maioria das causas raiz na /IWBEP/ERROR_LOG aponta para dados ou código.

Quando usar os logs de erros do SAP Gateway?

Abra os logs de erros primeiro quando:

um app SAP Fiori abre, mas mostra um erro, uma lista vazia ou um indicador de carregamento que não termina;
uma gravação falha com uma mensagem genérica;
uma integração recebe respostas HTTP 4xx ou 5xx de um serviço OData.

Não comece por eles quando o tile está ausente ou o app nem chega a abrir: esses são problemas de conteúdo do launchpad ou de role, diagnosticados na camada do launchpad. Os logs de erros do SAP Gateway respondem a perguntas sobre requisições de dados com falha, não sobre a navegação no launchpad.

/IWFND/GW_CLIENT: reexecuta e edita a requisição com falha.
/IWFND/TRACES: registra traces de payload e de performance de um usuário, útil quando nada é registrado no log, mas os resultados estão errados.
/IWFND/APPS_LOG e /IWBEP/VIEW_LOG: logs de aplicação nos lados do hub e do back-end.
/IWFND/CACHE_CLEANUP e /IWBEP/CACHE_CLEANUP: limpam metadados desatualizados após alterações.
SU53 e STAUTHTRACE: confirmam falhas de autorização.
ST22: mostra o short dump quando a entrada do back-end informa uma exceção de runtime.
/IWFND/MAINT_SERVICE: verifica o registro e os system aliases para entradas do tipo "not found".

Os logs de erros localizam a falha; essas transações confirmam a causa e a correção.

/IWFND/ERROR_LOG vs. /IWBEP/ERROR_LOG vs. /IWFND/GW_CLIENT: qual é a diferença?

	/IWFND/ERROR_LOG	/IWBEP/ERROR_LOG	/IWFND/GW_CLIENT
Executa em	Sistema hub do Gateway	Sistema back-end	Sistema hub do Gateway
Mostra	Requisições com falha e o contexto do lado do hub	Erros do back-end com call stack	Respostas em tempo real às requisições enviadas
Pergunta que responde	A requisição falhou, e onde?	Por que o back-end a rejeitou?	O serviço funciona sem o app?
Uso típico	Primeira análise após o relato de um usuário	Causa raiz no código ou nos dados do serviço	Reproduzir e testar uma correção

Perguntas frequentes

Por que meu erro não aparece na /IWFND/ERROR_LOG?

A requisição pode nunca ter chegado ao SAP Gateway, por exemplo quando o intent do tile não foi resolvido ou o navegador bloqueou a chamada. Verifique primeiro a aba de rede do navegador e, em uma implantação hub, procure no sistema hub.

Preciso dos dois logs de erros em uma implantação embedded?

Sim, mas as duas são executadas no mesmo sistema. A /IWFND/ERROR_LOG mostra a requisição do lado do Gateway, e a /IWBEP/ERROR_LOG mostra a visão do back-end com o call stack. Passar de uma para a outra é o caminho normal de análise.

Por que a entrada do log de erros oculta detalhes como o nome do serviço?

O nível padrão do log de erros é Secure, que omite alguns dados sensíveis da aplicação. Mude o nível para Full em Global Configuration enquanto analisa um problema e volte para Secure depois, para limitar o que o log armazena.

Por quanto tempo as entradas dos logs de erros do SAP Gateway são mantidas?

A SAP documenta um padrão de 14 dias a partir da data do erro, que pode ser alterado em Error Log > Global Configuration em qualquer uma das duas transações. As entradas expiradas são removidas pelo job de limpeza do SAP Gateway para utilitários de suporte, que os administradores agendam. Reproduza um problema logo depois de ele ser relatado, para que a entrada ainda esteja disponível.

Fontes

Aplica-se a: SAP S/4HANA on-premise · SAP S/4HANA Cloud Private Edition · SAP ERP (ECC)
Última revisão: 2026-11-09

/IWFND/MAINT_SERVICE /IWFND/GW_CLIENT SAP Gateway