扣子工作流日志查看与性能监控指南

监控Coze工作流运行状态，需要掌握四条关键路径：通过「分析」面板追踪实时指标；配置Webhook拉取完整原始日志；在模型管理页面审查模型层性能；利用会话右上角的「查看执行详情」对单次执行进行逐节点调试。

许多人打开后台发现找不到统一的日志入口或性能图表，误以为是配置不全。实际上，Coze有意将日志查看与性能监控分散到不同模块，部分功能需要手动启用才能生效。

通过「分析」面板查看实时运行指标

作为最直观的入口，分析面板可快速评估工作流整体健康状态，零配置即可使用。

1. 登录Coze控制台（https://www.coze.cn），进入目标Bot或工作流管理页。

2. 在左侧导航栏点击「分析」选项卡。

3. 选择时间范围：支持近7天、近30天或自定义日期区间。需注意，自定义区间最多回溯90天，超出范围的数据会被自动截断。

4. 查看顶部汇总卡片中的四项核心指标：总调用量、独立用户数、平均响应时长、错误率。这些数据每5分钟刷新一次，延迟不超过2分钟，时效性可靠。

5. 再往下看，折线图区域展示每小时或每日的调用量趋势与会话分布热力。鼠标悬停可查看单点精确数值。

启用Webhook获取全量原始日志

当需要定位失败会话的输入参数、错误堆栈，或将日志导入企业BI系统长期存档时，Webhook是必经之路。

方法一：配置Webhook接收端。进入智能体设置页 → 点击「开发者设置」→「Webhook」→ 开启开关 → 填写已部署的接收端URL（需支持POST并返回200状态码）。

方法二：勾选关键事件类型。在Webhook事件类型中，务必勾选「会话开始」「消息发送」「执行完成」「执行失败」四项。若漏勾「执行失败」，5xx错误的完整上下文将无法捕获，排查时缺失关键线索。

方法三：解析并落库。接收服务端需解析JSON payload，提取event_type、bot_id、user_id、timestamp、status、duration_ms、error_message等字段，写入MySQL或ClickHouse。需留意duration_ms是端到端耗时，精度达1ms。

查看模型级性能监控数据

大模型节点往往是耗时瓶颈，直接影响用户体验。Coze为每个模型提供细粒度性能视图。

登录Coze开发平台 → 选择目标工作空间 → 进入空间配置 → 点击模型管理 → 选择目标模型 → 查看性能监控。

此处可查看三个核心指标：首Token延时（用户输入到第一个字输出的时间）、非首Token延时（后续字符平均生成速度）、成功率（调用成功次数的占比）。所有指标按10分钟窗口统计，同时支持查看P60、P95、P99分位数，以便更全面评估模型表现。

有一点需提前说明：该模型必须在当前工作空间中被至少一个工作流实际调用过，否则性能监控页为空。此外，MinMax、Kimi模型的数据来自全平台用户，而豆包模型仅统计本工作空间成员的使用数据——若跨空间查看结果不一致，并非系统故障，而是正常的统计逻辑差异。

调试单次工作流执行详情

当某次用户交互异常，需要逐节点定位问题源头时，使用此工具而非仅看统计数字。

进入Bot对话界面 → 找到对应的会话 → 点击右上角的「…」→ 选择「查看执行详情」。

页面展开后显示完整的执行链路：每个节点的状态（运行中/成功/失败）、输入数据（可点击展开查看）、输出数据（含结构化JSON或纯文本）、耗时（精确到毫秒）、错误信息（若失败）。

失败节点会高亮为红色，并附带错误码（如LLM_TIMEOUT、PARSE_ERROR、VAR_NOT_FOUND）。点击错误码可直接跳转到官方错误说明页，省去手动搜索的麻烦。

此入口藏在会话右上角的省略号中，许多用户不知道这一键即可进入调试视图。