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

# W&B Weave の統合

> Dify アプリケーションからトレースを W&B Weave に送信し、LLM のオブザーバビリティを実現します

> このドキュメントは AI によって自動翻訳されています。不正確な部分がある場合は、[英語版](/en/cloud/use-dify/monitor/integrations/integrate-weave) を参照してください。

### W\&B Weave とは

Weights & Biases (W\&B) Weave は、LLM ベースのアプリケーションの追跡、実験、評価、デプロイ、改善のためのフレームワークです。柔軟性とスケーラビリティを考慮して設計された Weave は、LLM アプリケーション開発ワークフローのあらゆる段階をサポートします。

<Info>
  詳細については、[Weave](https://docs.wandb.ai/weave) を参照してください。
</Info>

### Weave の設定方法

#### 1. [W\&B Weave](https://wandb.ai/signup)に登録/ログイン

API キーを取得する

次に、[https://wandb.ai](https://wandb.ai) で Weights & Biases (W\&B) アカウントを作成し、[https://wandb.ai/authorize](https://wandb.ai/authorize) から API キーをコピーします

#### 2. W\&B Weave を Dify と統合する

Dify アプリケーションで Weave を設定します。監視が必要なアプリケーションを開き、サイドメニューの **モニタリング** を開き、ページ上の **アプリケーションパフォーマンスの追跡** を選択します。

<Frame>
  ![Dify アプリケーションで Weave を設定します](https://assets-docs.dify.ai/2025/04/c33e8fda75ee9052ed23c8690e314862.png)
</Frame>

設定をクリックした後、**API キー** と**プロジェクト名** を貼り付け、**W\&B エンティティ**（オプション、デフォルトはユーザー名）も指定して設定を保存します。

<Frame>
  ![](https://assets-docs.dify.ai/2025/04/60bce1ae7b883825b13526d172ae0073.png)
</Frame>

正常に保存されると、現在のページで監視状態を確認できます。

<Frame>
  ![](https://assets-docs.dify.ai/2025/04/9486cee7bbb61f069842c9ea860e679c.png)
</Frame>

### Weave でモニタリングデータを表示する

設定が完了すると、Dify 内のアプリケーションからのデバッグまたは本番データを Weave で監視できます。

<Frame>
  ![](https://assets-docs.dify.ai/2025/04/a1c5aa80325e6d0223d48a178393baec.png)
</Frame>

Weave に切り替えると、ダッシュボードで Dify アプリケーションの詳細な操作ログを確認できます。

<Frame>
  ![](https://assets-docs.dify.ai/2025/04/2cb04027c00b606029fcc26af2801bfe.png)
</Frame>

Weave を通じた詳細な LLM 操作ログは、Dify アプリケーションのパフォーマンスを最適化するのに役立ちます。

### モニタリングデータリスト

#### **ワークフロー/チャットフロートレース情報**

**ワークフローとチャットフローを追跡するために使用**

| ワークフロー                                   | Weave トレース               |
| ---------------------------------------- | ------------------------ |
| workflow\_app\_log\_id/workflow\_run\_id | id                       |
| user\_session\_id                        | メタデータに配置                 |
| workflow\_\{id}                          | name                     |
| start\_time                              | start\_time              |
| end\_time                                | end\_time                |
| inputs                                   | inputs                   |
| outputs                                  | outputs                  |
| モデルトークン消費量                               | usage\_metadata          |
| metadata                                 | extra                    |
| error                                    | error                    |
| workflow                                 | tags                     |
| "conversation\_id/none for workflow"     | メタデータ内の conversation\_id |
| conversion\_id                           | parent\_run\_id          |

**ワークフロートレース情報**

* workflow\_id - ワークフローの一意の識別子
* conversation\_id - 会話 ID
* workflow\_run\_id - 現在の実行の ID
* tenant\_id - テナント ID
* elapsed\_time - 現在の実行にかかった時間
* status - 実行ステータス
* version - ワークフローバージョン
* total\_tokens - 現在の実行で使用されたトークンの総数
* file\_list - 処理されたファイルのリスト
* triggered\_from - 現在の実行をトリガーしたソース
* workflow\_run\_inputs - 現在の実行の入力データ
* workflow\_run\_outputs - 現在の実行の出力データ
* error - 現在の実行中に発生したエラー
* query - 実行中に使用されたクエリ
* workflow\_app\_log\_id - ワークフローアプリケーションログ ID
* message\_id - 関連するメッセージ ID
* start\_time - 実行の開始時間
* end\_time - 実行の終了時間
* workflow node executions - ワークフローノード実行に関する情報
* メタデータ
  * workflow\_id - ワークフローの一意の識別子
  * conversation\_id - 会話 ID
  * workflow\_run\_id - 現在の実行の ID
  * tenant\_id - テナント ID
  * elapsed\_time - 現在の実行にかかった時間
  * status - 実行ステータス
  * version - ワークフローバージョン
  * total\_tokens - 現在の実行で使用されたトークンの総数
  * file\_list - 処理されたファイルのリスト
  * triggered\_from - 現在の実行をトリガーしたソース

#### **メッセージトレース情報**

**LLM 関連の会話を追跡するために使用**

| チャット                          | Weave トレース               |
| ----------------------------- | ------------------------ |
| message\_id                   | id                       |
| user\_session\_id             | メタデータに配置                 |
| "message\_\{id}"              | name                     |
| start\_time                   | start\_time              |
| end\_time                     | end\_time                |
| inputs                        | inputs                   |
| outputs                       | outputs                  |
| モデルトークン消費量                    | usage\_metadata          |
| metadata                      | extra                    |
| error                         | error                    |
| "message", conversation\_mode | tags                     |
| conversation\_id              | メタデータ内の conversation\_id |
| conversion\_id                | parent\_run\_id          |

**メッセージトレース情報**

* message\_id - メッセージ ID
* message\_data - メッセージデータ
* user\_session\_id - ユーザーセッション ID
* conversation\_model - 会話モード
* message\_tokens - メッセージ内のトークン数
* answer\_tokens - 回答内のトークン数
* total\_tokens - メッセージと回答内のトークンの総数
* error - エラー情報
* inputs - 入力データ
* outputs - 出力データ
* file\_list - 処理されたファイルのリスト
* start\_time - 開始時間
* end\_time - 終了時間
* message\_file\_data - メッセージに関連するファイルデータ
* conversation\_mode - 会話モード
* メタデータ
  * conversation\_id - 会話 ID
  * ls\_provider - モデルプロバイダー
  * ls\_model\_name - モデル ID
  * status - メッセージステータス
  * from\_end\_user\_id - 送信ユーザーの ID
  * from\_account\_id - 送信アカウントの ID
  * agent\_based - メッセージがエージェントベースかどうか
  * workflow\_run\_id - ワークフロー実行 ID
  * from\_source - メッセージソース

#### **モデレーショントレース情報**

**会話モデレーションを追跡するために使用**

| モデレーション       | Weave トレース      |
| ------------- | --------------- |
| user\_id      | メタデータに配置        |
| "moderation"  | name            |
| start\_time   | start\_time     |
| end\_time     | end\_time       |
| inputs        | inputs          |
| outputs       | outputs         |
| metadata      | extra           |
| \[moderation] | tags            |
| message\_id   | parent\_run\_id |

**モデレーショントレース情報**

* message\_id - メッセージ ID
* user\_id: ユーザーID
* workflow\_app\_log\_id - ワークフローアプリケーションログ ID
* inputs - モデレーション入力データ
* message\_data - メッセージデータ
* flagged - コンテンツが注意対象としてフラグ付けされているかどうか
* action - 取られた特定のアクション
* preset\_response - プリセット応答
* start\_time - モデレーション開始時間
* end\_time - モデレーション終了時間
* メタデータ
  * message\_id - メッセージ ID
  * action - 取られた特定のアクション
  * preset\_response - プリセット応答

#### **提案質問トレース情報**

**提案された質問を追跡するために使用**

| 提案質問                | Weave トレース      |
| ------------------- | --------------- |
| user\_id            | メタデータに配置        |
| suggested\_question | name            |
| start\_time         | start\_time     |
| end\_time           | end\_time       |
| inputs              | inputs          |
| outputs             | outputs         |
| metadata            | extra           |
| suggested\_question | tags            |
| message\_id         | parent\_run\_id |

**メッセージトレース情報**

* message\_id - メッセージ ID
* message\_data - メッセージデータ
* inputs - 入力内容
* outputs - 出力内容
* start\_time - 開始時間
* end\_time - 終了時間
* total\_tokens - トークン数
* status - メッセージステータス
* error - エラー情報
* from\_account\_id - 送信アカウントの ID
* agent\_based - メッセージがエージェントベースかどうか
* from\_source - メッセージソース
* model\_provider - モデルプロバイダー
* model\_id - モデル ID
* suggested\_question - 提案された質問
* level - ステータスレベル
* status\_message - ステータスメッセージ
* メタデータ
  * message\_id - メッセージ ID
  * ls\_provider - モデルプロバイダー
  * ls\_model\_name - モデル ID
  * status - メッセージステータス
  * from\_end\_user\_id - 送信ユーザーの ID
  * from\_account\_id - 送信アカウントの ID
  * workflow\_run\_id - ワークフロー実行 ID
  * from\_source - メッセージソース

#### **データセット検索トレース情報**

**ナレッジベース検索を追跡するために使用**

| データセット検索           | Weave トレース      |
| ------------------ | --------------- |
| user\_id           | メタデータに配置        |
| dataset\_retrieval | name            |
| start\_time        | start\_time     |
| end\_time          | end\_time       |
| inputs             | inputs          |
| outputs            | outputs         |
| metadata           | extra           |
| dataset\_retrieval | tags            |
| message\_id        | parent\_run\_id |

**データセット検索トレース情報**

* message\_id - メッセージ ID
* inputs - 入力内容
* documents - ドキュメントデータ
* start\_time - 開始時間
* end\_time - 終了時間
* message\_data - メッセージデータ
* メタデータ
  * message\_id - メッセージ ID
  * ls\_provider - モデルプロバイダー
  * ls\_model\_name - モデル ID
  * status - メッセージステータス
  * from\_end\_user\_id - 送信ユーザーの ID
  * from\_account\_id - 送信アカウントの ID
  * agent\_based - メッセージがエージェントベースかどうか
  * workflow\_run\_id - ワークフロー実行 ID
  * from\_source - メッセージソース

#### **ツールトレース情報**

**ツール呼び出しを追跡するために使用**

| ツール                   | Weave トレース      |
| --------------------- | --------------- |
| user\_id              | メタデータに配置        |
| tool\_name            | name            |
| start\_time           | start\_time     |
| end\_time             | end\_time       |
| inputs                | inputs          |
| outputs               | outputs         |
| metadata              | extra           |
| \["tool", tool\_name] | tags            |
| message\_id           | parent\_run\_id |

#### **ツールトレース情報**

* message\_id - メッセージ ID
* tool\_name - ツール名
* start\_time - 開始時間
* end\_time - 終了時間
* tool\_inputs - ツール入力
* tool\_outputs - ツール出力
* message\_data - メッセージデータ
* error - エラー情報（もしあれば）
* inputs - メッセージの入力
* outputs - メッセージの出力
* tool\_config - ツール設定
* time\_cost - 時間コスト
* tool\_parameters - ツールパラメータ
* file\_url - 関連ファイルの URL
* メタデータ
  * message\_id - メッセージ ID
  * tool\_name - ツール名
  * tool\_inputs - ツール入力
  * tool\_outputs - ツール出力
  * tool\_config - ツール設定
  * time\_cost - 時間コスト
  * error - エラー情報（もしあれば）
  * tool\_parameters - ツールパラメータ
  * message\_file\_id - メッセージファイル ID
  * created\_by\_role - 作成者のロール
  * created\_user\_id - 作成者のユーザーID

**名前生成トレース情報**

**会話タイトル生成を追跡するために使用**

| 名前生成           | Weave トレース  |
| -------------- | ----------- |
| user\_id       | メタデータに配置    |
| generate\_name | name        |
| start\_time    | start\_time |
| end\_time      | end\_time   |
| inputs         | inputs      |
| outputs        | outputs     |
| metadata       | extra       |
| generate\_name | tags        |

**名前生成トレース情報**

* conversation\_id - 会話 ID
* inputs - 入力データ
* outputs - 生成された会話名
* start\_time - 開始時間
* end\_time - 終了時間
* tenant\_id - テナント ID
* メタデータ
  * conversation\_id - 会話 ID
  * tenant\_id - テナント ID
