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

> artifact リネージ グラフを表示してたどり、W&B の run の入力と出力を有向非巡回グラフとしてトラッキングします。

# artifact リネージ グラフを確認する

W\&B は、*lineage graphs* と呼ばれる有向非巡回グラフ (DAG) を使って、run の入力と出力をトラッキングします。リネージ グラフは、ML 実験における artifact と run の関係を視覚的に表したものです。これにより、生データの取り込みからモデル トレーニング、評価に至るまで、ML のライフサイクルのさまざまな段階をデータやモデルがどのように
流れていくかを確認できます。

artifact リネージをトラッキングすると、次のような重要な利点があります。

* **再現性**: デバッグ、実験、検証のために、チームが実験、モデル、結果を再現できるようにします。
* **バージョン管理**: artifact の変更を時系列でトラッキングし、必要に応じてチームが以前のデータやモデル バージョンに戻せるようにします。
* **監査**: artifact とその変換の詳細な記録を維持し、コンプライアンスとガバナンスをサポートします。
* **コラボレーション**: 実験の履歴を可視化することでチームでの連携を改善し、重複作業を減らして開発を加速します。

<div id="view-an-artifacts-lineage-graph">
  ## artifact のリネージグラフを表示する
</div>

artifact のリネージグラフを表示するには、次の手順に従います。

1. W\&B App でプロジェクトの Workspace にアクセスします。
2. プロジェクトのサイドバーで **Artifacts** タブをクリックします。
3. artifact を選択し、**Lineage** タブをクリックします。

<div id="navigate-lineage-graphs">
  ## リネージグラフをたどる
</div>

リネージグラフは、ML 実験における Artifacts と Runs の関係を視覚的に表したものです。W\&B App UI または Python SDK を使用して、artifact のリネージグラフを探索し、たどることができます。

