本文档由 AI 自动翻译。如有任何不准确之处,请参考 英文原版。
在任意应用的 日志 页面中,可看到应用的真实使用情况:用户提交了什么、应用如何响应、收到了哪些反馈。
聊天类应用(聊天助手、Chatflow、Agent)和文本生成应用记录对话;Workflow 应用记录运行。
记录内容
日志涵盖所有渠道的真实使用:Web 应用、API,以及从 主页 的 WEB APPS 列表打开的应用。Workflow 应用中由 触发器 启动的运行也会被记录。
终端用户的反馈(点赞/点踩和评论)与对应消息一同保存。
Chatflow 和 Workflow 应用在编辑器中的测试(预览 和 测试运行)不会出现在日志中;其他应用类型的测试对话会被记录,显示为对应团队成员的账户。
浏览日志
每一行是一次对话或一次运行。多数列一目了然,少数几列需要说明:
- 标题:由对话的第一条消息自动生成。
- 用户或账户:Web 应用和 API 的使用显示会话 ID,Dify 内的使用显示团队成员账户。
- 用户反馈 统计终端用户的点赞/点踩,管理员反馈 统计团队成员的点赞/点踩,均按整个对话汇总。
- 触发方式(Workflow 应用):显示每次运行的来源:
- 网页应用:已发布的 Web 应用,或通过 API 调用
- Webhook:Webhook 触发器收到请求
- 定时任务:定时触发器到达设定时间
- 集成:已连接集成发来的事件
要查找某次对话,可搜索消息中的文字或终端用户的会话 ID。要查找某次工作流运行,可搜索运行的输入或输出,或直接粘贴运行 ID。
查看对话
点击某一行可打开完整的消息记录。将鼠标悬停在回答上,你可以:
- 查看该条消息的 token 消耗与耗时。
- 打开背后的日志:原始提示词、Agent 应用的工具调用过程,或 Chatflow 消息的逐节点追踪。
- 评价回答,作为团队反馈;点踩时可附评论说明问题。团队评价计入 管理员反馈 列,与终端用户反馈分开统计。
- 添加标注,为该问题配上改进后的回复。标注如何生效,详见 标注系统。
要把某条日志分享给同事,复制浏览器地址栏中的链接即可。
查看运行
对于 Workflow 应用,点击某次运行可查看其结果、带状态和 token 总量的输入输出,以及逐节点的执行追踪,便于定位运行失败或变慢的环节。
要复现问题,点击 按此参数测试:工作流会在编辑器中以该次运行的输入重新运行。
日志保留
日志包含完整的用户对话,可能涉及敏感信息。确保你的应用符合当地数据隐私法规:发布隐私政策,并在需要时获得用户同意。
日志默认无限期保留。如需定时清理旧日志:
- 工作流运行日志:将
WORKFLOW_LOG_CLEANUP_ENABLED 设为 true,并将 WORKFLOW_LOG_RETENTION_DAYS 设为要保留的天数(默认 30)。完整变量列表详见 工作流日志清理。
- 对话消息:将
ENABLE_CLEAN_MESSAGES 设为 true,并将 SANDBOX_EXPIRED_RECORDS_RETENTION_DAYS 设为要保留的天数(默认 30)。
清理由每日定时任务执行,设置变量后不会立即删除数据。处理敏感数据的应用建议设置更短的保留窗口。