> ## Documentation Index
> Fetch the complete documentation index at: https://docs.coreweave.com/llms.txt
> Use this file to discover all available pages before exploring further.

> Affichez et parcourez les graphes de traçabilité des artifacts pour suivre les entrées et les sorties des runs W&B sous forme de graphe orienté acyclique.

# Explorer les graphes de traçabilité des artifacts

W\&B suit les entrées et les sorties des runs à l’aide de graphes orientés acycliques (DAG) appelés *graphes de traçabilité*. Les graphes de traçabilité représentent visuellement les relations entre les artifacts et les runs d’une expérience de ML. Ils montrent comment les données et les modèles
circulent entre les différentes étapes du cycle de vie du ML, de l’ingestion des données brutes jusqu’à l’entraînement et l’évaluation des modèles.

Le suivi de la traçabilité des artifacts présente plusieurs avantages clés :

* **Reproductibilité** : permet aux équipes de reproduire les expériences, les modèles et les résultats à des fins de débogage, d’expérimentation et de validation.
* **Contrôle de version** : suit l’évolution des artifacts au fil du temps, ce qui permet aux équipes de revenir à des versions antérieures des données ou des modèles si nécessaire.
* **Audit** : conserve un historique détaillé des artifacts et des transformations pour faciliter la conformité et la gouvernance.
* **Collaboration** : améliore le travail d’équipe en rendant l’historique des expériences transparent, en évitant les efforts redondants et en accélérant le développement.

<h2 id="view-an-artifacts-lineage-graph">
  Afficher le graphe de traçabilité d’un artifact
</h2>

Pour afficher le graphe de traçabilité d’un artifact :

1. Accédez au workspace de votre projet dans la W\&B App.
2. Cliquez sur l’onglet **Artifacts** dans la barre latérale du projet.
3. Sélectionnez un artifact, puis cliquez sur l’onglet **Lineage**.

<h2 id="navigate-lineage-graphs">
  Naviguer dans les graphes de traçabilité
</h2>

Le graphe de traçabilité est une représentation visuelle des relations entre les artifacts et les runs d’une expérience de ML. Utilisez l’interface de l’application W\&B ou le SDK Python pour explorer et parcourir le graphe de traçabilité d’un artifact.

