Administration et dépannage

/IWFND/ERROR_LOG et /IWBEP/ERROR_LOG

/IWFND/ERROR_LOG et /IWBEP/ERROR_LOG sont les journaux des erreurs de SAP Gateway : /IWFND/ERROR_LOG enregistre les requêtes OData en échec côté hub Gateway, et /IWBEP/ERROR_LOG les erreurs levées dans l'implémentation du service back-end. Ensemble, ces deux journaux sont le premier point de diagnostic lorsqu'une application SAP Fiori affiche une erreur ou aucune donnée.

L'essentiel

Type
Transactions de dépannage SAP Gateway
Couche
Services et API
/IWFND/ERROR_LOG
Côté hub : erreurs de routage, d'autorisation et du framework
/IWBEP/ERROR_LOG
Côté back-end : erreurs de l'implémentation du service
Fonctions clés
Contexte de l'erreur, pile d'appels, rejeu dans le SAP Gateway Client
Utilisateurs
Équipes de support SAP Fiori, développeurs ABAP, administrateurs basis
S'applique à
SAP S/4HANA on-premise et Private Edition, SAP ERP (ECC)
Couche : Services et APIOù se situe-t-il ? ▾
Où se situe-t-il ?: L4 · Services et APICouche : Services et API.L1L2L3L4L5L6BTP

Couche : Services et API

Ouvrir la carte d'architecture →

À quoi servent /IWFND/ERROR_LOG et /IWBEP/ERROR_LOG ?

SAP Gateway écrit une entrée chaque fois qu'une requête OData échoue à l'exécution. Les deux journaux suivent la séparation entre les composants hub et back-end :

  • /IWFND/ERROR_LOG s'exécute sur le système hub Gateway. Il enregistre les erreurs de routage, de recherche de service et du framework, ainsi que les erreurs renvoyées par le back-end, avec le contexte de la requête pour tous les utilisateurs du mandant.
  • /IWBEP/ERROR_LOG s'exécute sur le système back-end. Il enregistre l'erreur à l'endroit où l'implémentation du service l'a levée, pile d'appels comprise.

Dans un déploiement embedded, les deux s'exécutent dans le même système. Chaque entrée propose le contexte de l'erreur, les données de la requête et des options de rejeu. /IWFND/ERROR_LOG vous indique qu'une requête a échoué et où ; /IWBEP/ERROR_LOG vous indique pourquoi le back-end l'a refusée.

Comment suivre une requête en échec pas à pas ?

Un acheteur d'Alder Manufacturing ouvre une application de commandes d'achat et n'obtient aucune donnée pour Bright Freight :

  1. Reproduisez le problème et notez l'heure, puis repérez l'appel OData en échec et son statut HTTP dans les outils de développement du navigateur.
  2. Ouvrez /IWFND/ERROR_LOG, filtrez par utilisateur et par heure, puis sélectionnez l'entrée.
  3. Lisez le contexte de l'erreur : le service, l'URI de la requête, la méthode HTTP et le texte du message.
  4. Suivez l'entrée jusqu'au back-end et ouvrez l'entrée correspondante dans /IWBEP/ERROR_LOG pour la pile d'appels et le message back-end.
  5. Rejouez la requête dans le SAP Gateway Client, sans l'application, en modifiant un paramètre à la fois.
  6. Augmentez temporairement le niveau de journalisation s'il manque des détails : sous Global Configuration, passez du niveau Secure par défaut à Full, puis revenez en arrière.

Suivre l'entrée du hub jusqu'à l'entrée du back-end transforme les journaux des erreurs de SAP Gateway d'une liste de symptômes en un chemin vers la cause racine.

Que signifient les entrées courantes des journaux des erreurs SAP Gateway ?

Type d'entréeCause probableÉtape suivante
Service introuvable pour un espace de noms et un nomService non enregistré ou mauvaise versionVérifier /IWFND/MAINT_SERVICE
Aucun alias système trouvéAlias manquant pour le serviceAffecter l'alias
Ressource introuvable pour le segment '…'Entity set ou clé erronés dans l'URIComparer l'URI avec les métadonnées du service
Erreur métier du back-endLa logique de validation ou de comptabilisation a rejeté les donnéesLire le message back-end dans /IWBEP/ERROR_LOG
Exception d'exécutionDump dans l'implémentationConsulter le short dump dans ST22

Les échecs d'autorisation apparaissent souvent plus clairement dans SU53 ou STAUTHTRACE. La plupart des entrées de /IWFND/ERROR_LOG renvoient à la configuration ; la plupart des causes racines de /IWBEP/ERROR_LOG renvoient aux données ou au code.