<Tabs>
  <Tab title="W&B App UI">
    緑色のアイコンが付いたノードは Runs を表します。青色のアイコンが付いたノードは Artifacts を表します。ノード間の矢印は、run または artifact の入力と出力を示します。

    artifact ノードには、`<artifact_name>:<version>` の形式で、artifact 名とそのバージョンが表示されます。artifact のタイプは、artifact 名の上に表示されます。

    <Note>
      artifact のタイプと名は、左サイドバーとリネージグラフのノードの両方で確認できます。
    </Note>

    run ノードには、run の名が表示されます。

    <Frame>
      <img src="https://mintcdn.com/wb-21fd5541/BBwBcYvkTbUeuw66/images/artifacts/lineage2.png?fit=max&auto=format&n=BBwBcYvkTbUeuw66&q=85&s=9f8832660b6f312bcf603b1a197af218" alt="run ノードと artifact ノード" width="4774" height="1932" data-path="images/artifacts/lineage2.png" />
    </Frame>

    個々の run をクリックすると、その run に関する詳細情報 (開始時刻、実行時間、作成者、ジョブタイプなど) が表示されます。個々の artifact をクリックすると、その artifact に関する詳細情報 (aliases、creation time、type、version、description、その artifact をログした run、ファイルサイズなど) が表示されます。

    <Frame>
      <img src="https://mintcdn.com/wb-21fd5541/BBwBcYvkTbUeuw66/images/artifacts/lineage3a.gif?s=deae160c2db0d1f04a654e0160fea3df" alt="run のプレビュー" width="4754" height="1930" data-path="images/artifacts/lineage3a.gif" />
    </Frame>

    同じ artifact の複数のバージョンを作成する Runs は、クラスターにまとめられます。クラスター 内に一覧表示された特定の artifact バージョンをクリックすると、その artifact バージョン固有の情報を確認できます。

    <Frame>
      <img src="https://mintcdn.com/wb-21fd5541/BBwBcYvkTbUeuw66/images/artifacts/lineage_multiple_artifact_versions.png?fit=max&auto=format&n=BBwBcYvkTbUeuw66&q=85&s=d05dca814e1f1b1369f67d101819675c" alt="リネージグラフ内の artifact バージョンの クラスター" width="4756" height="2044" data-path="images/artifacts/lineage_multiple_artifact_versions.png" />
    </Frame>

    ノードをクリックしてドラッグすると、グラフを並べ替えて Layout をカスタマイズできます。グラフを拡大または縮小して、ノードとその関係を見やすくすることもできます。

    <Frame>
      <img src="https://mintcdn.com/wb-21fd5541/BBwBcYvkTbUeuw66/images/artifacts/lineage_rearrange_nodes.gif?s=df94de486f99b0d35f2a40ef2eaab747" alt="リネージグラフ内のノードの並べ替え" width="4754" height="2466" data-path="images/artifacts/lineage_rearrange_nodes.gif" />
    </Frame>

    ノードにマウスカーソルを合わせて目のアイコンをクリックすると、グラフ内でノードの表示と非表示を切り替えられます。これは、グラフを整理して特定のノードとその関係に集中するのに役立ちます。
  </Tab>

  <Tab title="W&B Python SDK">
    W\&B Python SDK を使用して、プログラムからグラフをたどることもできます。artifact object の
    [`logged_by()`](/ja/models/ref/python/experiments/artifact#method-artifact-logged-by) と [`used_by()`](/ja/models/ref/python/experiments/artifact#method-artifact-used-by) method を使用して、グラフをたどります。

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

        # artifact からグラフを上下にたどる:
        producer_run = artifact.logged_by()
        consumer_runs = artifact.used_by()
    ```
  </Tab>
</Tabs>

<div id="enable-lineage-graph-tracking">
  ## リネージグラフのトラッキングを有効にする
</div>

リネージグラフのトラッキングを有効にするには、W\&B Python SDK を使用して、artifact を run の [入力](/ja/models/artifacts/explore-and-traverse-an-artifact-graph) または
[出力](/ja/models/artifacts/explore-and-traverse-an-artifact-graph#track-the-output-of-a-run) としてマークする必要があります。

<div id="track-the-input-of-a-run">
  ### run への入力をトラッキングする
</div>

[`wandb.Run.use_artifact()`](/ja/models/ref/python/experiments/run#method-runuse_artifact)
method を使用して、artifact を run への入力 (または依存関係) としてマークします。artifact の名と、その artifact の特定バージョンを参照するための任意の alias を指定します。artifact の
名は `<artifact_name>:<version>` または `<artifact_name>:<alias>` の形式です。

山かっこ (`< >`) で囲まれた値は、実際の値に置き換えてください。

```python theme={null}
import wandb

# runを初期化する
with wandb.init(entity="<entity>", project="<project>") as run:
  # artifactを取得し、依存関係としてマークする
  artifact = run.use_artifact(artifact_or_name="<name>", aliases="<alias>")
```

<div id="track-the-output-of-a-run">
  ### run の出力をトラッキングする
</div>

[`wandb.Run.log_artifact()`](/ja/models/ref/python/experiments/run#log_artifact) を使用して、artifact を run の出力として宣言します。まず、
[`wandb.Artifact()`](/ja/models/ref/python/experiments/artifact#wandb.Artifact) コンストラクタを使用して artifact を作成します。次に、`wandb.Run.log_artifact()` を使用して、
artifact を run の出力としてログします。

山括弧 (`< >`) で囲まれた値は、実際の値に置き換えてください。

```python theme={null}
import wandb

# runを初期化する
with wandb.init(entity="<entity>", project="<project>") as run:
  
  # artifactを作成する
  artifact = wandb.Artifact(name = "<artifact_name>", type = "<artifact_type>")
  artifact.add_file(local_path = "<local_filepath>", name="<optional-name>")

  # artifactをrunの出力としてログする
  run.log_artifact(artifact_or_path = artifact)
```

<div id="artifact-clusters">
  ## Artifact クラスター
</div>

グラフ内のあるレベルに 5 つ以上の run または artifact がある場合、クラスターが作成されます。クラスターには、特定のバージョンの run や artifact を検索するための検索バーがあり、クラスター内のノードをさらに調べるために、個々のノードをクラスターから取り出すことができます。

ノードをクリックすると、そのノードの概要を表示するプレビューが開きます。矢印をクリックすると、個々の run または artifact が取り出され、取り出したノードのリネージを確認できます。

<Frame>
  <img src="https://mintcdn.com/wb-21fd5541/wKCrMJZKG3PxyJhv/images/artifacts/lineage3b.gif?s=1b28679880c12dc5ae2c0f044b08f8bb" alt="run クラスター内を検索する" width="3016" height="1600" data-path="images/artifacts/lineage3b.gif" />
</Frame>