...
Vos applications d’intermédiation doivent envoyer ces traces à EFR.
Drawio | ||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
Ce diagramme illustre:
les publicateurs de traces,
l’API Traces comme point d’entrée dans EFR,
le stockage des traces dans votre espace Elasticsearch.
Description des traces
Ce moteur consomme des traces de transport composée des informations suivantes:
l’environnement d'émission *,
l'état de la trace *,
le message avec:
l' ID de corrélation,
les en-têtes,
son corps.
la description de l’émetteur:
son nom,
son identifiant *,
sa version,
sa description.
la liste des données métiers transportées,
l’exception dans le cas d’une erreur,
l’infrastructure de provenance.
*: champ obligatoire.
Exemple d’une trace:
Bloc de code | ||
---|---|---|
| ||
{ "version": "1", "environnement": "PROD", "state": "success", "message": { "created": "2019-10-30T12:30:04.123+01:00", "CorrelationID": "132-abc-456-def", "MessageID": "abc-123", "headers": [ { "name": "HEADER1", "value": "1234EFG" }, { "name": "HEADER2", "value": "1234EFG" } ], "type": "technical", "level": "info", "body": "<content><a>123</a><b>456</b></content>" }, "route": { "name": "job-ABC", "version": "1.2.2", "id": "Talend-ABC", "step": "Ecriture du fichier ABC", "description": "Ecriture du fichier ABC-123.txt" }, "business": [ { "value": "ABCD", "name": "Invoice" }, { "value": "DFEG", "name": "Invoice" } ], "infrastructure": { "instance": "processABC", "hostname": "server2", "datacenter": "paris" } } |
Qui publie des traces ?
Les publicateurs de traces sont des logiciels qui transportent de la donnée. Il s’agit de logiciels expert comme:
des ETL (Extract-Transform-Load),
des routes d’ESB (Enterprise Flows Repository),
des API (Application Performance Interface),
ou bien, généralistes, comme:
des scripts systèmes (bash, Powershell, etc),
des applications à façon (PHP, Java, .Net, etc),
des triggers de base de données.
API mises en oeuvre
API | Description | |
---|---|---|
Traces | API de publication des traces. | Spécifique à chaque environnement. /{environnement}/api/traces/{version}/ |