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

# Phoenix の統合

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

### 1 Phoenix とは

[Arize Phoenix](https://arize.com/phoenix/) は、[Arize AI](https://arize.com/?utm_source=dify-docs&utm_medium=partner&utm_campaign=partner-docs&utm_content=integrate-phoenix) が提供するオープンソースのプラットフォームです。OpenTelemetry をベースに、LLM ワークフローとエージェントの可観測性、評価、プロンプトエンジニアリング、実験に対応します。

Arize がホストする [Phoenix Cloud](#3-phoenix-cloud-の使い方) を利用するか、自社インフラに Phoenix をセルフホストします（単一コンテナで起動できます）。トレースは Dify のサーバーから送信されるため、セルフホストの場合はエンドポイントがインターネットから到達できる必要があります。

本番運用チームや AI ネイティブ企業、エンタープライズにはフル機能の [Arize AX](https://arize.com/products/ax/) が適しています。必要な場合は、代わりに [Arize 統合](/ja/cloud/use-dify/monitor/integrations/integrate-arize) を設定してください。

トレースの送信が始まったら、Arize の [エージェント評価ガイド](https://arize.com/guides/ai-agent-handbook/agent-evaluation/) と [LLM 評価ガイド](https://arize.com/resources/llm-evaluation/) を参照してください。障害のデバッグ、エージェント動作の評価、モデル品質のモニタリングにトレースを活用する方法を確認できます。

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

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