> ## 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.

# Phoenix の統合

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

### 1 Phoenix とは

オープンソースおよび OpenTelemetry ベースの可観測性、評価、プロンプトエンジニアリング、実験プラットフォームで、LLM ワークフローおよびエージェントに対応します。

<Info>
  Phoenix の公式サイト：[https://phoenix.arize.com](https://phoenix.arize.com)
</Info>

### 2 Phoenix の使い方

#### 1. Phoenix の[公式サイト](https://app.arize.com/auth/phoenix/signup)から登録し、ログインする。

### 2. Phoenix API キーの取得

右上のユーザーメニューから **API Key** を選択し、API キーを取得・コピーしてください。

<Frame>
  ![Phoenix API キー](https://i.ibb.co/pB1W0pk8/dify-docs-phoenix-api-key.png)
</Frame>

### 3. Phoenix と Dify を統合

Dify アプリケーションで Phoenix を設定します。監視するアプリケーションを開き、サイドメニューで **監視** を選択し、ページ上の **アプリケーションパフォーマンスを追跡** をクリックします。

<Frame>
  ![アプリケーションパフォーマンスを追跡](https://i.ibb.co/gMmXxfhQ/dify-docs-phoenix-in-use.png)
</Frame>

設定後、Phoenix で作成した **API Key** と **プロジェクト名** を設定ページに貼り付けて保存します。

<Frame>
  ![Phoenix の設定](https://i.ibb.co/jv6QFbp7/dify-docs-phoenix-config.png)
</Frame>

保存に成功すると、現在のページで監視ステータスを確認できます。

<Frame>
  ![Phoenix の設定](https://i.ibb.co/HTJsj9x2/dify-docs-phoenix-in-service.png)
</Frame>

### 3 Phoenix Cloud の使い方

#### 1. Phoenix Cloud の[公式サイト](https://app.arize.com/auth/phoenix/signup)から登録し、ログインする。

### 2. Phoenix スペースの作成

右上のユーザーメニューから Phoenix スペースを作成できます。スペースを作成 をクリックし、スペース用の一意の URL 識別子を入力してください。

<Frame>
  ![Phoenix Cloud で Space を作成](https://i.ibb.co/7JYPzZBf/dify-docs-phoenix-cloud-create-space.png)
</Frame>

保存に成功すると、概要ページでスペースのステータスを確認できます。

<Frame>
  ![Phoenix Cloud Space の概要](https://i.ibb.co/Z6RqMhhq/dify-docs-phoenix-cloud-space-overview.png)
</Frame>

### 3. Phoenix API キーの作成

スペースを起動した後、左下のユーザーメニューから 設定 を開き、Phoenix API キーを作成できます。システムキー をクリックし、API キーの名前を入力してください。

<Frame>
  ![Phoenix Cloud API キー](https://i.ibb.co/SXMyX9K3/dify-docs-phoenix-cloud-api-key.png)
</Frame>

### 4. Phoenix Cloud と Dify を統合

Dify アプリケーションで Phoenix を設定します。監視するアプリケーションを開き、サイドメニューで **監視** を選択し、ページ上の **アプリケーションパフォーマンスを追跡** をクリックします。

<Frame>
  ![アプリケーションパフォーマンスを追跡](https://i.ibb.co/gMmXxfhQ/dify-docs-phoenix-in-use.png)
</Frame>

設定画面で、Phoenix Cloud で作成した API キー、プロジェクト名、および スペースのホスト名 を入力して保存してください。

<Frame>
  ![Phoenix の設定](https://i.ibb.co/jv6QFbp7/dify-docs-phoenix-config.png)
</Frame>

保存に成功すると、現在のページで監視ステータスを確認できます。

<Frame>
  ![Phoenix の設定](https://i.ibb.co/HTJsj9x2/dify-docs-phoenix-in-service.png)
</Frame>

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

### **ワークフロー/会話フロートラッキング情報**

**ワークフローと会話フローの追跡に使用**

<table>
  <thead>
    <tr>
      <th>ワークフロー</th>
      <th>Phoenix トラッキング</th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td>workflow\_app\_log\_id/workflow\_run\_id</td>
      <td>id</td>
    </tr>

    <tr>
      <td>user\_session\_id</td>
      <td>- メタデータに配置</td>
    </tr>

    <tr>
      <td>
        {"workflow_{id}"}
      </td>

      <td>name</td>
    </tr>

    <tr>
      <td>start\_time</td>
      <td>start\_time</td>
    </tr>

    <tr>
      <td>end\_time</td>
      <td>end\_time</td>
    </tr>

    <tr>
      <td>inputs</td>
      <td>inputs</td>
    </tr>

    <tr>
      <td>outputs</td>
      <td>outputs</td>
    </tr>

    <tr>
      <td>モデルトークン消費</td>
      <td>usage\_metadata</td>
    </tr>

    <tr>
      <td>metadata</td>
      <td>metadata</td>
    </tr>

    <tr>
      <td>error</td>
      <td>error</td>
    </tr>

    <tr>
      <td>\[workflow]</td>
      <td>tags</td>
    </tr>

    <tr>
      <td>"conversation\_id/none for workflow"</td>
      <td>conversation\_id in metadata</td>
    </tr>
  </tbody>
</table>

**ワークフロートラッキング情報**

* 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 関連の会話を追跡するために使用**

<table>
  <thead>
    <tr>
      <th>チャット</th>
      <th>Phoenix LLM</th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td>message\_id</td>
      <td>id</td>
    </tr>

    <tr>
      <td>user\_session\_id</td>
      <td>- メタデータに配置</td>
    </tr>

    <tr>
      <td>"llm"</td>
      <td>name</td>
    </tr>

    <tr>
      <td>start\_time</td>
      <td>start\_time</td>
    </tr>

    <tr>
      <td>end\_time</td>
      <td>end\_time</td>
    </tr>

    <tr>
      <td>inputs</td>
      <td>inputs</td>
    </tr>

    <tr>
      <td>outputs</td>
      <td>outputs</td>
    </tr>

    <tr>
      <td>モデルトークン消費</td>
      <td>usage\_metadata</td>
    </tr>

    <tr>
      <td>metadata</td>
      <td>metadata</td>
    </tr>

    <tr>
      <td>\["message", conversation\_mode]</td>
      <td>tags</td>
    </tr>

    <tr>
      <td>conversation\_id</td>
      <td>conversation\_id in metadata</td>
    </tr>
  </tbody>
</table>

**メッセージトラッキング情報**

* 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 - メッセージソース

### **レビュー追跡情報**

**会話のレビューを追跡するために使用**

<table>
  <thead>
    <tr>
      <th>レビュー</th>
      <th>Phoenix Tool</th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td>user\_id</td>
      <td>- メタデータに配置</td>
    </tr>

    <tr>
      <td>"moderation"</td>
      <td>name</td>
    </tr>

    <tr>
      <td>start\_time</td>
      <td>start\_time</td>
    </tr>

    <tr>
      <td>end\_time</td>
      <td>end\_time</td>
    </tr>

    <tr>
      <td>inputs</td>
      <td>inputs</td>
    </tr>

    <tr>
      <td>outputs</td>
      <td>outputs</td>
    </tr>

    <tr>
      <td>metadata</td>
      <td>metadata</td>
    </tr>

    <tr>
      <td>\["moderation"]</td>
      <td>tags</td>
    </tr>
  </tbody>
</table>

**レビュー追跡情報**

* 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 - プリセットレスポンス

***

### **提案質問追跡情報**

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

<table>
  <thead>
    <tr>
      <th>提案質問</th>
      <th>Phoenix LLM</th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td>user\_id</td>
      <td>- メタデータに配置</td>
    </tr>

    <tr>
      <td>"suggested\_question"</td>
      <td>name</td>
    </tr>

    <tr>
      <td>start\_time</td>
      <td>start\_time</td>
    </tr>

    <tr>
      <td>end\_time</td>
      <td>end\_time</td>
    </tr>

    <tr>
      <td>inputs</td>
      <td>inputs</td>
    </tr>

    <tr>
      <td>outputs</td>
      <td>outputs</td>
    </tr>

    <tr>
      <td>metadata</td>
      <td>metadata</td>
    </tr>

    <tr>
      <td>\["suggested\_question"]</td>
      <td>tags</td>
    </tr>
  </tbody>
</table>

**提案質問追跡情報**

* 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 - メッセージの送信元

***

### **データセット検索追跡情報**

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

<table>
  <thead>
    <tr>
      <th>データセット検索</th>
      <th>Phoenix Retriever</th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td>user\_id</td>
      <td>- メタデータに配置</td>
    </tr>

    <tr>
      <td>"dataset\_retrieval"</td>
      <td>name</td>
    </tr>

    <tr>
      <td>start\_time</td>
      <td>start\_time</td>
    </tr>

    <tr>
      <td>end\_time</td>
      <td>end\_time</td>
    </tr>

    <tr>
      <td>inputs</td>
      <td>inputs</td>
    </tr>

    <tr>
      <td>outputs</td>
      <td>outputs</td>
    </tr>

    <tr>
      <td>metadata</td>
      <td>metadata</td>
    </tr>

    <tr>
      <td>\["dataset\_retrieval"]</td>
      <td>tags</td>
    </tr>

    <tr>
      <td>message\_id</td>
      <td>parent\_run\_id</td>
    </tr>
  </tbody>
</table>

**データセット検索追跡情報**

* 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 - メッセージの送信元

***

### **ツール追跡情報**

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

<table>
  <thead>
    <tr>
      <th>ツール</th>
      <th>Phoenix Tool</th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td>user\_id</td>
      <td>- メタデータに配置</td>
    </tr>

    <tr>
      <td>tool\_name</td>
      <td>name</td>
    </tr>

    <tr>
      <td>start\_time</td>
      <td>start\_time</td>
    </tr>

    <tr>
      <td>end\_time</td>
      <td>end\_time</td>
    </tr>

    <tr>
      <td>inputs</td>
      <td>inputs</td>
    </tr>

    <tr>
      <td>outputs</td>
      <td>outputs</td>
    </tr>

    <tr>
      <td>metadata</td>
      <td>metadata</td>
    </tr>

    <tr>
      <td>\["tool", tool\_name]</td>
      <td>tags</td>
    </tr>
  </tbody>
</table>

**ツール追跡情報**

* 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