> ## 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.

# Weave Trace viewを操作する

> WeaveのTrace viewを使用して、LLMやエージェント型アプリの複雑な実行パスを把握します。

Weave Trace viewは、LLMやエージェント型アプリにおける複雑な実行パスを理解しやすくするのに役立ちます。多数のネストされたcallを含むエージェント型アプリをデバッグする場合でも、単一のモデル予測の流れをトラッキングする場合でも、Trace viewは何が起きたのかを明確に可視化します。また、アプリケーションフローをさまざまな方法で表示し、理解することもできます。

このガイドは、Weaveを使用してLLMまたはエージェント型アプリケーションを計装し、生成されたトレースを調べたい開発者向けです。トレーススタック内を移動する方法、コードから呼び出された関数をフィルターや検索で絞り込む方法、表示形式を切り替える方法などについて説明します.

以下のセクションでは、Trace viewを開く方法、トレース ページ内での見方、トレース内を移動してフィルターする方法、別の可視化表現に切り替える方法、特定のopの詳細を調べる方法について説明します。

<div id="get-started">
  ## はじめに
</div>

プロジェクトの Trace view を開いてトレースの確認を開始するには、次の手順に従います。

1. [https://wandb.ai](https://wandb.ai) にアクセスし、プロジェクトを選択します。
2. プロジェクトのサイドバーで **Traces** を選択すると、プロジェクトに保存されているすべてのトレースが表示されます。
3. トレースを選択して Trace Details view を開きます。Trace Details view には、トレース実行の階層的な内訳を示す追加のパネルが表示されます。

<div id="traces-page-overview">
  ## トレース ページの概要
</div>

トレース ページは、3 つの主要なパネルで構成されています。

* **左パネル**: プロジェクト内のすべてのトレースを表示する、並べ替え可能でページ分割されたリストです。
  * このトレースの表には、トークン 数、コスト、レイテンシなどの追加データも含まれます。
* **中央パネル**: 選択したトレースのインタラクティブなTrace view。トレース ツリーには、そのトレース内でトラッキングされたすべての method の階層が表示されます。
  * トレース ツリーには、トレース中に呼び出された `@weave.op()` でデコレートされた function である [ops](/ja/weave/guides/tracking/ops#automatically-track-function-calls-using-ops) が表示されます。
* **右パネル**: 選択したトレース内で選択した op の詳細です。

<Frame>
  <img src="https://mintcdn.com/wb-21fd5541/M79FAxH2Aq0Q8-x2/weave/guides/tracking/imgs/trace-tree-full.png?fit=max&auto=format&n=M79FAxH2Aq0Q8-x2&q=85&s=054e9d8cb21d9f9e86337cf002483ea7" alt="選択したトレースと選択した op の詳細が表示されたトレース ページ" width="2062" height="590" data-path="weave/guides/tracking/imgs/trace-tree-full.png" />
</Frame>

<div id="filter-within-a-trace">
  ### トレース内でのフィルタリング
</div>

次のコントロールを使用して、トレースの内容をフィルタリングできます。

* **名前で正規表現フィルター**: トレース ツリーの上部にあるテキスト フィールドを使用して、`tool`、`openai.response.create` などの名前またはタイプで op をフィルタリングします。
* **メトリクス**: 利用可能な場合は、コスト、トークン、レイテンシなどのデータ メトリクスを表示するかどうかを制御します。

<div id="navigate-a-trace">
  ### トレースを移動する
</div>

トレース ツリーには、トレース内でトラッキングされたすべてのmethodの階層が表示されます。ツリー内を上下に移動するには、`Cmd` (macOS) または `Alt` (Windows/Linux) + 上矢印 (↑) または下矢印 (↓) を使用します。

トレース ツリーの下には、ツリー内の各状態をすばやく移動するためのスクラバーがいくつかあります。これらのスライダーを使って、トレース内を移動できます。

パネルを展開すると、利用可能なすべてのスクラバーを表示できます。

* **Timeline**: トレース内のイベントを時系列順に表示します。
* **Peers**: 同じタイプの op。たとえば、`predict` という関数の詳細を確認している場合、このスクラバーを使うと、トレース内の次の `predict` の実行にすぐ移動できます。
* **Siblings**: 同じ親を持つ op。このスクラバーを使うと、親関数 call の下にネストされた op を順にたどれます。
* **Stack**: コールスタックを上下にたどります。
* **Path**: (コード構成ビューでのみ利用可能) 選択した call と同じコードパスを持つすべての call を順にたどります。

<Frame>
  <img src="https://mintcdn.com/wb-21fd5541/M79FAxH2Aq0Q8-x2/weave/guides/tracking/imgs/trace-tree-scrubbers.png?fit=max&auto=format&n=M79FAxH2Aq0Q8-x2&q=85&s=0fb6a2843b18d120ec3ea8087c163126" alt="検索フィルターとスクラバーを表示したトレース ツリー パネル" width="422" height="541" data-path="weave/guides/tracking/imgs/trace-tree-scrubbers.png" />
</Frame>

<div id="alternative-trace-tree-views">
  ### トレース ツリーの別のビュー
</div>

パネル上部では、デバッグの目的に応じてトレース ツリーを複数の表示形式で切り替えられます。call のロジックを把握するには**コード構成ビュー**、時間経過に伴うパフォーマンスを確認するには**フレームグラフビュー**、構造を把握するには**グラフ ビュー**を使用します。

以下のセクションでは、利用可能な各ビューについて説明します。

<div id="traces-default">
  #### トレース (デフォルト)
</div>

トレース ツリーのデフォルトのビューでは、スタック階層、op ごとのコスト (利用できる場合) 、実行時間、ステータスインジケーターが表示されます。

<div id="code-composition-view">
  #### コード構成ビュー
</div>

コード構成ビューでは、各ボックスが op とそのネストされた call を表します。これは、function call の流れを可視化するのに役立ちます。このビューでは、ボックスを選択してその op の詳細を掘り下げたり、call パスをフィルターしたりできます。

<Frame>
  <img src="https://mintcdn.com/wb-21fd5541/M79FAxH2Aq0Q8-x2/weave/guides/tracking/imgs/trace-tree-code-view.png?fit=max&auto=format&n=M79FAxH2Aq0Q8-x2&q=85&s=997c9e06ae7a1307edc6dfbb02fb5af1" alt="トレースのコードビューを示す Trace view" width="538" height="640" data-path="weave/guides/tracking/imgs/trace-tree-code-view.png" />
</Frame>

<div id="flame-graph">
  #### フレームグラフ
</div>

フレームグラフビューでは、実行の深さと継続時間をタイムラインベースで可視化できます。これは、時間の経過に伴うパフォーマンス診断を理解したい場合に役立ちます。フレームを選択して、サブトレースに絞り込むことができます。

<Frame>
  <img src="https://mintcdn.com/wb-21fd5541/M79FAxH2Aq0Q8-x2/weave/guides/tracking/imgs/trace-tree-flame-view.png?fit=max&auto=format&n=M79FAxH2Aq0Q8-x2&q=85&s=aff5f74a187351f58c81935df329d17c" alt="トレース内の ops のフレームグラフを表示する Trace view" width="731" height="214" data-path="weave/guides/tracking/imgs/trace-tree-flame-view.png" />
</Frame>

<div id="graph-view">
  #### グラフ ビュー
</div>

グラフ ビューには、op 間の階層的な関係が表示されます。親子関係を把握するのに役立ちます。

<Frame>
  <img src="https://mintcdn.com/wb-21fd5541/M79FAxH2Aq0Q8-x2/weave/guides/tracking/imgs/trace-tree-graph-view.png?fit=max&auto=format&n=M79FAxH2Aq0Q8-x2&q=85&s=c690665493ec4cccf90e1d3c1bd77183" alt="トレース 内の op と関係を機能的なグラフ ビューで示した Trace view" width="734" height="598" data-path="weave/guides/tracking/imgs/trace-tree-graph-view.png" />
</Frame>

<div id="view-details-for-a-trace-op">
  ### トレース op の詳細を表示
</div>

トレース ツリーで op を選択すると、その op の詳細が右隣のパネルに表示されます。詳細は次のタブに分かれています。

* **Call**: op の実行時の入力と出力。
* **Code**: call が行われた際に使用されたコード。
* **Feedback**: op に対して利用可能な [feedback](/ja/weave/guides/tracking/feedback)。Weave 内または API 経由で直接 feedback を提供できます。
* **Scores**: op に対して利用可能な [scores](/ja/weave/guides/evaluation/scorers)。calls は評価を実行してスコア付けされます。
* **Summary**: op に関する一般的な情報。
* **Use**: call をプログラムで取得し、reactions、メモ、feedback を追加するために使用できるコード スニペット。