/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 ? ▾
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 :
- 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.
- Ouvrez /IWFND/ERROR_LOG, filtrez par utilisateur et par heure, puis sélectionnez l'entrée.
- Lisez le contexte de l'erreur : le service, l'URI de la requête, la méthode HTTP et le texte du message.
- 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.
- Rejouez la requête dans le SAP Gateway Client, sans l'application, en modifiant un paramètre à la fois.
- 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ée | Cause probable | Étape suivante |
|---|---|---|
| Service introuvable pour un espace de noms et un nom | Service non enregistré ou mauvaise version | Vérifier /IWFND/MAINT_SERVICE |
| Aucun alias système trouvé | Alias manquant pour le service | Affecter l'alias |
| Ressource introuvable pour le segment '…' | Entity set ou clé erronés dans l'URI | Comparer l'URI avec les métadonnées du service |
| Erreur métier du back-end | La logique de validation ou de comptabilisation a rejeté les données | Lire le message back-end dans /IWBEP/ERROR_LOG |
| Exception d'exécution | Dump dans l'implémentation | Consulter 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.
Quelles transactions associées vous aident ?
- /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 sur | Système hub Gateway | Système back-end | Système hub Gateway |
| Affiche | Requêtes en échec avec le contexte côté hub | Erreurs back-end avec pile d'appels | Réponses en direct aux requêtes que vous envoyez |
| Question à laquelle il répond | La 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 typique | Premier examen après le signalement d'un utilisateur | Cause racine dans le code du service ou les données | Reproduire 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
- SAP Help Portal: Error Log (SAP Gateway Foundation)
- SAP Help Portal: Which Tools Can Be Used for Troubleshooting? (SAP Gateway Foundation)
- SAP Help Portal: SAP Gateway Client — replay from the error context
- SAP Help Portal: Service Development in Hub System (V4) — error log level Secure vs. Full
- SAP Help Portal: Configuration Settings for the Error Log (SAP Gateway Foundation)
- S'applique à
- SAP S/4HANA on-premise · SAP S/4HANA Cloud Private Edition · SAP ERP (ECC)
- Dernière relecture