Bien que faciles à mettre en place dans leur forme la plus simple, les logs du bus de service d’Oracle peuvent se révéler plus compliqués à manipuler dès que l’on désire aller plus loin dans la mise en forme et la remontée des informations à loger précisément.

Nous allons voir ici les différentes méthodes mise à disposition pour débugger facilement les flux.

Mise en place et consultation de logs simple

Insertion de Reports dans les développements

Les reports représentent l’élément de base permettant la remontée d’information dans les flux OSB.
Pour les insérer dans un flux, il faut se rendre dans le panneau « Components » disponible nativement sur la droite de l’éditeur JDeveloper 12c puis dans la partie Reporting.

Une fois le Report déposé dans le flux, éditer ses « Properties » en insérant une balise XML contenant du XPath.

Consultation des logs dans l’Enterprise Manager

Le résultat de l’exécution d’un report peut ensuite être consulté via l’Enterprise Manager.
Sur l’onglet Service Bus, se rendre sur « Message Reports ».

Rechercher ensuite le Report puis l’afficher.

Mise en place de logs complexes

Utilisation de Reports Complexe

Lors de debuggage de flux complexes ou pour remonter facilement une donnée particulière, il est possible de personnaliser le message s’affichant dans les Reports.
Par exemple, dans le cadre d’une remontée d’erreur, préciser les variables a afficher (1) puis sélectionner ces valeurs via une expression XQuery.

Activation de la supervision des flux dans EM

Dans le cadre d’une recherche d’erreur où on ne souhaiterait pas impacter les développements, il est également possible d’activer des traces.
Elles permettent d’afficher dans les logs de l’OSB les traces des appels entrants et sortants.
Pour les afficher, rechercher le service à tracer dans l’onglet « Operations ».

Chercher ensuite à activer les traces en mode « Full » sur le Proxy Service correspondant au flux à tracer.

Il est également possible de modifier le niveau de traces en ouvrant le Proxy Service puis en modifiant le niveau de log dans la partie Tracing.