このドキュメントは 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 を設定します。監視が必要なアプリケーションを開き、サイドメニューの モニタリング を開き、ページ上の アプリケーションパフォーマンスの追跡 を選択します。


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

設定を保存してトレースを有効にしたら、アプリを再実行し、監視サービスに新しいトレースが表示されるか確認してください。トレースは非同期で送信されます。設定の保存だけでは、トレースの到着は確認できません。デプロイの両方のスイッチがオフでも、新しい 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