本文档由 AI 自动翻译。如有任何不准确之处，请参考 英文原版。
Phoenix 简介
Arize Phoenix 是 Arize AI 推出的开源平台，基于 OpenTelemetry 构建，为 LLM 工作流和 Agent 提供可观测性、评估、提示工程和实验能力。 可使用 Arize 托管的 Phoenix Cloud，也可在自有基础设施上自部署 Phoenix（单个容器即可运行）。Dify 从服务端发送追踪数据，因此自部署的端点需要能从公网访问。 如需面向生产环境团队、AI 原生公司和企业的全功能平台，可改用 Arize 集成 接入 Arize AX。 追踪数据接入后，可参考 Arize 的 Agent 评估指南 和 LLM 评估指南，了解如何用追踪数据调试故障、评估 Agent 行为、监控模型质量。配置 Phoenix
本章节将指引你注册 Phoenix 并将其集成至 Dify 平台内。1. 注册/登录 Phoenix
2. 获取 Phoenix API 密钥
从右上角的用户菜单中获取 Phoenix API 密钥。点击 API Key，然后点击 API Key 进行复制：
3. 集成 Phoenix 与 Dify
在 Dify 应用中配置 Phoenix。打开需要监控的应用，在侧边菜单中打开 监控，并在页面上选择 追踪应用性能。
配置 Phoenix Cloud
本章节将指引你注册 Phoenix Cloud 并将其集成至 Dify 平台内。1. 注册/登录 Phoenix Cloud
2. 创建你的 Phoenix 空间
你可以在右上角的用户菜单中创建 Phoenix 空间。点击 创建空间，然后为你的空间提供一个唯一的 URL 标识符：
3. 创建你的 Phoenix API 密钥
启动空间后，你可以在左下角的用户菜单中点击 设置 来创建 Phoenix API 密钥。点击 系统密钥，然后为你的 API 密钥命名：
4. 集成 Phoenix Cloud 与 Dify
在 Dify 应用中配置 Phoenix。打开需要监控的应用，在侧边菜单中打开 监控，并在页面上选择 追踪应用性能。监控数据列表
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 - 消息数据
- 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 - 消息来源
审核追踪信息
用于追踪对话审核
审核追踪信息
- 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