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

# LangFuseとの統合

### Langfuseとは

LangfuseはLLMアプリケーションの開発者がデバッグ、分析、イテレーション等を使用してアプリケーションのパフォーマンスを向上させるためのツールです。

<Tip>
  Langfuseの公式サイト：[https://langfuse.com/](https://langfuse.com/)
</Tip>

***

### Langfuseの設定方法

1. まず、[公式サイト](https://langfuse.com/) に登録し、Langfuseにログインします。
2. ログイン後、Langfuseでプロジェクトを作成します。ホームページで **New** をクリックして、自分のプロジェクトを作成します。この **プロジェクト** はDify内の **アプリケーション** とデータ監視に関連付けられます。

<Frame caption="Langfuse 内でプロジェクトを作成する">
  <img src="https://mintcdn.com/dify-4171f9f9/hIywJrDH61w15c5F/images/image-249.png?fit=max&auto=format&n=hIywJrDH61w15c5F&q=85&s=c6708bb18028316e9d545e186a074cb4" alt="Langfuse 内でプロジェクトを作成する" width="3020" height="1646" data-path="images/image-249.png" />
</Frame>

プロジェクトの名前を付けます。

<Frame caption="Langfuse 内でプロジェクトを作成する">
  <img src="https://mintcdn.com/dify-4171f9f9/hIywJrDH61w15c5F/images/image-251.png?fit=max&auto=format&n=hIywJrDH61w15c5F&q=85&s=267a978527a5d38abe863819c750d828" alt="Langfuse 内でプロジェクトを作成する" width="2910" height="1538" data-path="images/image-251.png" />
</Frame>

3. プロジェクト認証情報の作成のために、左のサイドバーでプロジェクト **設定** をクリックする。

<Frame caption="Langfuse 内でプロジェクトを作成する">
  <img src="https://mintcdn.com/dify-4171f9f9/hIywJrDH61w15c5F/images/image-253.png?fit=max&auto=format&n=hIywJrDH61w15c5F&q=85&s=621b2f75d1672d69ec9ef3d8c7033868" alt="Langfuse 内でプロジェクトを作成する" width="732" height="930" data-path="images/image-253.png" />
</Frame>

**Create API Key**をクリックし，新たな認証情報を作ります。

<Frame caption="Langfuse 内でプロジェクトを作成する">
  <img src="https://mintcdn.com/dify-4171f9f9/hIywJrDH61w15c5F/images/image-252.png?fit=max&auto=format&n=hIywJrDH61w15c5F&q=85&s=0264296c51a2d4a379f664bb6ebca563" alt="Langfuse 内でプロジェクトを作成する" width="772" height="1450" data-path="images/image-252.png" />
</Frame>

**Secret Key** と **Public Key，Host** をコピーし、保存します。

<Frame caption="Langfuse API Key 配置">
  <img src="https://mintcdn.com/dify-4171f9f9/hIywJrDH61w15c5F/images/image-254.png?fit=max&auto=format&n=hIywJrDH61w15c5F&q=85&s=ebc62994951c53801f15e234d7cc9658" alt="Langfuse API Key 配置" width="704" height="1258" data-path="images/image-254.png" />
</Frame>

4. Dify アプリの中に Langfuse を設定するために、監視用のアプリのサイトメニューの**監視**ボタンをクリックし，**設定**をクリックします。

<Frame caption="Langfuseを設定します">
  <img src="https://mintlify.s3.us-west-1.amazonaws.com/dify-4171f9f9/ja-jp/img/tracing-app-performance-langfuse.png" alt="Dify 監視設定" />
</Frame>

そして、Langfuse から作った **Secret Key, Public Key** と **Host** を**設定**の中に貼り付け、保存します。

<Frame caption="Langfuseを設定します">
  <img src="https://mintlify.s3.us-west-1.amazonaws.com/dify-4171f9f9/ja-jp/img/config-langfuse.png" alt="Dify Langfuse 設定画面" />
</Frame>

保存に成功すると、現在のページで監視状態を見ることができます。

<Frame caption="監視状態を見る">
  <img src="https://mintlify.s3.us-west-1.amazonaws.com/dify-4171f9f9/ja-jp/img/monitored-by-langfuse.png" alt="Dify Langfuse 設定状況画面" />
</Frame>

***

### Langfuse ページで監視データをチェックします

設定後， DifyのアプリやLLMの応答データは Langfuse で確認できるようになります。

<Frame caption="Difyでのアプリの調整">
  <img src="https://mintlify.s3.us-west-1.amazonaws.com/dify-4171f9f9/ja-jp/img/debug-app-in-dify.png" alt="Dify アプリデバッグ画面" />
</Frame>

<Frame caption="Langfuseでアプリデータを見る">
  <img src="https://mintlify.s3.us-west-1.amazonaws.com/dify-4171f9f9/ja-jp/img/view-traces-in-langfuse.png" alt="Langfuse アプリデータ監視画面 1" />
</Frame>

<Frame caption="Langfuseでアプリデータを見る">
  <img src="https://mintcdn.com/dify-4171f9f9/hIywJrDH61w15c5F/images/image-26.png?fit=max&auto=format&n=hIywJrDH61w15c5F&q=85&s=4ce90df96056ba6117863423546b25c2" alt="Langfuse アプリデータ監視画面 2" width="3838" height="1915" data-path="images/image-26.png" />
</Frame>

### 監視データのリスト

#### ワークフローとチャットフローの情報をトレースする

**ワークフローとチャットフローをトレースする**

| Workflow                                 | LangFuse Trace          |
| ---------------------------------------- | ----------------------- |
| workflow\_app\_log\_id/workflow\_run\_id | id                      |
| user\_session\_id                        | user\_id                |
| workflow\_{id}                           | name                    |
| start\_time                              | start\_time             |
| end\_time                                | end\_time               |
| inputs                                   | input                   |
| outputs                                  | output                  |
| Model token consumption                  | usage                   |
| metadata                                 | metadata                |
| error                                    | level                   |
| error                                    | status\_message         |
| \[workflow]                              | tags                    |
| \["message", conversation\_mode]         | session\_id             |
| conversion\_id                           | parent\_observation\_id |

**Workflow Trace Info**

* workflow\_id - ワークフローのユニーク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 - ワークフローノードのランタイム情報
* Metadata
  * workflow\_id - ワークフローのユニークID
  * conversation\_id - 会話ID
  * workflow\_run\_id - このランタイムのワークフローID
  * tenant\_id - テナントID
  * elapsed\_time - このランタイムの経過時間
  * status - 運用状態
  * version - ワークフローのバージョン
  * total\_tokens - このランタイムで使用されたトークンの合計
  * file\_list - 処理されたファイルのリスト
  * triggered\_from - このランタイムをトリガーしたソース

#### Message Trace 情報

**LLMの会話内容をトレースする**

| Message                          | LangFuse Generation/Trace |
| -------------------------------- | ------------------------- |
| message\_id                      | id                        |
| user\_session\_id                | user\_id                  |
| message\_{id}                    | name                      |
| start\_time                      | start\_time               |
| end\_time                        | end\_time                 |
| inputs                           | input                     |
| outputs                          | output                    |
| Model token consumption          | usage                     |
| metadata                         | metadata                  |
| error                            | level                     |
| error                            | status\_message           |
| \["message", conversation\_mode] | tags                      |
| conversation\_id                 | session\_id               |
| conversion\_id                   | parent\_observation\_id   |

**Message Trace Info**

* 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 - 会話モード
* Metadata
  * 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

#### Moderation Trace 情報

**会話モデレーションをトレースする**

| Moderation    | LangFuse Generation/Trace |
| ------------- | ------------------------- |
| user\_id      | user\_id                  |
| moderation    | name                      |
| start\_time   | start\_time               |
| end\_time     | end\_time                 |
| inputs        | input                     |
| outputs       | output                    |
| metadata      | metadata                  |
| \[moderation] | tags                      |
| message\_id   | parent\_observation\_id   |

**Message Trace Info**

* message\_id - メッセージID
* user\_id - ユーザーID
* workflow\_app\_log\_id - ワークフローアプリケーションログID
* inputs - レビュー用の入力データ
* message\_data - メッセージデータ
* flagged - 注目対象としてフラグが立てられているか
* action - 実行すべき具体的なアクション
* preset\_response - 事前設定の応答
* start\_time - レビューの開始時刻
* end\_time - レビューの終了時刻
* Metadata
  * message\_id - メッセージID
  * action - 実行すべき具体的なアクション
  * preset\_response - 事前設定の応答

#### 提案された質問トレース情報

**提案された質問をトレースする**

| Suggested Question     | LangFuse Generation/Trace |
| ---------------------- | ------------------------- |
| user\_id               | user\_id                  |
| suggested\_question    | name                      |
| start\_time            | start\_time               |
| end\_time              | end\_time                 |
| inputs                 | input                     |
| outputs                | output                    |
| metadata               | metadata                  |
| \[suggested\_question] | tags                      |
| message\_id            | parent\_observation\_id   |

**Message Trace Info**

* 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 - ステータスメッセージ
* Metadata
  * message\_id - メッセージのID
  * ls\_provider - モデルのプロバイダー
  * ls\_model\_name - モデルの名前
  * status - メッセージの状態
  * from\_end\_user\_id - 送信元ユーザーのID
  * from\_account\_id - 送信元アカウントのID
  * workflow\_run\_id - このランタイムにおけるワークフローのID
  * from\_source - メッセージの発信元

#### Dataset Retrieval Trace 情報

**ナレッジベースの取得をトレースする**

| データセットの取得             | LangFuse生成/トレース         |
| --------------------- | ----------------------- |
| user\_id              | user\_id                |
| dataset\_retrieval    | name                    |
| start\_time           | start\_time             |
| end\_time             | end\_time               |
| inputs                | input                   |
| outputs               | output                  |
| metadata              | metadata                |
| \[dataset\_retrieval] | tags                    |
| message\_id           | parent\_observation\_id |

**Dataset Retrieval Trace Info**

* message\_id - メッセージのID
* inputs - 入力メッセージ
* documents - ドキュメントデータ
* start\_time - 開始時間
* end\_time - 終了時間
* message\_data - 消息数据
* Metadata
  * message\_id - メッセージのID
  * ls\_provider - モデルのプロバイダー
  * ls\_model\_name - モデルの名前
  * status - モデルの状態
  * from\_end\_user\_id - 送信元ユーザーのID
  * from\_account\_id - 送信元アカウントのID
  * agent\_based - エージェントベースであるかどうか
  * workflow\_run\_id - このランタイムにおけるワークフローのID
  * from\_source - メッセージの発信元

#### Tool Trace 情報

**ツールの呼び出しをトレースする**

| ツール                   | LangFuse生成/トレース         |
| --------------------- | ----------------------- |
| user\_id              | user\_id                |
| tool\_name            | name                    |
| start\_time           | start\_time             |
| end\_time             | end\_time               |
| inputs                | input                   |
| outputs               | output                  |
| metadata              | metadata                |
| \["tool", tool\_name] | tags                    |
| message\_id           | parent\_observation\_id |

**Tool Trace Info**

* message\_id - メッセージのID
* tool\_name - ツール名
* start\_time - 開始時間
* end\_time - 終了時間
* tool\_inputs - ツールの入力
* tool\_outputs - ツールの出力
* error - エラーメッセージ（存在する場合）
* inputs - メッセージの入力
* outputs - メッセージの出力
* tool\_config - ツールの構成
* tool\_parameters - ツールのパラメータ
* file\_url - 関連ファイルのURL
* Metadata
  * message\_id - メッセージのID
  * tool\_name - ツール名
  * tool\_inputs - ツールの入力
  * tool\_outputs - ツールの出力
  * tool\_config - ツールの構成
  * error - エラーメッセージ
  * tool\_parameters - ツールのパラメータ
  * message\_file\_id - メッセージファイルのID
  * created\_by\_role - 作成者の役割
  * created\_user\_id - 作成ユーザーのID

#### Generate Name Trace 情報

**会話のタイトル生成をトレースする**

| Generate Name     | LangFuse Generation/Trace |
| ----------------- | ------------------------- |
| user\_id          | user\_id                  |
| generate\_name    | name                      |
| start\_time       | start\_time               |
| end\_time         | end\_time                 |
| inputs            | input                     |
| outputs           | output                    |
| metadata          | metadata                  |
| \[generate\_name] | tags                      |

**Generate Name Trace Info**

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