Collecter des données métier dans les traces

Collecter des données métier dans les traces

Objectif(s)

Permettre au développeur (ou au framework sous-jacent) de ne pas avoir à préciser les données métiers transportées dans une trace. La tâche est déléguée au moteur EFR, qui ajoutera les données en fonction du contenu de la trace.

Principe

Dans la vue d’une médiation, l’onglet “Clefs métier” permet de configurer les données à ajouter.

image-20250521-135807.png
Tableau des clefs métiers dans la vue d’une médiation

La valeur métier peut soit être sortie du corps de message, soit des headers associés.

Dans le cas où la valeur est issue du body, 3 options de récupérations sont possibles :

  • Option “JsonPath” : le “chemin” se chargera d’extraire la valeur associée du contenu JSON du message.

  • Option “XPath” : idem pour un contenu XML.

  • Option “none” : le body est intégralement repris. Ceci n’est pas conseillé pour un corps de message. La valeur du chemin ne sera pas utilisée.

Si une erreur surgit lors de la lecture JsonPath ou XPath (contenu ou chemin invalide), l’ajout échouera silencieusement.

À l'inverse, si plusieurs valeurs sont ressorties du JsonPath ou XPath, alors toutes seront ajoutées à la trace.

Dans le cas du header, seule l’option “none” est utilisée.

Le nom de la clef métier sera le nom de la donnée ajoutée au runtime.

image-20250521-140300.png
Capture d'écran du dialogue de création d’une clef métier.

Historique

Date

Commentaires

Date

Commentaires

Apr 1, 2025

Collecte avec JsonPath, XmlPath dans les body et headers.

 

 

Ce contenu est soumis au droit à Copyright. Il ne doit pas être utilisé sans accord de la société Middleware Editions.