メインコンテンツへスキップ
このドキュメントは AI によって自動翻訳されています。不正確な部分がある場合は、英語版 を参照してください。
Dify v1.3.1 以上が必要です。

W&B Weave とは

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

Weave の設定方法

1. W&B Weaveに登録/ログイン

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

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

Dify アプリケーションで Weave を設定します。監視が必要なアプリケーションを開き、サイドメニューの モニタリング を開き、ページ上の アプリケーションパフォーマンスの追跡 を選択します。
Dify アプリケーションで Weave を設定します
設定をクリックした後、API Key と、既存の書き込み可能な プロジェクト 名を入力します。Entity は任意です。空欄の場合は API キーのデフォルトエンティティが使われ、チームの場合もあります。入力後、設定を保存します。
正常に保存されると、現在のページで監視状態を確認できます。

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

設定が完了すると、Dify 内のアプリケーションからのデバッグまたは本番データを Weave で監視できます。
Weave に切り替えると、ダッシュボードで Dify アプリケーションの詳細な操作ログを確認できます。
Weave を通じた詳細な LLM 操作ログは、Dify アプリケーションのパフォーマンスを最適化するのに役立ちます。
設定を保存してトレースを有効にしたら、アプリを再実行し、監視サービスに新しいトレースが表示されるか確認してください。トレースは非同期で送信されます。設定の保存だけでは、トレースの到着は確認できません。デプロイの両方のスイッチがオフでも、新しい Agent アプリや 新しい Agent ノード を使うワークフローは通常のトレースを送信します。利用可能な入力と出力も含まれますが、Agent 内部のモデル呼び出しとツール呼び出しは含まれません。これらの呼び出しを収集するには、Dify API とワーカーで OPS_AGENT_TRACE_ENABLED=true を、Agent バックエンドで DIFY_AGENT_APPLICATION_TRACING_ENABLED=true を設定します。両方を同時に有効にしてください。API 側のスイッチだけが有効で、Agent の内部処理を収集 がオン(デフォルト)の場合、Agent 呼び出しの実行時に収集がタイムアウトします。エラーは agent_trace_collection_incomplete となり、トレースはエクスポートされません。これはアプリの実行失敗を意味するものではありません。デプロイ設定の詳細は 環境変数 を参照してください。これらのアプリで API 側の収集を有効にすると、内容を収集 はデフォルトでオフになります。ワークフロー全体で入力、出力、メタデータの大半が除外され、エラーテキストはマスクされます。これらの内容を送信するには、内容を収集 を有効にしてください。クラシックの agent-chat アプリや、クラシック Agent ノードだけを使うワークフローでは、通常のトレースを引き続き使用します。

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

以下の表は通常のトレースを説明しています。新しい Agent アプリや新しい Agent ノードを含むワークフローで API 側の収集を有効にすると、新しい UUIDv7 がトレース ID になります。元の ID とトレース実行 ID は、属性 dify.source.id と dify.tracing.run_id に保持されます。新しい Agent アプリで Agent の内部処理を収集 をオンにすると、通常の llm スパンが Agent attempt スパンに置き換わります。このスパンには、内部のモデル呼び出しとツール呼び出しが含まれます。収集対象の実行では、モデレーション、推奨質問、名前生成の個別レコードは省略されます。 Dify は処理を階層構造としてエクスポートします。メッセージの下には llm 呼び出しがあり、Chatflow のメッセージの下にはワークフローとノードの処理があります。呼び出しの trace_id は、Dify のトレース識別子がゼロ以外の UUID または 32 桁の 16 進数の場合、その値を保持します。それ以外の値はハッシュ化されます。呼び出しの id は派生値です。X-Trace-Id が指定されていれば、メッセージ ID やワークフロー実行 ID より優先されます。トークン使用量のネイティブフィールドは、モデル呼び出しにのみ設定されます。 Chatflow では message がトレースのルートになります。入力はユーザーのクエリで、クエリが空ならワークフローの入力を使います。子の workflow には、ワークフローの入力と出力が保持されます。 以下の詳細リストは、Dify の元レコードとメタデータを説明しています。エクスポートされるのは、関連する利用可能な値のみです。元レコード全体をそのまま送信するわけではありません。

Workflow/Chatflow トレース情報

Workflow と Chatflow を追跡するために使用 ワークフロートレース情報
  • 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 関連の会話を追跡するために使用 メッセージトレース情報
  • message_id - メッセージ ID
  • message_data - メッセージデータ
  • end_user_session_id - ユーザーセッション ID
  • conversation_model - 会話モード
  • message_tokens - メッセージ内のトークン数
  • answer_tokens - 回答内のトークン数
  • total_tokens - メッセージと回答内のトークンの総数
  • error - エラー情報
  • inputs - 入力データ
  • outputs - 出力データ
  • file_list - 処理されたファイルのリスト
  • start_time - 開始時間
  • end_time - 終了時間
  • 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 - メッセージソース

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

会話モデレーションを追跡するために使用 モデレーショントレース情報
  • 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 - プリセット応答

提案質問トレース情報

提案された質問を追跡するために使用 メッセージトレース情報
  • 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 - メッセージソース

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

ナレッジベース検索を追跡するために使用 データセット検索トレース情報
  • 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 - メッセージソース

ツールトレース情報

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

ツールトレース情報

  • 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
名前生成トレース情報 会話タイトル生成を追跡するために使用 名前生成トレース情報
  • conversation_id - 会話 ID
  • inputs - 入力データ
  • outputs - 生成された会話名
  • start_time - 開始時間
  • end_time - 終了時間
  • tenant_id - テナント ID
  • メタデータ
    • conversation_id - 会話 ID
    • tenant_id - テナント ID
最終更新日 2026年11月17日