Skip to main content

Phoenix 简介

开源且基于 OpenTelemetry 的可观测性、评估、提示工程和实验平台,适用于你的 LLM 工作流程和代理。
Phoenix 官网介绍

配置 Phoenix

本章节将指引你注册 Phoenix 并将其集成至 Dify 平台内。

1. 注册/登录 Phoenix

2. 获取 Phoenix API 密钥

从右上角的用户菜单中获取 Phoenix API 密钥。点击 API Key,然后点击 API Key 进行复制:

3. 集成 Phoenix 与 Dify

在 Dify 应用中配置 Phoenix。打开需要监控的应用,在侧边菜单中打开 监控,并在页面上选择 追踪应用性能
点击配置后,将在 Phoenix 中创建的 API Key项目名称粘贴到配置中并保存。
成功保存后,你可以在当前页面查看监控状态。

配置 Phoenix Cloud

Phoenix Cloud 追踪 Dify Enterprise 3.4.1 起可用。自托管 Phoenix 在所有 3.4.x 版本可用。
本章节将指引你注册 Phoenix Cloud 并将其集成至 Dify 平台内。

1. 注册/登录 Phoenix Cloud

2. 创建你的 Phoenix 空间

你可以在右上角的用户菜单中创建 Phoenix 空间。点击 创建空间,然后为你的空间提供一个唯一的 URL 标识符:
保存成功后,你可以在概览页面查看空间的状态。

3. 创建你的 Phoenix API 密钥

启动空间后,你可以在左下角的用户菜单中点击 设置 来创建 Phoenix API 密钥。点击 系统密钥,然后为你的 API 密钥命名:

4. 集成 Phoenix Cloud 与 Dify

在 Dify 应用中配置 Phoenix。打开需要监控的应用,在侧边菜单中打开 监控,并在页面上选择 追踪应用性能
点击配置后,粘贴从 Phoenix Cloud 中获取的 API 密钥、项目名称 和 空间主机名 到配置项中并保存。
成功保存后,你可以在当前页面查看监控状态。

监控数据列表

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