モデル トレーニング run 中にトレースをログする
モデル トレーニング run 中に Weave トレースをログし、個人用 Workspace で表示できます。
Weave パネルを使用する
ML パイプライン内の関数を@weave.op でデコレートすると、それらの実行情報が自動的に取得され、個人用 Workspace で確認できるようになります。
たとえば、次のスクリプトは、Weave トレースを Weights & Biases のトレーニング run と統合する方法を示しています。このスクリプトは機械学習のトレーニングループをシミュレートしており、各トレーニングステップで Weights & Biases にメトリクスをログすると同時に、詳細な Weave トレースを作成します。関数に付けた @weave.op デコレーターにより、入力、出力、実行の詳細が自動的に取得されます。トレーニングループが wandb.log() でメトリクスをログすると、Weave のトレース情報も project にログされます。
wandb: 🚀 View run at https://forge.coreweave.com/wandb/wandb/my-project/runs/[RUN-ID] のような形式) を開くか、UI で Workspace にアクセスします。
UI から Workspace にアクセスするには、次の手順を実行します。
- Weights & Biases の UI を開き、Projects タブをクリックします。project の一覧が表示されます。
- project の一覧から、run をログした project をクリックします。Workspaces ページが開きます。
- Workspace を自動 Workspace として設定している場合は、run に関するデータ可視化と情報が Workspace に自動的に表示されます。run のトレースデータは、Workspace の Weave セクションにあります。手動 Workspace の場合は、Add panels をクリックし、Add Panels メニューの Weave セクションからパネルを選択すると、Weave パネルを追加できます。
Traces の表でリンクされた run を表示する
ML パイプラインのwandb.init() コンテキスト内で @weave.op でデコレートされた関数を呼び出すと、Weave はそのトレースを実行中の Weights & Biases run に自動的に関連付けます。Weave UI の Traces の表では、各トレースに関連付けられた run へのリンクが表示されます。
トレースにリンクされた run を表示するには、次の手順に従います。
wandb.init()コンテキスト内でトレース対象の関数を呼び出すスクリプトを実行します (例: Weave パネルを使用する のトレーニング例) 。- Weights & Biases UI を開き、対象の project を選択します。
- Weave のプロジェクトのサイドバーで Traces をクリックします。Traces の表に、関連付けられた run へのリンクが表示されます。
- Traces の表からトレースを開き、リンクされた run とその実験のコンテキストを確認します。
Weave TypeScript SDK では、トレースを Weights & Biases の run にリンクすることはできません。
トレースを特定の W&B run に関連付ける
場合によっては、Weave が自動的に検出する run 以外の run にトレースを関連付けたいことがあります。デフォルトでは、Weave は実行中のwandb.run を自動的に検出し、トレースを関連付けます。グローバルな wandb.run ではない特定の run にトレースを関連付ける必要がある場合は、set_wandb_run_context を使用します。トレースを特定の run と run のステップに関連付けるには、このメソッドの run_id 引数と step 引数に値を定義します。
run_id は run の短い ID (例: 38m4t5ja) であり、完全な entity/project/run_id パスではありません。run の短い ID は、run の URL (https://forge.coreweave.com/wandb/team/project/runs/[RUN-ID]) で検索するか、コード内で wandb.run.id にアクセスすることで確認できます。
上書きを停止してグローバルな wandb.run に戻すには、clear_wandb_run_context を呼び出します。
Weave トレースで W&B アーティファクトを参照する
Weave トレースで W&B アーティファクト (モデル、データセット、チェックポイントなど) を参照できます。これにより、Weights & Biases UI にアーティファクトの詳細ページに直接移動するクリック可能なリンクが作成され、特定の操作で使用したアーティファクトのバージョンをトラッキングできます。 たとえば、モデルの 2 つのバージョン (v1 と v2) をトレーニングした場合、そのモデルをクエリするときに、v1 アーティファクトへの参照をトレースの属性として追加できます。これにより、特定の出力を生成したアーティファクトのバージョンを正確に追跡できます。
アーティファクトをトレースに関連付けるには、次の構文を使用して、wandb-artifact:/// 接頭辞とアーティファクトの完全名を連結し、アーティファクトの URL を作成します:wandb-artifact:///[FULL-NAME-OF-ARTIFACT]。その後、次のいずれかの方法で Weave に渡します:
- 任意の属性として
Modelの属性として
[ENTITY]/[PROJECT]/[ARTIFACT-NAME]:[VERSION] です。Weights & Biases UI のアーティファクトの詳細ページから完全名をコピーできます。
以下のセクションで、それぞれの方法を説明します。
アーティファクトをトレースの属性として追加する
アーティファクトをトレースの属性として追加するには、weave.attributes() コンテキストマネージャーにキーと値のペアで渡します。
- Python
- TypeScript
アーティファクトを Model の属性として追加する
アーティファクトを Model の属性として追加するには、モデルのインスタンスを作成するときにアーティファクトの URL を渡します:
Model クラスは Weave Python SDK でのみサポートされます。