Quand utiliser les journaux des erreurs SAP Gateway ?

Ouvrez d'abord les journaux des erreurs lorsque :

  • une application SAP Fiori s'ouvre mais affiche une erreur, une liste vide ou un indicateur d'activité sans fin ;
  • un enregistrement échoue avec un message générique ;
  • une intégration signale des réponses HTTP 4xx ou 5xx d'un service OData.

Ne commencez pas par là lorsque la tile est absente ou que l'application ne s'ouvre pas du tout : il s'agit alors de problèmes de contenu du launchpad ou de rôles, diagnostiqués dans la couche launchpad. Les journaux des erreurs SAP Gateway répondent aux questions sur les requêtes de données en échec, pas sur la navigation dans le launchpad.

  • /IWFND/GW_CLIENT : rejoue et modifie la requête en échec.
  • /IWFND/TRACES : enregistre des traces de payload et de performance pour un utilisateur, utile lorsque rien n'est journalisé mais que les résultats sont faux.
  • /IWFND/APPS_LOG et /IWBEP/VIEW_LOG : journaux d'application côté hub et côté back-end.
  • /IWFND/CACHE_CLEANUP et /IWBEP/CACHE_CLEANUP : suppriment les métadonnées obsolètes après des modifications.
  • SU53 et STAUTHTRACE : confirment les échecs d'autorisation.
  • ST22 : affiche le short dump lorsque l'entrée back-end signale une exception d'exécution.
  • /IWFND/MAINT_SERVICE : vérifie l'enregistrement et les alias système pour les entrées « introuvable ».

Les journaux des erreurs localisent l'échec ; ces transactions confirment la cause et la correction.

/IWFND/ERROR_LOG, /IWBEP/ERROR_LOG ou /IWFND/GW_CLIENT : quelle différence ?

/IWFND/ERROR_LOG/IWBEP/ERROR_LOG/IWFND/GW_CLIENT
S'exécute surSystème hub GatewaySystème back-endSystème hub Gateway
AfficheRequêtes en échec avec le contexte côté hubErreurs back-end avec pile d'appelsRéponses en direct aux requêtes que vous envoyez
Question à laquelle il répondLa requête a-t-elle échoué, et où ?Pourquoi le back-end l'a-t-il rejetée ?Le service fonctionne-t-il sans l'application ?
Usage typiquePremier examen après le signalement d'un utilisateurCause racine dans le code du service ou les donnéesReproduire et tester une correction

Questions fréquentes

Pourquoi mon erreur n'apparaît-elle pas dans /IWFND/ERROR_LOG ?

La requête n'a peut-être jamais atteint SAP Gateway, par exemple lorsque l'intent de la tile n'a pas été résolu ou que le navigateur a bloqué l'appel. Vérifiez d'abord l'onglet réseau du navigateur et, dans un déploiement hub, regardez dans le système hub.

Les deux journaux des erreurs sont-ils nécessaires dans un déploiement embedded ?

Oui, mais les deux s'exécutent dans le même système. /IWFND/ERROR_LOG montre la requête côté Gateway, et /IWBEP/ERROR_LOG la vue back-end avec la pile d'appels. Passer de l'un à l'autre est le chemin d'analyse normal.

Pourquoi l'entrée du journal des erreurs masque-t-elle des détails comme le nom du service ?

Le niveau par défaut du journal des erreurs est Secure, qui omet certaines données d'application sensibles. Passez le niveau à Full sous Global Configuration pendant l'analyse d'un problème, puis revenez à Secure afin de limiter ce que le journal stocke.

Combien de temps les entrées des journaux des erreurs SAP Gateway sont-elles conservées ?

SAP documente une durée par défaut de 14 jours à compter de la date de l'erreur, modifiable sous Error Log > Global Configuration dans l'une ou l'autre transaction. Les entrées expirées sont supprimées par le job de nettoyage SAP Gateway des outils de support, que les administrateurs planifient. Reproduisez un problème peu après son signalement, afin que son entrée soit encore disponible.

Sources

S'applique à
SAP S/4HANA on-premise · SAP S/4HANA Cloud Private Edition · SAP ERP (ECC)
Dernière relecture

SAP, SAP Fiori, SAPUI5, SAP S/4HANA, SAP BTP et les autres produits et services SAP mentionnés sont des marques commerciales ou des marques déposées de SAP SE (ou d'une société affiliée à SAP) en Allemagne et dans d'autres pays. Ce guide est indépendant ; il n'est ni affilié à SAP SE, ni sponsorisé, ni approuvé par SAP SE.