Lignage

L'écran Lignage permet de parcourir le graphe OpenLineage de la plateforme : quelle tâche lit quel jeu de données et produit quel autre. Chemin du portail : /data/lineage. Les gardiens des données, les auditeurs et les développeurs l'utilisent pour suivre l'origine des données d'un agent ou d'une base de connaissances.

Ce que montre l'écran

La section Graphe charge le graphe une fois et le dessine en couches : un nœud est placé une colonne à droite des nœuds dont il dépend (jusqu'à 13 colonnes). Les jeux de données sont dessinés en rectangles et les tâches (type job) en formes arrondies ; chaque nœud affiche les 20 premiers caractères de son nom, et des flèches suivent les arêtes.

Un clic sur un nœud le sélectionne et affiche sa fiche à droite : id, type, namespace, name, facets, last_event_type, updated_at. Avant tout clic, le panneau indique « Sélectionnez un nœud pour voir ses détails. »

Sans aucun événement, l'écran affiche « Aucun lignage enregistré » et l'aide « Les tâches d'ingestion et les agents émettent des événements OpenLineage. » Le serveur renvoie au plus 500 nœuds et écarte les nœuds d'exécution.

Actions

Bouton ou action	Ce qu'il fait	Appel API	Rôles
Ouverture de l'écran	Charge les nœuds et les arêtes	GET /v1/lineage/graph	tout utilisateur du tenant
Clic sur un nœud	Affiche la fiche du nœud (sans appel API)	aucun	tout utilisateur du tenant
Réessayer (état d'erreur)	Recharge le graphe	GET /v1/lineage/graph	tout utilisateur du tenant

Rôles

L'écran n'a aucune action d'écriture. Le Control Plane (services/control-plane/src/eai/domains/lineage/__init__.py) n'exige qu'un tenant pour le graphe ; les événements sont écrits par les tâches d'ingestion et les agents via POST /v1/lineage/events, pas depuis cet écran.

Tâches courantes

Trouver d'où une base de connaissances tire ses documents

1. Ouvrir le graphe. Chaque ingestion émet une exécution qui relie ses entrées et ses sorties. Ouvrez Lignage.

   Résultat attendu : le graphe en couches avec les jeux de données et les tâches.

   En cas d'échec : « Aucun lignage enregistré » signifie qu'aucune tâche n'a encore émis d'événement ; ingérez un document dans Bases de connaissances.

2. Sélectionner le jeu de données. Cliquez sur le nœud du jeu de données.

   Résultat attendu : sa fiche à droite, avec son namespace et ses facets.

   En cas d'échec : si le nom est tronqué, lisez le name complet dans la fiche.

Suivre un jeu de données en amont et en aval

1. Utiliser la vue jeu de données. Le graphe complet peut être grand. Ouvrez Quarantaine RAG, onglet Lignage d'un jeu de données, saisissez l'identifiant du jeu de données, puis Appliquer.

   Résultat attendu : les producteurs, les consommateurs et les graphes des deux côtés du jeu de données.

   En cas d'échec : not_found signifie que l'identifiant n'est pas un jeu de données connu.

Dépannage

Symptôme	Cause	Correction
« Aucun lignage enregistré »	Aucun événement OpenLineage n'a été reçu	Lancez une ingestion ou un agent qui émet du lignage
État d'erreur avec Réessayer	Le Control Plane n'a pas répondu à la demande du graphe	Cliquez sur Réessayer, puis vérifiez l'API
tenant_required (403)	Votre session n'a pas de tenant	Connectez-vous avec un compte d'un tenant
Un nœud n'a aucune flèche	Ses arêtes visent des nœuds au-delà des 500 renvoyés	Utilisez la vue jeu de données de Quarantaine RAG

Pages liées

• Quarantaine RAG
• Bases de connaissances
• Lignage des données