<Tabs>
  <Tab title="Interface de l’application W&B">
    Les nœuds dotés d’icônes vertes représentent des runs. Les nœuds dotés d’icônes bleues représentent des artifacts. Les flèches entre les nœuds indiquent l’entrée et la sortie d’un run ou d’un artifact.

    Les nœuds d’artifact affichent le nom de l’artifact ainsi que sa version, sous la forme `<artifact_name>:<version>`. Le type de l’artifact apparaît au-dessus de son nom.

    <Note>
      Le type et le nom de l’artifact sont visibles à la fois dans la barre latérale gauche et dans le nœud du graphe de traçabilité.
    </Note>

    Les nœuds de run affichent le nom du run.

    <Frame>
      <img src="https://mintcdn.com/coreweave-dbfa0e8d/3Dv_sw2eg8feUJlx/products/wandb/_media/lineage2.png?fit=max&auto=format&n=3Dv_sw2eg8feUJlx&q=85&s=a2fd27e45b1a080e02a194af597debaf" alt="Nœuds de run et d’artifact" width="4608" height="1754" data-path="products/wandb/_media/lineage2.png" />
    </Frame>

    Cliquez sur un run pour obtenir plus d’informations à son sujet : heure de début, durée, auteur, type de job, etc. Cliquez sur un artifact pour obtenir plus d’informations à son sujet : alias, date de création, type, version, description, run qui l’a journalisé, taille du fichier, etc.

    <Frame>
      <img src="https://mintcdn.com/coreweave-dbfa0e8d/3Dv_sw2eg8feUJlx/products/wandb/_media/lineage3a.gif?s=312d9c111d2e9b16cb04de31f06c5865" alt="Aperçu d’un run" width="4754" height="1930" data-path="products/wandb/_media/lineage3a.gif" />
    </Frame>

    Les runs qui créent plusieurs versions d’un même artifact sont regroupés dans un cluster. Cliquez sur l’une des versions d’artifact du cluster pour afficher les informations propres à cette version.

    <Frame>
      <img src="https://mintcdn.com/coreweave-dbfa0e8d/3Dv_sw2eg8feUJlx/products/wandb/_media/lineage_multiple_artifact_versions.png?fit=max&auto=format&n=3Dv_sw2eg8feUJlx&q=85&s=0ec0d2f4d521f0a27be77dfaa156d212" alt="Cluster de versions d’artifact dans un graphe de traçabilité" width="4594" height="1866" data-path="products/wandb/_media/lineage_multiple_artifact_versions.png" />
    </Frame>

    Cliquez sur un nœud et faites-le glisser pour réorganiser le graphe et personnaliser la mise en page. Vous pouvez également zoomer et dézoomer pour mieux visualiser les nœuds et leurs relations.

    <Frame>
      <img src="https://mintcdn.com/coreweave-dbfa0e8d/3Dv_sw2eg8feUJlx/products/wandb/_media/lineage_rearrange_nodes.gif?s=81b87ad3898858fd9cc38b7f732237d3" alt="Réorganisation des nœuds dans un graphe de traçabilité" width="4754" height="2466" data-path="products/wandb/_media/lineage_rearrange_nodes.gif" />
    </Frame>

    Survolez un nœud avec la souris et cliquez sur l’icône en forme d’œil pour masquer ou afficher ce nœud dans le graphe. Vous pouvez ainsi désencombrer le graphe et vous concentrer sur certains nœuds et leurs relations.
  </Tab>

  <Tab title="SDK Python W&B">
    Parcourez un graphe par programmation à l’aide du SDK Python W\&B. Utilisez les méthodes
    [`logged_by()`](/fr/products/wandb/ref/python/experiments/artifact#method-artifact-logged-by) et [`used_by()`](/fr/products/wandb/ref/python/experiments/artifact#method-artifact-used-by) d’un objet artifact pour parcourir le graphe :

    ```python theme={"system"}
    with wandb.init() as run:
        artifact = run.use_artifact("artifact_name:latest")

        # Remonter et descendre dans le graphe à partir d’un artifact :
        producer_run = artifact.logged_by()
        consumer_runs = artifact.used_by()
    ```
  </Tab>
</Tabs>

<h2 id="enable-lineage-graph-tracking">
  Activer le suivi du graphe de traçabilité
</h2>

Pour activer le suivi du graphe de traçabilité, vous devez désigner les artifacts comme [entrées](/fr/products/wandb/artifacts/explore-and-traverse-an-artifact-graph) ou
[sorties](/fr/products/wandb/artifacts/explore-and-traverse-an-artifact-graph#track-the-output-of-a-run) d’un run à l’aide du SDK Python W\&B.

<h3 id="track-the-input-of-a-run">
  Suivre l’entrée d’un run
</h3>

Marquez un artifact comme entrée (ou dépendance) d’un run à l’aide de la méthode [`wandb.Run.use_artifact()`](/fr/products/wandb/ref/python/experiments/run#method-runuse_artifact).
Indiquez le nom de l’artifact et, éventuellement, un alias pour désigner une version précise de cet artifact. Le nom de
l’artifact se présente au format `<artifact_name>:<version>` ou `<artifact_name>:<alias>`.

Remplacez les valeurs entre chevrons (`< >`) par vos propres valeurs :

```python theme={"system"}
import wandb

# Initialiser un run
with wandb.init(entity="<entity>", project="<project>") as run:
  # Obtenir l’artifact et le marquer comme dépendance
  artifact = run.use_artifact(artifact_or_name="<name>", aliases="<alias>")
```

<h3 id="track-the-output-of-a-run">
  Suivre la sortie d’un run
</h3>

Utilisez [`wandb.Run.log_artifact()`](/fr/products/wandb/ref/python/experiments/run#log_artifact) pour déclarer un artifact comme sortie d’un run. Commencez par
créer un artifact avec le constructeur [`wandb.Artifact()`](/fr/products/wandb/ref/python/experiments/artifact#wandb.Artifact). Journalisez ensuite
l’artifact comme sortie du run avec `wandb.Run.log_artifact()`.

Remplacez les valeurs entre chevrons (`< >`) par vos propres valeurs :

```python theme={"system"}
import wandb

# Initialiser un run
with wandb.init(entity="<entity>", project="<project>") as run:
  
  # Créer un artifact
  artifact = wandb.Artifact(name = "<artifact_name>", type = "<artifact_type>")
  artifact.add_file(local_path = "<local_filepath>", name="<optional-name>")

  # Journaliser l’artifact en tant que sortie du run
  run.log_artifact(artifact_or_path = artifact)
```

<h2 id="artifact-clusters">
  Clusters d’artifacts
</h2>

Lorsqu’un niveau du graphe comporte au moins cinq runs ou artifacts, ceux-ci sont regroupés en cluster. Un cluster dispose d’une barre de recherche permettant de trouver des versions spécifiques de runs ou d’artifacts. Vous pouvez également en extraire un nœud individuel pour poursuivre l’analyse de sa traçabilité.

Cliquez sur un nœud pour ouvrir un aperçu de celui-ci. Cliquez sur la flèche pour extraire le run ou l’artifact concerné et examiner la traçabilité du nœud extrait.

<Frame>
  <img src="https://mintcdn.com/coreweave-dbfa0e8d/3Dv_sw2eg8feUJlx/products/wandb/_media/lineage3b.gif?s=b0e02791559ddc14bb345c930cc11e73" alt="Recherche dans un cluster de runs" width="3016" height="1600" data-path="products/wandb/_media/lineage3b.gif" />
</Frame>