> ## Documentation index
> Fetch the complete documentation index at: https://dify-docs.docs7.io/llms.txt
> Ask it with GET https://dify-docs.docs7.io/ask?q=<keywords or question>. Short keywords rank best.
> Use these 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 で Weights & Biases (W&B) アカウントを作成し、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 アプリケーションのパフォーマンスを最適化するのに役立ちます。

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

#### **Workflow/Chatflow トレース情報**

**Workflow と Chatflow を追跡するために使用**

| ワークフロー                           | 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 - Workflow アプリケーションログ 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 - Workflow アプリケーションログ 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