Objectif

Enterprise Flows Repository est un moteur avancé pour analyser, regrouper et agréger des traces de transport de flux.

Vos applications d’intermédiation doivent envoyer ces traces à EFR.

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:

{
  "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